Getting Started
craftforJ wordt geleverd met webforJ, dus er hoeft niets apart te worden gedownload. Deze pagina bespreekt 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 worden geleverd met craftforJ ingeschakeld. Als je vanaf daar bent begonnen, voer je app uit en sla je door naar Opening craftforJ.
Vereisten
craftforJ hecht zich aan een app alleen wanneer aan al het volgende is voldaan. Als een van hen niet aan de voorwaarden voldoet, 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>
Debug-modus 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; een app die in productie gaat met de debug-modus aan, geeft je brontree 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, herstart je de app en vernieuw 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 van waar dan ook in de app. dezelfde sneltoets sluit craftforJ weer, en je kunt de trigger naar elke hoek verslepen die je past.
De tabs dekken de componentenboom, routes, het thema en de assistent. Instellingen en app-informatie bevinden zich daarnaast.
- De trigger is de knop die craftforJ opent en sluit. Het blijft uit de weg terwijl craftforJ gesloten is.
- De tabstrip loopt langs de rand die het dichtst bij de app is en schakelt tussen wat craftforJ je laat zien.
- Het venster menu bevat alles over waar craftforJ zich bevindt, behandeld in Where craftforJ sits.
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.
Where craftforJ sits
craftforJ zweeft standaard boven je app. Sleep het naar elke plaats op de pagina, verander de grootte vanaf elke rand en minimaliseer het terug naar zijn trigger wanneer je de app voor jezelf wilt. Door het naar een rand van de pagina te slepen, dockt het daar, volledige hoogte of volledige breedte, en elke rand behoudt de grootte die je het hebt gegeven. Door het van de rand te slepen, zweeft het weer.
craftforJ wordt bovenop de pagina getekend. Je app wordt niet opnieuw weergegeven, en niets erin beweegt uit de weg, zodat alles wat onder craftforJ zit verborgen is terwijl het daar is. Om te zien wat eronder zit, verplaats je craftforJ naar een andere rand of haal je het van de pagina.
Om de app helemaal niet te bedekken, verplaats je craftforJ van de pagina en in een browservenster of tabblad van zichzelf, wat geschikt is voor een tweede monitor. Het inspecteert nog steeds je app via de pagina die het opende, dus laat die pagina open. Navigeer er vanaf weg of sluit het af en craftforJ heeft niets meer te inspecteren totdat je de app opnieuw opent.
Kies een tabblad in plaats van een venster als je Chrome's splitsweergave 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 splitsweergave en kies dan het craftforJ-tabblad.
Chrome biedt de zij-aan-zij indeling, niet craftforJ. Andere browsers hebben geen equivalent, dus craftforJ opent in andere browsers in een gewoon tabblad waarnaar je overschakelt. craftforJ zelf werkt in beide gevallen hetzelfde.
Het verplaatsen van craftforJ naar een ander venster beëindigt een antwoord dat nog aan het streamen is. craftforJ vraagt eerst, en alles wat tot dat moment is geschreven, blijft in de chat.
Making a first change
- Druk op Alt + Shift + C om een component te kiezen.
- Hover over iets in je app en klik erop.
- De boom selecteert dat component, en de zijbalk wordt gevuld met de eigenschappen.
- Wijzig een eigenschap. De draaiende app wordt onmiddellijk bijgewerkt.
De wijziging heeft alleen invloed op de app voor je. Je bestanden blijven onaangeroerd totdat je de wijziging herzien en toepassen, wat wordt behandeld in Writing changes to source.
Als er helemaal niets verschijnt, werk dan door Troubleshooting.