Primeros pasos

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-patch`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/capacitor-patch/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Instalar

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

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

Luego usa 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 estos comandos y sigue las instrucciones de cada plataforma:

npm install @capgo/capacitor-patch
npx cap sync

El paquete no hace nada hasta que selecciones parches en tu configuración de Capacitor.

Inicio rápido

bun add @capgo/capacitor-patch
npx cap sync

Errores comunes

Revisa las puertas de versión antes de actualizar Capacitor.
Instálalo en CI antes de cap sync.
Vuelve a ejecutar sync tras editar el código nativo.

Selecciona IDs de parche

Lista todos los parches publicados:

npx capgo-capacitor-patch list --all

Luego, añade los patch IDs que tu app necesite 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 sync de nuevo:

npx cap sync

Los parches de paquetes se ejecutan antes de sync y update. Native project patches run after sync y update.

Dry-run antes de aplicar

Usa doctor para verificar si los parches seleccionados coinciden con las versiones de paquetes instalados:

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

Usa apply cuando quieras 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 los parches que Capgo marca como recomendados.
`patches`	`string[]`	`[]`	Aplica identificadores de parche explícitos.
`disabled`	`string[]`	`[]`	Omite los IDs de parche seleccionados, incluso si se recomiendan.
`strict`	`boolean`	`false`	Lanza un error si el patch seleccionado es incompatible o no se puede aplicar.

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 app.
--phase package|native|all limita qué fase del patch se ejecuta.
--platform ios|android aplica el filtrado por plataforma fuera de un hook de Capacitor.
--strict trata los fallos de patch seleccionados como errores.

Flujo de trabajo

Instalar @capgo/capacitor-patch.
Ejecuta npx capgo-capacitor-patch list --all.
Añade los IDs de patch seleccionados a plugins.CapacitorPatch.patches.
Ejecuta npx capgo-capacitor-patch doctor --strict.
Ejecuta npx cap sync.

Cuando un patch seleccionado apunta a @capacitor/cli, el patch se aplica al paquete CLI instalado y el siguiente cap comando usa el CLI code parcheado.

Continúa desde Getting Started

Si estás usando Primeros pasos para planificar el trabajo con plugins nativos, conéctalo con Uso de @capgo/capacitor-patch para la capacidad nativa en Usando @capgo/capacitor-patch, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.