Getting Started

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 una operación sin efecto hasta que seleccione parches en su configuración de Capacitor.

Selecciona IDs de parches

Lista de parches enviados:

npx capgo-capacitor-patch list --all

Luego agrega los IDs de parches que necesita tu 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;

Ejecuta sincronización nuevamente:

npx cap sync

Parches de paquete se ejecutan antes de sync y update. Proyecto nativo parches corren después sync y update.

Dry-run antes de aplicar

Use doctor verificar si las actualizaciones seleccionadas coinciden con las versiones de paquete instaladas

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

Use apply cuándo quieras 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 están recomendados.
strict	boolean	false	Lanza un error cuando una parche seleccionado es incompatible o no se puede aplicar.

Ayuda

Prefer explícito patches para aplicaciones de producción de modo 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 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. Para instalar el parche de Capacitor, sigue estos pasos: plugins.CapacitorPatch.patches.
4. Ejecutar npx capgo-capacitor-patch doctor --strict.
5. Ejecutar npx cap sync.

Agrega los IDs de parche seleccionados a @capacitor/clila actualización de parche se aplica al paquete instalado CLI y al siguiente cap El comando utiliza la versión parcheada CLI code.

El comando utiliza el paquete __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ con parches.

Si estás utilizando Getting Started 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 Capgo para el flujo de trabajo del producto en Directorio de Plugins 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 Ionic Enterprise Para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternativas.