Saltar al contenido

@capgo/capacitor-patch

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

@capgo/capacitor-patch es un paquete de hook solo de Capacitor que aplica archivos de parche seleccionados siempre que Capacitor se ejecute sync o update.

Se construyó para correcciones útiles antes de que lleguen a una versión oficial de Capacitor. El catálogo integrado sigue las PRs externas de Capacitor reflejadas por Capacitor+ramas. sync/upstream-pr-* Nota

Capacitor paquetes

Parche @capacitor/core, @capacitor/android, @capacitor/ios, y terceros Capacitor plugins bajo node_modules.

Capacitor CLI

Se envía el parche CLI archivos JavaScript. Cuando se aplica un parche CLI, la siguiente cap comando utiliza el parcheado code.

Proyectos nativos

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

Selección segura

Rangos de versión, comprobaciones idempotentes y modo estricto ayudan a evitar parches caducos que se apliquen silenciosamente.

Los parches están habilitados por defecto. Muestra el catálogo enviado, selecciona los IDs de parche que necesita tu aplicación y agréguelos 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
  • el rango de versión soportado
  • el PR upstream Capacitor
  • la rama de sincronización Capacitor+ que coincide
  • el archivo de parche enviado con el paquete

Usar @capgo/capacitor-patch cuando:

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

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, conectarlo 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 Ionic Enterprise Plugin Alternativas.