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 del 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

Luego 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 paquetes antes de sync y updateEjecutan los 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 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 parches explícitos.
disabled	string[]	[]	Saltar IDs de parches seleccionados, incluso cuando son recomendados.
strict	boolean	false	Arroja un error 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.

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 a 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. 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.