Bauen, prüfen und veröffentlichen

Die Plugin-Vorlage automatisiert die wiederholbaren Schritte für ein eigenes GitHub-Repository.

Paket und Katalog bauen

npm run build
npm run check

Der Build erzeugt aus dem Manifest das installierbare Paket und synchronisiert den passenden Plugin-Eintrag im repository.json. Die Prüfung kontrolliert unter anderem IDs, Paketpfad und die Metadaten im erzeugten Paket. Ein GitHub-Actions-Workflow führt Build und Prüfung bei Pushes und Pull Requests aus.

Veröffentlichungsschritte

Beachte die Versions- und Kompatibilitätsregeln einschließlich Sicherung, Migrationsgrenzen und Wiederherstellung.

1. Erhöhe version im Manifest bei jeder funktionalen oder sichtbaren Veröffentlichung.
2. Führe npm run build und npm run check aus.
3. Prüfe, ob Manifest, Katalog und erzeugtes Paket dieselbe ID und Version enthalten.
4. Kontrolliere Paketdateien, Asset-Pfade, externe Anfragen und deklarierte Fähigkeiten.
5. Veröffentliche den Katalog durch Push nach main: https://raw.githubusercontent.com/<owner>/<repo>/main/repository.json. GitHub Pages ist dafür nicht nötig; es dient optional zur Veröffentlichung der install.html.
6. Füge die Katalog-URL in ATLAS Administration hinzu und teste Vorschau und Paketinstallation.

Halte die Plugin-ID nach der ersten Veröffentlichung stabil. Größere Binärdateien gehören nicht in das textbasierte Paketformat; hoste sie separat und referenziere sie über eine URL.

Installationsstatus

Der App-Server installiert geprüfte Repository- und Importpakete im persistenten Plugin-Verzeichnis und stellt statische Webdateien unter /plugin-assets/<slug>/ bereit. Beim Öffnen läuft deren JavaScript im Browser; beliebige Node-Module oder Runtime-Hooks werden nicht automatisch registriert. Die Installation ist keine Sandbox: Prüfe Paket und Browsercode vor dem Öffnen. Ein Paketbuild allein ersetzt keine Laufzeit- oder Sicherheitsprüfung.