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.

Die unterstützte App festlegen

Der Entwicklungs-Katalog kann der neuesten veröffentlichten App voraus sein. Prüfe öffentliche Deklarationen und Ziel-App gemeinsam. Ein Paket, das eine neue Fähigkeit benötigt, muss auf eine kompatible Host-Version warten oder eindeutig auf einen passenden Entwicklungs-Build zielen; eine Änderung nur an minAppVersion erzeugt die fehlende API nicht.

Nutze den Capabilities Explorer, um Methoden und Versionen zu prüfen, und deklariere anschließend 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
  tsconfig.json
  src/main.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

Folge den Skripten des Checkouts. Die Paketprüfungen des öffentlichen Repositorys sind:

bun run build
bun run typecheck
bun test
bun run validate

Füge den passenden Registereintrag gemäß aktuellem Schema und aktueller Reihenfolge des Repositorys hinzu. Öffne einen Pull Request, der endgültiges Verhalten, getestete App- und Fähigkeitsversionen, private Daten, externe Dienste und Berechtigungsänderungen beschreibt. Füge reproduzierbare Prüfschritte 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.

Plugin erstellen · API-Referenz