Saltar al contenido

@capgo/capacitor-patch

Aplicar correcciones aprobadas a los paquetes de núcleo de Capacitor, los CLI, plugins y proyectos nativos durante las sincronizaciones y actualizaciones.

@capgo/capacitor-patch es un paquete de Capacitor solo de hook que aplica archivos de corrección seleccionados cada vez que Capacitor se ejecuta sync o update.

Está diseñado para reparaciones útiles antes de que lleguen a una versión oficial Capacitor. El catálogo integrado sigue las PRs externas de upstream Capacitor reflejadas por Capacitor+ sync/upstream-pr-* ramas.

paquetes Capacitor

Arreglo @capacitor/core, @capacitor/android, @capacitor/iosy terceros Capacitor plugins bajo node_modules.

Capacitor CLI

Arreglo enviado CLI archivos JavaScript. Cuando se aplica un CLI parche, el siguiente cap El comando utiliza la versión parcheada code.

Proyectos nativos

Aplicar parches de proyectos de Android o iOS generados después de cap sync o cap update.

Seleciones de seguridad

Rangos de versión, comprobaciones de idempotencia y modo estricto ayudan a evitar que los parches estancados se apliquen silenciosamente.

Catálogo de parches

Catálogo de parches

Los parches están habilitados por defecto. Enumere el catálogo enviado, seleccione los IDs de parche que necesita su aplicación y agregue los a plugins.CapacitorPatch.patches.

En cada entrada del catálogo se incluye:

  • un ID de parche estable
  • el paquete o fase de proyecto nativo objetivo
  • rango de versión soportado
  • el PR de upstream Capacitor
  • el rama de sincronización Capacitor+ que coincide
  • el archivo de parches que se envía con el paquete

Usar @capgo/capacitor-patch cuando:

  • existe una corrección Capacitor en upstream pero aún no se ha enviado
  • su aplicación necesita la corrección sin mantener scripts de parches locales
  • quiere que los parches se reapliquen después de cada sincronización/Capacitor de actualización
  • necesita un catálogo legible por el equipo de las correcciones en las que depende su aplicación

Para obtener un catálogo completo y una guía de contribución, consulte el repositorio capacitor-patch.

Si está utilizando @capgo/capacitor-patch para planificar el trabajo de plugin nativo, conecte con Usando @capgo/capacitor-patch para la capacidad nativa en Usando @capgo/capacitor-patch, Capgo Directorio de Plugins para el flujo de trabajo del producto en Capgo Directorio de Plugins, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.