CLI-Referenz

Der Host bietet eine Kommandozeilenschnittstelle für die Verwaltung von Add-ins. Sie ermöglicht Installation, Deinstallation und Auflistung ohne grafische Oberfläche. Darüber hinaus gibt es einen Debug-Modus für die Add-in-Entwicklung.

Zurück zur Übersicht.

Der Host erkennt den CLI-Modus an bestimmten Kommandozeilenparametern. Wenn einer dieser Parameter übergeben wird, startet die Anwendung ohne GUI, führt die Operation aus und beendet sich mit einem Exit-Code.

wdochost --install-extension <pfad>

Installiert ein .wvdsx-Paket in das Benutzer-Erweiterungsverzeichnis.

Parameter:

• <pfad> — Pfad zu einer .wvdsx- oder .vsix-Datei

Ablauf:

1. Das ZIP-Archiv wird in ~/.wvdsx/extensions/<publisher>.<name>/ entpackt.
2. plugin.json wird geparst und validiert.
3. engineVersion wird gegen die Host-Version geprüft.
4. dllChecksum wird verifiziert (falls vorhanden).
5. Das Add-in wird in die Extension-Registry eingetragen.

Beispiel:

wdochost --install-extension wvds.assets-manager-1.2.0.wvdsx

Exit-Codes:

• 0 — Erfolgreich installiert
• 1 — Fehler (Datei nicht gefunden, ungültiges Manifest, Kompatibilitätsproblem)

wdochost --uninstall-extension <id>

Entfernt ein installiertes Add-in.

Parameter:

• <id> — Die Add-in-Id im Format publisher.name (z.B. wvds.assets-manager)

Ablauf:

1. Das Installationsverzeichnis des Add-ins wird gelöscht.
2. Der Registry-Eintrag wird entfernt.

Beispiel:

wdochost --uninstall-extension wvds.assets-manager

wdochost --list-extensions

Listet alle installierten Add-ins mit Id, Version und Status auf.

Beispielausgabe:

wvds.assets-manager    1.2.0  active
wvds.core-services     1.0.0  active
demo.hello-world       1.0.0  not-activated

wdochost --debug-extension=<id>

Startet die GUI-Anwendung mit einem bestimmten Add-in im Debug-Modus. Dieser Modus ist für die Entwicklung gedacht und ermöglicht es, ein Add-in zu testen, ohne es vorher installieren zu müssen.

Parameter:

• <id> — Die Add-in-Id, die im Debug-Modus geladen werden soll

Verhalten:

• Die Anwendung startet normal mit GUI.
• Das angegebene Add-in wird mit erhöhtem Logging geladen.
• Fehler im Add-in werden detailliert in der Konsole ausgegeben.
• Das Add-in kann aus dem Quellverzeichnis geladen werden (ohne Installation).

Beispiel:

wdochost --debug-extension=demo.asset-editor

Zurück zur Übersicht.