Saltar al contenido

@capgo/capacitor-patch

Aplicar fijaciones aprobadas a los paquetes de núcleo de Capacitor, los CLI, plugins y proyectos nativos durante los hooks de sincronización y actualización.

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

Está diseñado para fijaciones útiles antes de que estén disponibles en una versión oficial de Capacitor. El catálogo integrado sigue las PRs externas de Capacitor reflejadas en Capacitor+ sync/upstream-pr-* ramas

paquetes Capacitor

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

Capacitor CLI

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

Proyectos nativos

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

Selección segura

Las rangos de versión, las comprobaciones de idempotencia y el modo estricto ayudan a prevenir que parches obsoletos se apliquen de manera silenciosa.

Los parches están habilitados por defecto. Enumera el catálogo enviado, selecciona los IDs de parche que necesita tu aplicación y agréguelos a plugins.CapacitorPatch.patches.

Cada entrada del catálogo incluye:

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

Uso @capgo/capacitor-patch cuando:

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

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

Si estás utilizando @capgo/capacitor-patch para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-patch para la capacidad nativa en Usando @capgo/capacitor-patch, Directorio de Plugins de Capgo para el flujo de trabajo del producto en Directorio de Plugins de Capgo, Plugins de Capacitor por Capgo para el detalle de implementación en Plugins de Capacitor 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.