Skip to main content
Entwickler Themen
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

8.2.6. IntelliJ einrichten und verwenden

Das Plugin bettet dieselbe JavaFX-26- und Scene-Builder-Kit-Oberfläche ein wie die Standalone-Anwendung. IntelliJ verwaltet Dokumente, Speichern, Befehle und Undo/Redo. Anwendungsklassen bleiben in getrennten Zielprozessen.

Geprüfte IDE und Toolkit

Derzeit ist IntelliJ-Build 263.7307.200 unter macOS qualifiziert. Obwohl die Plugin-Metadaten die allgemeinere 263-Buildfamilie nennen, prüft die Laufzeit den genauen SDK-Stand. Eine erfolgreiche Installation in einer anderen Version wäre noch keine Nutzungsfreigabe.

Vor dem Öffnen des Designers wird über die IntelliJ-Aktion Registry die Einstellung embed.scene.builder deaktiviert. Danach ist ein Neustart nötig. Die JavaFX- und FXML-Sprachunterstützung bleibt aktiviert.

Der Designer verweigert die Initialisierung, wenn die gebündelte Scene-Builder-Einbettung noch aktiv ist oder inkompatible Glass-Bibliotheken bereits geladen wurden. Zwei native JavaFX-Toolkits sollen nicht im selben IDE-Prozess laufen. Wird die Registry-Einstellung während der Sitzung wieder geändert, wird der Designer deaktiviert. Anschließend muss IntelliJ mit den passenden Einstellungen neu gestartet werden.

Plugin lokal bauen

Zunächst werden die gemeinsamen Designer-Module mit JDK 25 wie im Schnellstart gebaut und lokal installiert. IDEA_HOME zeigt auf das Contents-Verzeichnis der qualifizierten macOS-Anwendung. Im Designer-Checkout:

export JAVA_HOME=/absoluter/pfad/zum/jdk-25
export IDEA_HOME=/Applications/QualifizierteIDE.app/Contents
./designer-intellij/gradlew -p designer-intellij --no-daemon \
  -PideaHome="$IDEA_HOME" test buildPlugin verifyPluginProjectConfiguration

Das Plugin-ZIP liegt danach unter designer-intellij/build/distributions/. Es wird in IntelliJ über die Plugin-Installation von Datenträger installiert. Nach dem Neustart sind zusätzlich die oben genannten Toolkit-Einstellungen zu prüfen. Hier handelt es sich um ein Entwicklungs-Plugin, nicht um eine veröffentlichte Marketplace-Version.

Dasselbe Projekt verwenden

IntelliJ verwendet die gemeinsame neitzel-fx-designer.json und die lokalen Dateien unter .neitzel-fx-designer. Der Helfer des Schnellstarts erzeugt auch die für diesen Host benötigte host.properties. Die darin genannten Worker-JARs wählen nicht das native Toolkit der IDE aus. Build-JDK, Ziel-JDK und IDE-Laufzeit bleiben getrennte Aufgaben.

Nach dem Öffnen einer FXML-Ressource wird der Editor Neitzel Designer gewählt. Der gewöhnliche IntelliJ-XML-Editor bleibt verfügbar. Source, Design und Split innerhalb des Designers sind lediglich weitere Darstellungen desselben nativen Dokuments.

Build and Refresh aktiviert einen erfolgreichen Anwendungssnapshot. Ein normaler IDE-Build führt diesen Vorgang nicht automatisch aus. Fehlerhafte Designer-Einstellungen sollen die gewöhnliche Quelltextbearbeitung nicht verhindern.

Speichern, Historie und Navigation

Die normalen IntelliJ-Befehle für Save, Undo und Redo können ebenso verwendet werden wie die gemeinsamen Designer-Aktionen. Eine unterstützte visuelle Änderung wird als ein nativer Dokumentbefehl ausgeführt.

Probleme erscheinen zusätzlich im IntelliJ-Problems-Bereich und als XML-Annotationen. Alt+Enter bietet die begrenzten gemeinsamen Korrekturen an. Alle Aktionen bleiben an die aktuelle Dokumentrevision und Diagnose gebunden.

Open Component aktiviert einen bereits geöffneten Tab oder öffnet die Component in einem weiteren Tab. Die übergeordnete View bleibt erhalten. Mehrere Projekte und Editoren besitzen getrennte Lebenszyklen. Das Schließen eines Editors räumt seine Worker auf, ohne andere Vorschauen zu beenden.

Isoliert testen

Für einen Test mit eigenem Konfigurations-, System- und Plugin-Verzeichnis steht ein Fixture-Launcher bereit:

python3 scripts/run-fixture-host.py intellij \
  --java-home "$JAVA_HOME" \
  --target-java-home /absoluter/pfad/zum/jdk-21 \
  --idea-home "$IDEA_HOME"

Er verändert nicht die Einstellungen der normalen IDE-Installation und deaktiviert die gebündelte Einbettung für diesen Test. Der automatisierte Test des tatsächlich registrierten Editors wird nach Vorbereitung der dokumentierten Referenzartefakte gestartet:

python3 scripts/check-ide-host.py --java-home "$JAVA_HOME" \
  --target-java-home /absoluter/pfad/zum/jdk-21 \
  --idea-home "$IDEA_HOME"

Mit --mode modulepath --repeat 3 wird die wiederholte Modulpfad-Prüfung gewählt. Diese Abläufe benötigen eine echte macOS-Desktopsitzung.

Die frühere prototypische Übergabe zwischen IntelliJ und Standalone ist noch keine produktive Funktion dieses Plugins. Zwei unabhängig geöffnete Editoren ersetzen keinen abgestimmten Dokumentbesitz mit Transfer-Tickets. Ebenso bedeutet die automatisierte Prüfung keine vollständige menschliche VoiceOver-Abnahme.