Ein Plugin veröffentlichen
Das öffentliche Plugin-Repository enthält Marktplatzpakete und nimmt Änderungen über Pull Requests an. Verwende zur Vorbereitung einer Einreichung die aktuellen Beitragsanweisungen und den Validator.
Passe dich an die App an, die du unterstützt
Der Entwicklungskatalog kann der zuletzt veröffentlichten App voraus sein. Die Datei types/host-capabilities.json des Repositorys beschreibt genau diese Version, und ihr Validator lehnt requires-Bereiche ab, die die Version nicht erfüllen kann. Ein Paket, das eine neue Fähigkeit benötigt, muss auf eine kompatible Host-Version warten; eine Änderung von minAppVersion allein erzeugt die fehlende API nicht.
Nutze den Capabilities Explorer, um Methoden und Versionen zu prüfen, und deklariere dann die kleinste kompatible Menge, die du tatsächlich getestet hast.
Das Paket prüfbar machen
Committe manifest.json, lesbaren Quelltext, die gebaute eigenständige main.js und benötigte Laufzeit-Assets. Halte den Ordnernamen identisch mit der Manifest-ID. Lade keinen ausführbaren Code aus dem Netz und verlasse dich nicht auf Dateien außerhalb des Pakets.
plugins/my-plugin/
manifest.json
main.js
package.json
src/main.ts
src/main.test.ts
assets/Verhalten und Autorität prüfen
- Erkläre die Funktion, ihre Einstiegspunkte und warum jede Berechtigung benötigt wird.
- Deklariere genaue Einstellungsfreigaben und erforderliche Netzwerkursprünge. Erkläre, welche Daten an externe Dienste gehen.
- Teste Buchumfang, fehlende Berechtigungen, Abbruch, Deaktivierung und erneute Aktivierung sowie die tatsächliche Desktop-Oberfläche.
- Halte Aktivierung deklarativ und Migrationen auf den Speicher beschränkt.
- Prüfe die Aufbewahrung privater Daten, Kontingente und die Bereinigung aktiver Ressourcen.
- Prüfe bei Updates eine bestehende Installation mit realistischen Daten, einschließlich fehlgeschlagener Migration und Wiederherstellung.
Die lokale Manifestvorschau hilft, Fehler bei Kompatibilität und Autorität zu erkennen. Sie ersetzt weder den Repository-Validator noch Desktop-Tests oder die Prüfung.
Bauen und Einreichen
Führen Sie die Prüfungen des öffentlichen Repositorys von dessen Wurzelverzeichnis aus aus; bun run check ist das, was CI bei Ihrem Pull Request ausführt:
bun install
bun run build
bun run checkFügen Sie den passenden Registry-Eintrag gemäß dem aktuellen Schema und der Reihenfolge des Repositorys hinzu. Öffnen Sie einen Pull Request, der das endgültige Verhalten, die getestete App und die Capability-Versionen, private Daten, externe Dienste und Berechtigungsänderungen beschreibt. Fügen Sie reproduzierbare Verifikationsschritte bei.
Updates
Erhöhe die Paketversion im Manifest und Register. Ändere schemaVersion nur bei einer Schemaänderung privater Daten und liefere die Migration im selben Paket. Eine Anfrage nach mehr Autorität braucht eine klare Begründung und einen nutzbaren Ablehnungspfad.
Signierung, Herausgeberidentität, Paketintegrität, Herkunft der Prüfung und Widerruf sind getrennte Aspekte der Verteilung. Nenne die Kontrollen, die für das Paket tatsächlich gelten; Worker-Isolation allein ist keine Garantie für beliebigen Code.