Lokale Installatie

Open in ChatGPT

Dit gedeelte van de documentatie behandelt de stappen die vereist zijn voor gebruikers die webforJ willen gebruiken voor web- en/of app-ontwikkeling met een lokale BBj-instantie op hun machine. Deze installatie staat gebruikers niet toe bij te dragen aan de webforJ funderingscode zelf.

informatie

Deze handleiding behandelt de installatie op een Windows-systeem - de installatie stappen kunnen variëren voor Mac/Linux besturingssystemen.

De installatie wordt onderverdeeld in de volgende stappen:

1. BBj downloaden en installeren
2. Gebruik van de BBj Plugin Manager om je app te maken
3. Je app starten

Vereisten

Voordat je begint, zorg ervoor dat je de nodige vereisten voor het opzetten en gebruiken van webforJ hebt doorgenomen. Dit zorgt ervoor dat je alle vereiste tools en configuraties hebt voordat je met je project begint.

1. BBj downloaden en installeren

Zorg ervoor dat je tijdens deze stap de BBj-versie installeert die overeenkomt met dezelfde webforJ-versie.

Deze video kan helpen met de installatie van BBj als je hulp nodig hebt bij de installatie. Het installatiegedeelte van de BASIS-website is te vinden op deze link

tip

Het wordt aanbevolen om de nieuwste stabiele revisie van BBj te gebruiken en "BBj" uit de lijst met opties te selecteren, zonder Barista of Addon.

2. Installeer en configureer de webforJ-plugin

Zodra BBj is geïnstalleerd, kan de Plugin Manager worden geopend om de benodigde tools voor het configureren van webforJ te installeren. Typ om te beginnen "Plugin Manager" in het startmenu of de Finder.

Nadat de plugin manager is geopend, navigeer je naar het tabblad "Beschikbare Plugins" bovenaan.

Zorg ervoor dat je het vakje "Toon versies in ontwikkeling" aanvinkt.

De DWCJ-vermelding zou nu zichtbaar moeten zijn in de lijst van beschikbare plugins om te downloaden. Klik op deze vermelding in de lijst om deze te selecteren.

Met de DWCJ-vermelding geselecteerd, klik op de knop "Installeren".

Zodra de plugin is geïnstalleerd, klik je op het tabblad "Geïnstalleerde Plugins" bovenaan.

Dit tabblad toont geïnstalleerde plugins, die nu de DWCJ-vermelding zouden moeten bevatten. Klik op de vermelding in de lijst.

Met de DWCJ-vermelding geselecteerd, klik op de knop "Configureer".

In het venster dat opent, klik je op de knop "Enable Maven Remote Install" linksonder in het venster.

tip

Alternatief, navigeer naar de bin-directory binnen je bbx-map en voer de volgende opdracht uit:

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

Een dialoog moet verschijnen waarin staat dat de externe installatie is ingeschakeld. Klik op "OK" om deze dialoog te sluiten.

3. Gebruik van het starterproject

Zodra BBj en de vereiste webforJ-plugin zijn geïnstalleerd en geconfigureerd, kun je een nieuw, gestructureerd project aanmaken vanuit de opdrachtregel. Dit project wordt geleverd met de noodzakelijke tools om je eerste webforJ-programma uit te voeren.

Om een nieuw bbj-hello-world project te maken en op te zetten, volg deze stappen:

1. Navigeer naar de juiste directory: Open een terminal en ga naar de map waar u uw nieuwe project wilt maken.
2. Voer het archetype:generate commando uit: Gebruik het Maven commando hieronder en pas groupId, artifactId en version aan naar behoefte voor uw project.

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	Uitleg
archetypeGroupId	De groep ID van het archetype is com.webforj voor webforJ archetypes.
archetypeArtifactId	Specificeert de naam van het te gebruiken archetype.
archetypeVersion	Specificeert de versie van het te gebruiken archetype. Dit zorgt ervoor dat het gegenereerde project compatibel is met een specifieke archetype versie. LATEST selecteert de meest recente beschikbare versie.
groupId	Namespace voor het project.
artifactId	Specificeert de naam van het gegenereerde project. Dit wordt de naam van het resulterende artefact en de projectmap.
version	Definieer projectversie: MAJOR.MINOR-SNAPSHOT, bijv. 1.0-SNAPSHOT
appName	Optionele parameter voor het POM-bestand; kan dienen als standaardtitel voor de applicatie, afhankelijk van het gebruikte webforJ-archetype.

Na het uitvoeren van het commando zal Maven de benodigde projectbestanden genereren om het project uit te voeren.

4. De app starten

Zodra dit is gedaan, voer je een mvn install uit in je projectdirectory. Dit zal de webforJ install plugin uitvoeren, en je in staat stellen toegang te krijgen tot je app. Om de app te zien, ga je naar de volgende URL:

http://localhost:YourHostPort/webapp/YourPublishName

Vervang YourHostPort door de hostpoort die je hebt geconfigureerd met Docker, en YourPublishName wordt vervangen door de tekst binnen de <publishname>-tag van de POM. Als het goed is gedaan, zou je je app moeten zien renderen.