Saltar al contenido

@capgo/capacitor-patch

Aplica correcciones verificadas a los paquetes core de Capacitor, CLI, plugins y proyectos nativos durante los hooks de sync y update.

@capgo/capacitor-patch es un paquete Capacitor basado solo en hooks que aplica los archivos de patch seleccionados cada vez que se ejecuta Capacitor sync o update.

Está diseñado para aplicar fixes útiles antes de que lleguen a una versión oficial de Capacitor. El catálogo incluido rastrea los PRs de Capacitor externos que son replicados por Capacitor+ sync/upstream-pr-* branches.

PlataformaSoporteNotas
iOSHookcap sync patches
AndroidHookcap sync patches
WebN/Asolo CLI

paquetes Capacitor

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

Capacitor CLI

El patch envía archivos JavaScript CLI. Cuando se aplica un patch CLI, el siguiente cap comando usa el code parcheado.

Proyectos nativos

Aplica los patches generados para proyectos Android o iOS después de cap sync o cap update.

Selección segura

Rangos de versión, comprobaciones de idempotencia y modo estricto evitan que se apliquen patches obsoletos.

Los patches son opt-in por defecto. Lista el catálogo disponible, elige los IDs de patch que tu app necesite y añádelos a plugins.CapacitorPatch.patches.

Cada entrada del catálogo incluye:

  • un ID de patch estable
  • el paquete objetivo o la fase del proyecto nativo
  • el rango de versiones soportadas
  • el PR de Capacitor original
  • la rama de sync Capacitor correspondiente
  • el archivo de patch incluido en el paquete

Usa @capgo/capacitor-patch cuando:

  • hay un fix de Capacitor en upstream que aún no se ha publicado
  • tu app necesita el fix sin tener que mantener scripts de parches locales
  • quieres que los parches se reapliquen tras cada sync/update de Capacitor
  • necesitas un catálogo legible por el equipo con los fixes de los que depende tu app

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

Si estás usando @capgo/capacitor-patch para planificar el trabajo con plugins nativos, conéctalo con Uso de @capgo/capacitor-patch para la capacidad nativa al usar @capgo/capacitor-patch, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.