Getting Started

Instalar

npm install @capgo/capacitor-patch
npx cap sync

El paquete es de no-op hasta que seleccione parches en su configuración Capacitor.

Seleccionar IDs de parches

Listar todos los parches enviados:

npx capgo-capacitor-patch list --all

Luego agregue los IDs de parches que necesita su aplicación a capacitor.config.ts:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example',
  webDir: 'dist',
  plugins: {
    CapacitorPatch: {
      patches: ['upstream-pr-8418-android'],
      strict: true,
    },
  },
};

export default config;

Ejecutar sincronización nuevamente:

npx cap sync

Los parches de paquete se ejecutan antes que sync y updateLos parches de proyectos nativos se ejecutan después que sync y update.

Prueba en modo de ejecución antes de aplicar

Usar doctor para verificar si las parches seleccionados coinciden con las versiones de paquete instaladas:

npx capgo-capacitor-patch doctor --phase package --strict

Usar apply cuando desee ejecutar manualmente los parches seleccionados:

npx capgo-capacitor-patch apply --phase package

Opciones de configuración

Opción	Tipo	Valor predeterminado	Descripción
recommended	boolean	false	Aplica parches Capgo como recomendados.
patches	string[]	[]	Aplica IDs de parches explícitos.
disabled	string[]	[]	Saltar IDs de parches seleccionados, incluso cuando son recomendados.
strict	boolean	false	Lanza una excepción cuando un parche seleccionado es incompatible o no se puede aplicar.

Consejo

Preferir explícitos patches para aplicaciones de producción para que las correcciones aplicadas sean visibles en la revisión code.

CLI comandos

npx capgo-capacitor-patch list --all
npx capgo-capacitor-patch doctor
npx capgo-capacitor-patch apply

Opciones útiles:

• --root <dir> establece la raíz de la aplicación.
• --phase package|native|all limita la fase de parche que se ejecuta.
• --platform ios|android aplica la filtración de plataforma fuera de un Capacitor hook.
• --strict trata las fallas de parche seleccionadas como errores.

Flujo de trabajo

1. Instalar @capgo/capacitor-patch.
2. Ejecutar npx capgo-capacitor-patch list --all.
3. Agregar los IDs de parche seleccionados a plugins.CapacitorPatch.patches.
4. Ejecutar npx capgo-capacitor-patch doctor --strict.
5. Ejecutar npx cap sync.

Cuando un parche seleccionado apunta a @capacitor/cli, el parche se aplica al paquete CLI instalado y al siguiente cap command uses the patched CLI code.

Sección titulada “continuar desde Getting Started”

Getting Started Si estás utilizando para planificar el trabajo de plugin nativo, conectarlo 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 Empresa de Ionic para el flujo de trabajo del producto en Alternativas de Plugins de Empresa de Ionic.