Getting Started
craftforJ wird zusammen mit webforJ geliefert, sodass es nichts separat herunterzuladen gibt. Diese Seite behandelt, was Ihre App benötigt, bevor craftforJ angezeigt wird, und wie Sie es öffnen können.
Projekte, die mit startforJ oder aus einem webforJ Archetyp erstellt wurden, haben craftforJ aktiviert. Wenn Sie von einem solchen Projekt gestartet haben, führen Sie Ihre App aus und überspringen Sie den Abschnitt Öffnen von craftforJ.
Anforderungen
craftforJ wird nur dann an eine App angehängt, wenn alle folgenden Bedingungen erfüllt sind. Wenn eine davon nicht erfüllt ist, wird nichts auf der Seite angezeigt.
Abhängigkeit hinzufügen
Fügen Sie webforj-devtools zu Ihrem Projekt hinzu, wenn es noch nicht vorhanden ist:
<dependency>
<groupId>com.webforj</groupId>
<artifactId>webforj-devtools</artifactId>
<version>${webforj.version}</version>
</dependency>
Debug-Modus und das craftforJ-Symbol
Fügen Sie die folgenden Eigenschaften zu Ihrem Projekt hinzu. Wenn Sie eine Standard-webforJ-App haben, setzen Sie die Eigenschaften in webforj.conf. Für ein webforJ-Projekt, das Spring verwendet, setzen Sie die Eigenschaften in application.properties.
webforj.debug = true
webforj.devtools.craftforj.enabled = true
craftforJ funktioniert nur, wenn beide Eigenschaften aktiviert sind; daher exponiert eine App, die mit aktiviertem Debug-Modus in die Produktion geht, nicht Ihren Quellbaum.
Ein lokaler Browser und eine Entwicklerlizenz
Öffnen Sie die App von dem Rechner, auf dem sie läuft, und stellen Sie sicher, dass Sie eine gültige Entwicklerlizenz haben. Um von einem anderen Rechner auf craftforJ zuzugreifen, fügen Sie dessen Adresse zu hosts-allowed hinzu.
Sobald dies eingerichtet ist, starten Sie die App neu und laden Sie die Seite erneut.
Öffnen von craftforJ
Wenn craftforJ aktiv ist, erscheint ein Trigger-Button über Ihrer App. Klicken Sie darauf, um craftforJ zu öffnen, oder drücken Sie Alt + Shift + D von überall in der App. Derselbe Shortcut schließt craftforJ und Sie können den Trigger an die Ecke ziehen, die Ihnen am besten gefällt.
Seine Tabs decken den Komponentenbaum, Routen, das Theme und den Assistenten ab. Einstellungen und App-Informationen befinden sich neben ihnen.
- Der Trigger ist der Button, der craftforJ öffnet und schließt. Er bleibt aus dem Weg, während craftforJ geschlossen ist.
- Die Tab-Leiste verläuft entlang der Kante, die der App am nächsten ist, und wechselt zwischen dem, was craftforJ Ihnen zeigt.
- Das Fenster-Menü enthält alles darüber, wo craftforJ sitzt, behandelt in Wo craftforJ sitzt.
craftforJ schreibt jede Tastenkombination unter Verwendung der Modifikatoren der Plattform, auf der Sie sich befinden, sodass Alt als ⌥ und Ctrl als ⌘ erscheint. Drücken Sie Shift + ? in craftforJ, um die aktuelle Liste zu sehen.
Wo craftforJ sitzt
craftforJ schwebt standardmäßig über Ihrer App. Ziehen Sie es irgendwo auf die Seite, ändern Sie die Größe von jeder Kante und minimieren Sie es zurück zu seinem Trigger, wenn Sie die App für sich haben möchten. Wenn Sie es an eine Kante der Seite ziehen, docken Sie es dort an, mit voller Höhe oder voller Breite, und jede Kante behält die Größe, die Sie ihm gegeben haben. Wenn Sie es von der Kante wegziehen, schwebt es wieder.
craftforJ wird über der Seite gezeichnet. Ihre App wird nicht neu dimensioniert, und nichts darin bewegt sich aus dem Weg, sodass alles, was sich unter craftforJ befindet, verborgen ist, während es dort ist. Um zu sehen, was darunter liegt, bewegen Sie craftforJ an eine andere Kante oder nehmen Sie es aus der Seite.
Um die App überhaupt nicht zu überdecken, ziehen Sie craftforJ aus der Seite in ein Browserfenster oder einen Tab für sich, was sich für einen zweiten Monitor eignet. Es inspiziert weiterhin Ihre App durch die Seite, die es geöffnet hat, also lassen Sie diese Seite offen. Navigieren Sie weg oder schließen Sie sie, hat craftforJ nichts mehr zu inspizieren, bis Sie die App erneut öffnen.
Wählen Sie einen Tab anstelle eines Fensters, wenn Sie die Split-View von Chrome verwenden, die Ihre App und craftforJ nebeneinander anzeigt und nur echte Tabs akzeptiert. Klicken Sie mit der rechten Maustaste auf den Tab Ihrer App, fügen Sie ihn zu einem neuen Split-View hinzu und wählen Sie dann den Tab von craftforJ.
Chrome bietet die Anordnung nebeneinander an, nicht craftforJ. Andere Browser haben kein entsprechendes Pendant, sodass craftforJ in anderen Browsern in einem normalen Tab geöffnet wird, zu dem Sie wechseln. craftforJ selbst funktioniert in beiden Fällen gleich.
Das Bewegen von craftforJ in ein anderes Fenster beendet eine Antwort, die noch gestreamt wird. craftforJ fragt zuerst, und alles, was bis zu diesem Punkt geschrieben wurde, bleibt im Chat.
Erste Änderung vornehmen
- Drücken Sie Alt + Shift + C, um mit der Auswahl einer Komponente zu beginnen.
- Fahren Sie mit der Maus über etwas in Ihrer App und klicken Sie darauf.
- Der Baum wählt diese Komponente aus, und die Seitenleiste füllt sich mit ihren Eigenschaften.
- Ändern Sie eine Eigenschaft. Die laufende App wird sofort aktualisiert.
Die Änderung wirkt sich nur auf die App vor Ihnen aus. Ihre Dateien bleiben unberührt, bis Sie die Änderung überprüfen und anwenden, was in Änderungen in den Quellcode schreiben behandelt wird.
Wenn überhaupt nichts angezeigt wird, arbeiten Sie durch die Fehlerbehebung.