====== 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 [[start|Übersicht]].

===== Erkennung =====

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.

===== Befehle =====

==== Add-in installieren ====

<code bash>
wdochost --install-extension <pfad>
</code>

Installiert ein [[paketformat|.wvdsx-Paket]] in das Benutzer-Erweiterungsverzeichnis.

**Parameter:**
  * ''<pfad>'' — Pfad zu einer ''.wvdsx''- oder ''.vsix''-Datei

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

**Beispiel:**
<code bash>
wdochost --install-extension wvds.assets-manager-1.2.0.wvdsx
</code>

**Exit-Codes:**
  * ''0'' — Erfolgreich installiert
  * ''1'' — Fehler (Datei nicht gefunden, ungültiges Manifest, Kompatibilitätsproblem)

==== Add-in deinstallieren ====

<code bash>
wdochost --uninstall-extension <id>
</code>

Entfernt ein installiertes Add-in.

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

**Ablauf:**
  - Das Installationsverzeichnis des Add-ins wird gelöscht.
  - Der Registry-Eintrag wird entfernt.

**Beispiel:**
<code bash>
wdochost --uninstall-extension wvds.assets-manager
</code>

==== Installierte Add-ins auflisten ====

<code bash>
wdochost --list-extensions
</code>

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

**Beispielausgabe:**
<code>
wvds.assets-manager    1.2.0  active
wvds.core-services     1.0.0  active
demo.hello-world       1.0.0  not-activated
</code>

==== Debug-Modus ====

<code bash>
wdochost --debug-extension=<id>
</code>

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:**
<code bash>
wdochost --debug-extension=demo.asset-editor
</code>

===== Pfade =====

| **Verzeichnis** | **Pfad** | **Beschreibung** |
| Machine-Add-ins | ''<exe>/plugins/'' | Vom Administrator gebundelte Add-ins (MSI/GPO, schreibgeschützt) |
| Benutzer-Add-ins | ''~/.wvdsx/extensions/'' | Vom Benutzer installierte Add-ins (Roaming-Profile-kompatibel) |
| Benutzer-Einstellungen | ''~/.wvdsx/settings.json'' | Globale Einstellungen |
| Workspace-Einstellungen | ''.wvdsx/settings.json'' | Projektspezifische Einstellungen |
| Benutzer-Storage | ''~/.wvdsx/storage/<id>/'' | Persistenter Speicher pro Add-in |
| Workspace-Storage | ''.wvdsx/storage/<id>/'' | Workspace-spezifischer Speicher pro Add-in |
| Log-Dateien | ''~/.wvdsx/logs/'' | Host- und Add-in-Logs |
| Plugin-Daten | ''~/.wvdsx/plugin-data/'' | Per-Plugin persistenter Zustand |

Zurück zur [[start|Übersicht]].