Aan de Slag
craftforJ wordt geleverd met webforJ, dus er is niets apart te downloaden. Deze pagina behandelt wat je app nodig heeft voordat craftforJ verschijnt, en hoe je het kunt openen.
Projecten die zijn gemaakt met startforJ of vanuit een webforJ archetype komen met craftforJ ingeschakeld. Als je vanaf een van deze projecten bent begonnen, voer je app uit en sla je door naar Opening craftforJ.
Vereisten
craftforJ voegt zich alleen bij een app als aan al de volgende voorwaarden is voldaan. Als er aan een van deze voorwaarden niet wordt voldaan, verschijnt er niets op de pagina.
Voeg de afhankelijkheid toe
Voeg webforj-devtools toe aan je project als het er nog niet in staat:
<dependency>
<groupId>com.webforj</groupId>
<artifactId>webforj-devtools</artifactId>
<version>${webforj.version}</version>
</dependency>
Debugmodus en de craftforJ-vlag
Voeg de volgende eigenschappen toe aan je project. Als je een standaard webforJ-app hebt, stel je de eigenschappen in webforj.conf in. Voor een webforJ-project dat gebruikmaakt van Spring, stel je de eigenschappen in application.properties in.
webforj.debug = true
webforj.devtools.craftforj.enabled = true
craftforJ functioneert alleen wanneer beide eigenschappen zijn ingeschakeld; daarom stelt een app die in productie gaat met de debugmodus ingeschakeld je bronboom niet bloot.
Een lokale browser en een ontwikkelaarslicentie
Open de app vanaf de machine die deze uitvoert en zorg ervoor dat je een geldige ontwikkelaarslicentie hebt. Om craftforJ vanaf een andere machine te bereiken, voeg je het adres toe aan hosts-allowed.
Zodra deze zaken zijn geregeld, start je de app opnieuw en laad je de pagina.
Opening craftforJ
Wanneer craftforJ actief is, verschijnt er een triggerknop boven je app. Klik erop om craftforJ te openen, of druk op Alt + Shift + D vanuit elke locatie in de app. Dezelfde sneltoets sluit craftforJ weer, en je kunt de trigger naar elke hoek slepen die je wilt.
De tabbladen dekken de componentboom, routes, het thema en de assistent. Instellingen en app-informatie bevinden zich naast hen.
- De trigger is de knop die craftforJ opent en sluit. Hij blijft uit de weg terwijl craftforJ gesloten is.
- De tabstrip loopt langs de rand die dichtst bij de app ligt en schakelt tussen wat craftforJ je laat zien.
- Het venster menu bevat alles over waar craftforJ zich bevindt, behandeld in Waar craftforJ zit.
craftforJ schrijft elke sneltoets met de modifiers van het platform waarop je je bevindt, dus Alt verschijnt als ⌥ en Ctrl als ⌘. Druk op Shift + ? in craftforJ om de huidige lijst te zien.
Waar craftforJ zit
craftforJ zweeft standaard boven je app. Sleep het overal op de pagina, verander de grootte vanuit elke rand, en minimaliseer het terug naar zijn trigger wanneer je de app voor jezelf wilt hebben. Door het naar een rand van de pagina te slepen, wordt het daar vastgezet, volledige hoogte of volledige breedte, en elke rand behoudt de grootte die je het hebt gegeven. Als je het van de rand weg sleept, zweeft het weer.
craftforJ wordt bovenop de pagina getekend. Je app past zijn grootte niet aan, en niets erin verschuift, dus wat ook onder craftforJ zit, is verborgen terwijl het daar is. Om te zien wat eronder zit, verplaats je craftforJ naar een andere rand of haal je het van de pagina af.
Om te stoppen met het bedekken van de app, verplaats je craftforJ naar buiten de pagina en in een eigen browservenster of -tab, wat goed is voor een tweede monitor. Het inspecteert nog steeds je app via de pagina die het heeft geopend, dus laat die pagina open. Navigeer ervan weg of sluit het en craftforJ heeft niets meer om te inspecteren totdat je de app opnieuw opent.
Kies een tabblad in plaats van een venster als je de split view van Chrome gebruikt, die je app en craftforJ naast elkaar plaatst en alleen echte tabbladen accepteert. Klik met de rechtermuisknop op het tabblad van je app, voeg het toe aan een nieuwe split view, en kies vervolgens het craftforJ-tabblad.
Chrome biedt de zij-aan-zij indeling, niet craftforJ. Andere browsers hebben geen gelijkwaardige functie, dus craftforJ in andere browsers opent in een gewone tabblad waarop je overschakelt. craftforJ zelf werkt op dezelfde manier, ongeacht de indeling.
Het verplaatsen van craftforJ naar een ander venster beëindigt een reactie die nog aan het streamen is. craftforJ vraagt eerst, en alles wat tot dat moment is geschreven blijft in de chat.
Een eerste wijziging aanbrengen
- Druk op Alt + Shift + C om een component te selecteren.
- Hover over iets in je app en klik erop.
- De boom selecteert die component, en de zijbalk vult zich met zijn eigenschappen.
- Wijzig een eigenschap. De draaiende app werkt onmiddellijk bij.
De wijziging heeft alleen invloed op de app voor je. Je bestanden blijven onaangeroerd totdat je de wijziging beoordeelt en toepast, wat wordt behandeld in Writing changes to source.
Als er helemaal niets verschijnt, werk dan door Troubleshooting.
