Comenzar

Instalar

Puede utilizar nuestra configuración asistida por IA para instalar el complemento. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego utilice el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-patch` plugin in my project.

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siguiendo las instrucciones específicas de la plataforma a continuación:

npm install @capgo/capacitor-patch
npx cap sync

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

Seleccionar IDs de parche

Lista de todos los parches embarcados:

npx capgo-capacitor-patch list --all

Entonces agregue los IDs de parche 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

Ejecutan los parches de paquete antes de sync y updateEjecutan los parches de proyecto nativo después de sync y update.

Hacer una prueba seca antes de aplicar

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

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

Usar apply cuando desee ejecutar los parches seleccionados manualmente:

npx capgo-capacitor-patch apply --phase package

Opciones de configuración

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

Consejo

Preferir explícito patches para aplicaciones de producción para que los arreglos aplicados sean visibles en la revisión code.

comandos CLI

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 qué fase de parcheo se ejecuta.
• --platform ios|android aplica la filtración de plataforma fuera de un Capacitor hook.
• --strict trata las fallas de parches 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/cliel parche se aplica al paquete instalado CLI y el siguiente cap comando utiliza el parcheado CLI code.

Sigue adelante desde Inicio

Si estás utilizando Getting Started para planificar el trabajo de plugin nativo, conecta 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.