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.

vinkki

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.

vinkki

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.

Luo ja rakenna uusi bbj-hello-world projekti seuraamalla näitä vaiheita:

1. Siirry oikeaan hakemistoon: Avaa pääte ja siirry kansioon, johon haluat luoda uuden projektin.
2. Suorita komento: archetype:generate: Käytä alla olevaa Maven-komentoa ja mukauta groupId, artifactId ja versio tarpeidesi 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	Archetyypin ryhmätunnus on com.webforj webforJ-archetyypeille.
archetypeArtifactId	Määritä käytettävän arkkityypin nimi.
archetypeVersion	Määritä käytettävän arkkityypin versio. Tämä varmistaa, että luotu projekti on yhteensopiva tietyn arkkityypin version kanssa. LATEST valitsee saatavilla olevan uusimman version.
groupId	Edustaa generoituun projektiin liittyvää nimiavaruutta. Tyypillisesti rakennettu Java-paketin kaltaisesti, kuten org.esimerkki, ja käytetään organisaatiosi tai projektisi alueen ainutlaatuisen tunnistamisen tueksi.
artifactId	Määrittelee luodun projektin nimen. Tämä on lopullisen artefaktin ja projektikansion nimi.
version	Määrittelee luodun projektin version. Yleinen käytäntö on MAJOR.MINOR-SNAPSHOT, kuten 1.0-SNAPSHOT, missä SNAPSHOT viittaa siihen, että projekti on edelleen kehitysvaiheessa.
appName	Valinnainen parametri, jota voidaan käyttää generoituessa projektin POM-tiedostossa. Voidaan käyttää oletustittelinä sovellukselle käytetyn webforJ-archetypen mukaan.

Maven luo komennon suorittamisen jälkeen projektille tarvittavat tiedostot.

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ä.