Comenzar

Instalar

Puedes utilizar nuestra configuración asistida por IA para instalar el plugin. Agrega las Capgo habilidades a tu herramienta de IA utilizando el siguiente comando:

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

Luego utiliza el siguiente prompt:

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

Si prefieres la configuración manual, instala el plugin ejecutando los siguientes comandos y sigue 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 selecciones parches en tu configuración Capacitor.

Seleccionar IDs de parche

Lista de todos los parches embarcados:

npx capgo-capacitor-patch list --all

Luego agrega los IDs de parche que tu aplicación necesita 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;

Ejecuta sincronización nuevamente:

npx cap sync

Ejecutan parches de paquetes antes de sync y updateEjecutan parches de proyectos nativos 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 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[]	[]	Salta los IDs de parche seleccionados, incluso cuando están recomendados.
strict	boolean	false	Lanza una excepción 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 de code.

comandos de 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 a qué fase de parcheo se ejecuta.
• --platform ios|android aplica el filtrado de plataforma fuera de un Capacitor hook.
• --strict trata las fallas de parches seleccionadas como errores.

Flujo de trabajo

1. Sección titulada “Flujo de trabajo” @capgo/capacitor-patch.
2. Instalar npx capgo-capacitor-patch list --all.
3. Ejecutar plugins.CapacitorPatch.patches.
4. Agregar los IDs de parche seleccionados a npx capgo-capacitor-patch doctor --strict.
5. Ejecutar npx cap sync.

Ejecutar @capacitor/cli, the patch applies to the installed CLI package and the next cap command uses the patched CLI code.

comando utiliza el parcheado __CAPGO_KEEP_0__ __CAPGO_KEEP_1__.

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.