Publicar un plugin

El repositorio público de plugins aloja paquetes del mercado y acepta cambios mediante pull requests. Al preparar un envío, usa sus instrucciones de contribución y su validador actuales.

Comprueba la aplicación compatible

El catálogo de desarrollo puede ir por delante de la última aplicación publicada. Verifica juntas las declaraciones públicas y la aplicación objetivo. Un paquete que necesite una capacidad nueva debe esperar a una versión compatible del host o indicar claramente que apunta a una compilación de desarrollo correspondiente; cambiar solo minAppVersion no crea la API que falta.

Usa el Explorador de capacidades para inspeccionar métodos y versiones y declara después el conjunto compatible más pequeño que hayas probado realmente.

Haz que el paquete sea revisable

Incluye manifest.json, fuentes legibles, el main.js compilado y autocontenido y los recursos de ejecución necesarios. Mantén el nombre de la carpeta igual al ID del manifest. No cargues código ejecutable remoto ni dependas de archivos fuera del paquete.

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

Comprueba el comportamiento y la autoridad

• Explica la función, sus puntos de entrada y por qué necesita cada permiso.
• Declara los permisos exactos de Ajustes y los orígenes de red necesarios. Explica qué datos llegan a servicios externos.
• Prueba el ámbito de libros, los permisos ausentes, la cancelación, la desactivación y reactivación y la interfaz real de escritorio.
• Mantén declarativas la activación y las migraciones limitadas al almacenamiento.
• Comprueba la retención de datos privados, las cuotas y la limpieza de recursos activos.
• Para las actualizaciones, prueba una instalación existente con datos realistas, incluida una migración fallida y su recuperación.

La vista previa local del manifest ayuda a detectar errores de compatibilidad y autoridad. No sustituye al validador del repositorio, las pruebas de escritorio ni la revisión.

Compila y envía

Sigue los scripts del checkout. Las comprobaciones de paquetes del repositorio público son:

bun run build
bun run typecheck
bun test
bun run validate

Añade la entrada correspondiente del registro según el esquema y el orden actuales del repositorio. Abre un pull request que describa el comportamiento final, las versiones probadas de la aplicación y las capacidades, los datos privados, los servicios externos y los cambios de permisos. Incluye pasos de verificación reproducibles.

Actualizaciones

Aumenta la versión del paquete en el manifest y en el registro. Cambia schemaVersion solo cuando cambie el esquema de datos privados, incluyendo su migración en el mismo paquete. Una solicitud de mayor autoridad necesita una explicación clara y una vía de rechazo utilizable.

La firma, la identidad del publicador, la integridad del paquete, la procedencia de la revisión y la revocación son aspectos distintos de la distribución. Indica los controles que realmente se aplican al paquete; el aislamiento de Worker por sí solo no garantiza nada sobre código arbitrario.

Crea un plugin · Referencia de la API