Publier un plugin

Le dépôt public des plugins héberge les paquets du marché et accepte les changements par pull request. Utilisez ses instructions de contribution et son validateur actuels pour préparer une soumission.

Correspondre à l’application prise en charge

Le catalogue de développement peut être en avance sur la dernière application publiée. Vérifiez ensemble les déclarations publiques et l’application cible. Un paquet qui exige une nouvelle capacité doit attendre une version d’hôte compatible ou cibler explicitement un build de développement correspondant ; modifier seulement minAppVersion ne crée pas l’API manquante.

Utilisez l’Explorateur de capacités pour inspecter les méthodes et versions, puis déclarez le plus petit ensemble compatible que vous avez réellement testé.

Rendre le paquet révisable

Validez manifest.json, le code source lisible, le main.js autonome compilé et les ressources d’exécution requises. Faites correspondre le nom du dossier à l’ID du manifeste. Ne chargez pas de code exécutable distant et ne dépendez pas de fichiers situés hors du paquet.

plugins/my-plugin/
  manifest.json
  main.js
  package.json
  tsconfig.json
  src/main.ts
  assets/

Vérifier le comportement et l’autorité

• Expliquez la fonctionnalité, ses points d’entrée et la raison de chaque permission.
• Déclarez les autorisations exactes des réglages et les origines réseau requises. Expliquez quelles données sont envoyées aux services externes.
• Testez la portée du livre, les permissions absentes, l’annulation, la désactivation/réactivation et l’interface réelle de bureau.
• Gardez l’activation déclarative et les migrations limitées au stockage.
• Vérifiez la conservation des données privées, les quotas et le nettoyage des ressources actives.
• Pour les mises à jour, exercez une installation existante avec des données réalistes, notamment une migration échouée et sa récupération.

L’aperçu local du manifeste aide à repérer les erreurs de compatibilité et d’autorité. Il ne remplace ni le validateur du dépôt, ni les tests de bureau, ni la révision.

Construire et soumettre

Suivez les scripts du checkout. Les vérifications du paquet dans le dépôt public sont :

bun run build
bun run typecheck
bun test
bun run validate

Ajoutez l’entrée correspondante au registre selon le schéma et l’ordre actuels du dépôt. Ouvrez une pull request décrivant le comportement final, les versions testées de l’application et des capacités, les données privées, les services externes et les changements de permissions. Incluez des étapes de vérification reproductibles.

Mises à jour

Augmentez la version du paquet dans le manifeste et le registre. Ne modifiez schemaVersion qu’en cas de changement du schéma de données privées, avec la migration dans le même paquet. Toute demande d’autorité supplémentaire doit être clairement expliquée et offrir un chemin de refus utilisable.

La signature, l’identité de l’éditeur, l’intégrité du paquet, la provenance de la révision et la révocation sont des sujets distincts. Indiquez les contrôles qui s’appliquent réellement au paquet ; l’isolation du Worker ne garantit pas à elle seule qu’un code arbitraire est sûr.

Créer un plugin · Référence de l’API