💻 Lokale Entwicklung

Diese Seite beschreibt, wie du die BMC TPL Code All around Extension lokal auf deinem Rechner einrichtest, den Quellcode kompilierst und eigene Anpassungen testest.

🛠️ Voraussetzungen

Bevor du startest, stelle sicher, dass folgende Tools auf deinem System installiert sind:

Node.js (inklusive npm)
Visual Studio Code
Git
(Optional, aber empfohlen) vsce für das Bauen von .vsix Paketen (npm install -g @vscode/vsce)

🚀 Setup & Installation

Repository klonen:

git clone https://wiccafe.de/kuro/bmc-tpl-code-all-around.git
cd bmc-tpl-code-all-around

Abhängigkeiten installieren:
```
npm install
```
Projekt in VS Code öffnen:
```
code .
```

🔄 Entwicklungs-Workflow

Der Standard-Workflow für die Entwicklung von VS Code Extensions ist extrem komfortabel:

Code ändern: Nimm deine gewünschten Änderungen am TypeScript-Code im src-Ordner vor.
Lokal ausführen (Debug-Modus): Drücke einfach F5 in VS Code.
- Im Hintergrund wird das Skript npm run watch gestartet (kompiliert TypeScript und esbuild automatisch bei jeder Änderung).
- Es öffnet sich ein neues, isoliertes VS Code-Fenster (der Extension Development Host). In diesem Fenster ist die Entwicklungsversion des Plugins sofort aktiv.
Änderungen testen: Öffne eine .tpl Datei im Development Host. Wenn du im Hauptfenster Code änderst, kannst du im Development Host einfach Ctrl + R (bzw. Cmd + R) drücken, um das Plugin sofort neu zu laden, ohne das Fenster schließen zu müssen.

📜 Wichtige Skripte

In der package.json sind verschiedene Hilfsskripte definiert, die du über das Terminal ausführen kannst:

Befehl	Beschreibung
`npm run watch`	Startet den Compiler (esbuild & tsc) im Watch-Modus. Ideal für die laufende Entwicklung.
`npm run compile`	Kompiliert den Code einmalig (Typ-Check & esbuild).
`npm run lint`	Führt ESLint aus, um den Code auf saubere Formatierung und Syntaxfehler zu prüfen.
`npm run package`	Führt Checks durch und bündelt die Erweiterung in eine fertige `.vsix` Datei für den Release.
`npm run test`	Führt die automatisierten Tests (`vscode-test`) der Extension aus.

📦 Release bauen (VSIX)

Wenn du eine neue Version fertiggestellt hast und sie im Gitea-Repository hochladen möchtest, baust du das Release-Paket mit:

npm run package

(Dies setzt voraus, dass vsce global auf deinem System installiert ist.)

Dieser Befehl generiert eine saubere .vsix Datei im Projektverzeichnis, die du direkt verteilen, hochladen oder in deiner regulären VS Code Instanz installieren kannst.