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.
Acorde con la app que admites
El catálogo de desarrollo puede ir por delante de la última app publicada. El archivo types/host-capabilities.json del repositorio describe esa versión, y su validador rechaza los rangos de requires que dicha versión no puede satisfacer. Un paquete que necesite una capacidad nueva debe esperar a una versión del host compatible; cambiar solo minAppVersion no crea la API que falta.
Usa el Explorador de capacidades para inspeccionar métodos y versiones, y luego declara 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
src/main.ts
src/main.test.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.
Compilar y enviar
Ejecuta las comprobaciones del repositorio público desde su raíz; bun run check es lo que CI ejecuta en tu pull request:
bun install
bun run build
bun run checkAñade la entrada correspondiente en el 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 de la capacidad, 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.