Installation Locale

Ouvrir dans ChatGPT

Obsolète et sera supprimé

Le plugin webforJ du Gestionnaire de Plugins BBj décrit sur cette page est obsolète et sera supprimé dans une future version. Ne commencez pas de nouveaux projets avec. Déplacez les projets existants vers BBjShip, qui installe, déploie et exécute les applications webforJ dans BBjServices. Les projets existants liste les modifications nécessaires à un projet.

Cette section de la documentation couvrira les étapes requises uniquement pour les utilisateurs qui souhaitent utiliser webforJ pour le développement web et/ou d'applications avec une instance locale de BBj sur leur machine. Cette installation ne permettra pas aux utilisateurs de contribuer au code lui-même de la fondation webforJ.

info

Ce guide couvrira l'installation sur un système Windows - les étapes d'installation peuvent varier pour les appareils Mac/Linux.

L'installation sera divisée en étapes suivantes:

1. Téléchargement et installation de BBj
2. Utilisation du Gestionnaire de Plugins BBj pour créer votre application
3. Lancement de votre application

Prérequis

Avant de commencer, assurez-vous d'avoir examiné les prérequis nécessaires pour configurer et utiliser webforJ. Cela garantit que vous disposez de tous les outils et configurations nécessaires avant de démarrer votre projet.

1. Téléchargement et installation de BBj

Lors de cette étape, assurez-vous d'installer la version de BBj qui correspond à la même version de webforJ.

Cette vidéo peut vous aider avec l'installation de BBj si vous avez besoin d'aide pour la configuration. La section d'installation du site web de BASIS peut être trouvée à ce lien

conseil

Il est recommandé d'utiliser la dernière version stable de BBj, et de sélectionner "BBj" dans la liste des options, sans Barista ni Addon.

2. Installer et configurer le plugin webforJ

Une fois que BBj a été installé, le Gestionnaire de Plugins peut être accédé pour installer les outils nécessaires à la configuration de webforJ. Pour commencer, tapez "Gestionnaire de Plugins" dans le menu Démarrer ou le Finder.

Une fois dans cette section, sélectionnez la case à cocher "Afficher les versions en développement"

L'entrée DWCJ devrait maintenant être visible dans la liste des plugins disponibles à télécharger. Cliquez sur cette entrée dans la liste pour la sélectionner.

Avec l'entrée DWCJ sélectionnée, cliquez sur le bouton "Installer"

Une fois que le plugin a terminé l'installation, cliquez sur l'onglet "Plugins installés" en haut.

Cet onglet affiche les plugins installés, qui devraient désormais inclure l'entrée DWCJ. Cliquez sur l'entrée dans la liste.

Avec l'entrée DWCJ sélectionnée, cliquez sur le bouton "Configurer"

Dans la fenêtre qui s'ouvre, cliquez sur le bouton "Activer l'installation distante Maven" en bas à gauche de la fenêtre.

conseil

Alternativement, naviguez vers le répertoire bin dans votre dossier bbx et exécutez la commande suivante :

./bbj -tIO DWCJ/cli.bbj - enable_remote_install

Une boîte de dialogue devrait s'afficher indiquant que l'installation distante a été activée. Cliquez sur "OK" pour fermer cette boîte de dialogue.

3. Utilisation du projet de démarrage

Une fois que BBj et le plugin webforJ requis sont installés et configurés, vous pouvez créer un nouveau projet, scaffolding depuis la ligne de commande. Ce projet est livré avec les outils nécessaires pour exécuter votre premier programme webforJ.

Pour créer et mettre en place un nouveau projet bbj-hello-world, suivez ces étapes :

1. Naviguez vers le répertoire approprié: Ouvrez un terminal et déplacez-vous dans le dossier où vous souhaitez créer votre nouveau projet.
2. Exécuter la commande archetype:generate: Utilisez la commande Maven ci-dessous et personnalisez le groupId, l'artifactId et la version selon les besoins de votre projet.

Bash/Zsh

mvn -B archetype:generate \
-DarchetypeGroupId=com.webforj \
-DarchetypeArtifactId=webforj-archetype-bbj-hello-world \
-DarchetypeVersion=LATEST \
-DgroupId=org.example \
-DartifactId=my-app \
-Dversion=1.0-SNAPSHOT \
-DappName=MyApp

PowerShell

mvn -B archetype:generate `
-DarchetypeGroupId="com.webforj" `
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" `
-DarchetypeVersion="LATEST" `
-DgroupId="org.example" `
-DartifactId="my-app" `
-Dversion="1.0-SNAPSHOT" `
-DappName="MyApp"

Command Prompt

mvn -B archetype:generate ^
-DarchetypeGroupId="com.webforj" ^
-DarchetypeArtifactId="webforj-archetype-bbj-hello-world" ^
-DarchetypeVersion="LATEST" ^
-DgroupId="org.example" ^
-DartifactId="my-app" ^
-Dversion="1.0-SNAPSHOT" ^
-DappName="MyApp"

Argument	Explication
archetypeGroupId	L'ID de groupe de l'archétype est com.webforj pour les archétypes webforJ.
archetypeArtifactId	Spécifie le nom de l'archétype à utiliser.
archetypeVersion	Spécifie la version de l'archétype à utiliser. Cela garantit que le projet généré est compatible avec une version d'archétype spécifique. Utiliser LATEST sélectionne la version la plus récente disponible.
groupId	Représente l'espace de nom du projet généré. Généralement structuré comme un package Java, par exemple org.example, et est utilisé pour identifier de manière unique votre organisation ou domaine de projet.
artifactId	Spécifie le nom du projet généré. Ce sera le nom de l'artifact résultant et du dossier du projet.
version	Définit la version du projet généré. Une convention courante est MAJOR.MINOR-SNAPSHOT, comme 1.0-SNAPSHOT, où SNAPSHOT indique que le projet est encore en développement.
appName	Un paramètre optionnel pouvant être utilisé dans le fichier POM du projet généré. Selon l'archétype webforJ utilisé, il peut servir de titre par défaut pour l'application.

Après l'exécution de la commande, Maven générera les fichiers de projet nécessaires pour exécuter le projet.

4. Lancement de l'application

Une fois cela fait, exécutez un mvn install dans votre répertoire de projet. Cela exécutera le plugin d'installation webforJ et vous permettra d'accéder à votre application. Pour voir l'application, vous devrez vous rendre à l'URL suivante :

http://localhost:YourHostPort/webapp/YourPublishName

Remplacez YourHostPort par le port de l'hôte que vous avez configuré avec Docker, et YourPublishName par le texte à l'intérieur de la balise <publishname> du POM. Si tout est fait correctement, vous devriez voir votre application s'afficher.