Paikallinen asennus

Avaa ChatGPT:ssä

Tämä dokumentaatio-osuus kattaa vaiheet, jotka ovat tarpeen vain käyttäjille, jotka haluavat käyttää webforJ:ta verkkosovellusten ja/tai sovelluskehityksen kanssa paikallisella BBj-instantilla heidän koneessaan. Tämän asennuksen avulla käyttäjät eivät voi osallistua webforJ-säätiön koodin kehittämiseen.

tiedot

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

Asennus jaetaan seuraaviin vaiheisiin:

1. BBj:n lataaminen ja asennus
2. BBj:n lisäosien hallinnan käyttäminen sovelluksesi luomiseen
3. Sovelluksesi käynnistaminen

Esivaatimukset

Ennen aloittamista varmista, että olet tarkistanut tarvittavat esivaatimukset webforJ:n määrittämiseksi ja käyttämiseksi. Tämä varmistaa, että sinulla on kaikki tarvittavat työkalut ja konfiguraatiot paikoillaan ennen projektisi aloittamista.

1. BBj:n lataaminen ja asennus

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. BASIS-verkkosivuston asennusosio löytyy tältä linkiltä

vinkki

Suositellaan, että käytät BBj:n viimeisintä vakaita rakennetta, ja valitset "BBj" vaihtoehtoluettelosta ilman Baristaa tai lisäosia.

2. Asenna ja määritä webforJ-lisäosa

Kun BBj on asennettu, voit käyttää Lisäosien hallintaa asentaaksesi työkalut, joita tarvitaan webforJ:n määrittämiseksi. Aloita kirjoittamalla "Plugin Manager" Käynnistä-valikkoon tai Finderiin.

Kun lisäosien hallinta on avautunut, siirry ylhäällä olevaan "Saatavilla olevat lisäosat" -välilehteen.

Tässä osiossa valitse "Näytä kehitysvaiheessa olevat versiot" -valintaruutu

DWCJ-merkkivalinta pitäisi nyt olla näkyvissä saatavilla olevien lisäosien luettelossa. Klikkaa tätä merkintää valitaksesi sen.

Kun DWCJ-merkkivalinta on valittuna, napsauta "Asenna" -painiketta

Kun lisäosa on asennettu, napsauta "Asennetut lisäosat" -välilehteä ylhäällä.

Tämä välilehti näyttää asennetut lisäosat, jotka pitäisi nyt sisältää DWCJ-merkinnän. Klikkaa luettelossa olevaa merkintää.

Kun DWCJ-merkintä on valittuna, napsauta "Määritä" -painiketta

Avaavassa ikkunassa napsauta "Ota Maven Remote Install käyttöön" -painiketta ikkunan vasemmassa alakulmassa.

vinkki

Vaihtoehtoisesti siirry bin-hakemistoon bbx-kansiossasi ja suorita seuraava komento:

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

Viestiruudun pitäisi näyttää, että etäasennus on otettu käyttöön. Napsauta "OK" sulkeaksesi tämän valintaikkunan.

3. Käyttäen aloitusprojektia

Kun BBj ja tarvittu webforJ-lisäosa on asennettu ja määritetty, voit luoda uuden, alustetun projektin komentoriviltä. Tämä projekti sisältää tarvittavat työkalut ensimmäisen webforJ-ohjelmasi suorittamiseen.

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 projektihakemistossasi. Tämä suorittaa webforJ:n asennuslisäosan ja antaa sinun käyttää sovellustasi. Näet sovelluksen siirtymällä seuraavaan URL-osoitteeseen:

http://localhost:YourHostPort/webapp/YourPublishName

Korvaa YourHostPort Dockerille määrittämälläsi isäntäportilla, ja YourPublishName korvataan POM-tiedoston <publishname>-tagin sisällä olevalla tekstillä. Jos kaikki on tehty oikein, sinun pitäisi nähdä sovelluksesi renderöityvän.