Inicio rápido

Instalar

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. 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 Capacitor configuración.

Seleccione IDs de parches

Lista de todos los parches embarcados:

npx capgo-capacitor-patch list --all

Agregue luego los IDs de parches que necesita su aplicación 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

Paquetes de parches se ejecutan antes sync E y updateProyectos nativos parchean después sync E y update.

Realiza un simulacro 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	Default	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 cuando una 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.

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 parcheo 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 instalado CLI y el siguiente cap El comando utiliza el paquete CLI code parcheado.

Siga adelante desde Getting Started

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