Installer BWEB

BWEB est livré dans le composant BSPK Tools, qui regroupe tous les outils BSPOKE : BWEB, l'ATL, l'exécution de code et de méthodes, l'éditeur d'objets JSON. L'installation se fait en deux temps : 4D charge le composant comme une dépendance de votre projet, puis l'assistant du composant installe BWEB dans votre base.

Avant de commencer

4D 21. Le composant est construit pour 4D 21 : son numéro de version commence par celui de 4D (par exemple 21.6.85).
Un projet 4D, neuf ou existant, ouvert en local et non compilé : l'assistant refuse de s'exécuter dans les autres cas.
Un accès Internet au premier démarrage : 4D télécharge le composant et ses propres dépendances depuis GitHub, puis les garde en cache.
Node.js : BWEB en a besoin pour compiler ses feuilles de style. S'il est absent, l'assistant propose de l'installer.

1. Déclarer le composant

Le composant est publié sur GitHub, dans le dépôt public bspoke-dev/BSPK-Tools, où chaque version est listée. Vous le déclarez comme une dépendance de votre projet, depuis 4D :

Menu Développement > Dépendances du projet.
Cliquez sur le bouton + en bas de la fenêtre, puis choisissez l'onglet GitHub.
Saisissez le chemin du dépôt : bspoke-dev/BSPK-Tools.
Choisissez une version précise (un tag, par exemple 21.6.85) : vous décidez ainsi quand passer à la version suivante. Validez.
La dépendance s'affiche avec le statut Disponible après redémarrage : redémarrez 4D.

Au redémarrage, le composant est téléchargé, et il tire lui-même les composants officiels de 4D dont il a besoin : vous n'avez rien d'autre à déclarer. La fenêtre des dépendances affiche alors BSPK Tools avec sa version, à côté de 4D NetKit, 4D Progress, 4D SVG et 4D Widgets.

La fenêtre ne fait qu'écrire le fichier Project/Sources/dependencies.json du projet. Vous pouvez aussi y déclarer le composant directement :

{
  "dependencies": {
    "BSPK Tools": {
      "github": "bspoke-dev/BSPK-Tools",
      "tag": "21.6.85"
    }
  }
}

Et le dossier Components ? Copier le composant dans le dossier Components du projet, comme pour les anciennes versions, fonctionne toujours. La dépendance est cependant la méthode recommandée : c'est la norme de 4D, et passer à une nouvelle version se fait depuis la fenêtre des dépendances, sans manipuler de dossier.

2. Lancer l'assistant

Exécutez la méthode _BSPK_LAUNCH. Elle ouvre le lanceur du composant, qui donne accès à tous les outils. Cliquez sur BWEB, acceptez la licence, puis cliquez sur Démarrer l'installation.

L'assistant affiche ses étapes et les coche au fur et à mesure. Elles se regroupent ainsi :

Environnement : vérification des prérequis, installation de Node.js et npm si nécessaire, des bibliothèques, et compilation des feuilles de style.
Serveur web : configuration du serveur web de 4D et installation des certificats SSL. L'assistant vous demande vos fichiers cert.pem et key.pem ; vous pouvez continuer sans, pour un essai local.
Fichiers et méthodes : copie du dossier web, des fichiers de configuration et des méthodes BSPH_* dans votre projet ; modification des méthodes base On Startup, Web On Connection et On Exit (et leurs équivalents serveur).
Structure : création des tables BSPK_*, de leurs relations et de leurs index. Votre application redémarre à cette étape : c'est normal, et l'installation reprend d'elle-même.
Premier domaine : l'assistant vous demande le nom de votre premier site, puis propose de l'ajouter au fichier hosts de la machine pour qu'il réponde en local.

Les tables BSPK_* ajoutées à votre structure sont celles de BWEB : ne les supprimez pas et ne les renommez pas.

3. Vérifier

À la fin, cliquez sur Tester BWEB dans le lanceur : votre navigateur ouvre l'administration de votre domaine, à l'adresse https://<votre domaine>/bweb. Si vous avez continué sans certificat, ou avec un certificat auto-signé, le navigateur affiche une alerte de sécurité : vous pouvez poursuivre pour un essai local.

Si la page de connexion s'affiche, BWEB est installé.

Et ensuite

Pour comprendre ce que vous venez d'installer : Le modèle de données.
Pour construire tout de suite : le Quick Start, dans le menu, guide la création d'un blog complet.
Pour l'outil d'édition des pages : Le dev-panel.