Paikallinen asennus

Avaa ChatGPT:ssä

Tässä asiakirjan osassa käsitellään vain niitä vaiheita, joita käyttäjät, jotka haluavat käyttää webforJ:ta verkkosivujen ja/tai sovellusten kehittämiseen paikallisen BBj-instanssin kanssa omalla koneellaan, tarvitsevat. Tämä asennus ei salli käyttäjien myötävaikuttaa webforJ-säätiön koodiin itseensä.

tiedot

Tämä opas kattaa asennuksen Windows-järjestelmälle - asennusvaiheet voivat vaihdella Mac/Linux-käyttöjärjestelmissä.

Asennus jaetaan seuraaviin vaiheisiin:

1. BBj:n lataaminen ja asentaminen
2. BBj Plugin Managerin käyttäminen sovelluksesi luomiseen
3. Sovelluksesi käynnistäminen

Esivaatimukset

Ennen kuin aloitat, varmista, että olet tarkastellut tarvittavat esivaatimukset webforJ:n asentamiseen ja käyttöön. Tämä varmistaa, että sinulla on kaikki vaadittavat työkalut ja konfiguraatiot kunnossa ennen projektisi aloittamista.

1. BBj:n lataaminen ja asentaminen

Seuratessasi tätä vaihetta varmista, että asennat BBj-version, joka vastaa samaa webforJ-versiota.

Tämä video voi auttaa BBj:n asennuksessa, jos tarvitset apua asetusten kanssa. Asennusosioon BASISin verkkosivustolla pääsee tämän linkin kautta.

vihje

Suositellaan käyttämään uusinta vakaata BBj:n rakennetta, ja valitsemaan "BBj" vaihtoehdoista, ilman Baristaa tai Addonia.

2. webforJ-liitännäisen asentaminen ja konfigurointi

Kun BBj on asennettu, voit käyttää Plugin Manageria asentaaksesi työkalut, jotka ovat tarpeen webforJ:n konfigurointiin. Aloita kirjoittamalla "Plugin Manager" käynnistysvalikkoon tai Finderiin.

Kun plugin manager on avattu, siirry ylhäällä olevaan "Available Plugins" -välilehteen.

Tässä osiossa valitse "Show versions under development" -valintaruutu

DWCJ-kohteen pitäisi nyt näkyä saatavilla olevien ladattavien liitännäisten luettelossa. Napsauta tätä kohdetta valitaksesi sen.

Valittuasi DWCJ-kohteen, napsauta "Install"-painiketta

Kun liitännäinen on asennettu, napsauta ylhäällä olevaa "Installed Plugins" -välilehteä.

Tämä välilehti näyttää asennetut liitännäiset, joiden pitäisi nyt sisältää DWCJ-kohde. Napsauta luettelossa olevaa kohdetta.

Valittuasi DWCJ-kohteen, napsauta "Configure"-painiketta

Aukeavassa ikkunassa napsauta ikkunan vasemmassa alalaidassa olevaa "Enable Maven Remote Install" -painiketta.

vihje

Vaihtoehtoisesti voit navigoida bin-hakemistoon bbx-kansiossasi ja suorittaa seuraavan komennon:

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

Dialogi ilmoittaa, että etäasennus on otettu käyttöön. Napsauta "OK" sulkeaksesi tämän dialogin.

3. Alustavan projektin käyttäminen

Kun BBj ja tarvittava webforJ-liitännäinen on asennettu ja konfiguroitu, voit luoda uuden, valmisprojektin komentoriviltä. Tämä projekti sisältää tarvittavat työkalut ensimmäisen webforJ-ohjelmasi ajamiseen.

Luodaksesi ja rakentaaksesi uuden bbj-hello-world-projektin, seuraa näitä vaiheita:

1. Siirry oikeaan hakemistoon: Avaa terminaali ja siirry kansioon, johon haluat luoda uuden projektisi.
2. Suorita archetype:generate-komento: Käytä alla olevaa Maven-komentoa ja mukauta groupId, artifactId ja version projektisi tarpeiden mukaan.

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"

Argumentti	Selitys
archetypeGroupId	Arkityypin ryhmätunnus: com.webforJ
archetypeArtifactId	Määrittää käytettävän arkkityypin nimen.
archetypeVersion	Määritä arkkityypin versio. LATEST valitsee uusimman version.
groupId	Edustaa luodun projektin nimiavaruutta. Tyypillisesti rakennettu Java-paketin tapaan, kuten org.example, ja sitä käytetään organisaatiosi tai projektialueesi yksilölliseen tunnistamiseen.
artifactId	Määrittää luodun projektin nimen. Tästä tulee tuloksena olevan artefaktin ja projektikansion nimi.
version	Määritä versionumero (MAJOR.MIINOR-SNAPSHOT, esim. 1.0-SNAPSHOT).
appName	Valinnainen parametri, jota voidaan käyttää luodun projektin POM-tiedostossa. Käytetyn webforJ-arkkityypin mukaan sitä voidaan käyttää sovelluksen oletusotsikkona.

Komennon suorittamisen jälkeen Maven luo projektin suorittamiseen tarvittavat projektitiedostot.

4. Sovelluksen käynnistäminen

Kun tämä on tehty, suorita mvn install projektin hakemistossasi. Tämä ajaa webforJ:n asennusliitännäisen ja mahdollistaa pääsyn sovellukseesi. Näet sovelluksen menemällä seuraavaan URL-osoitteeseen:

http://localhost:YourHostPort/webapp/YourPublishName

Korvaa YourHostPort Dockerissa määrittämälläsi isäntäportilla ja YourPublishName korvataan <publishname>-tagin sisällä olevalla tekstillä POM-tiedostossa. Jos kaikki on tehty oikein, näet sovelluksesi renderöitynä.