Empezar

Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa 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

npm install @capgo/capacitor-patch
npx cap sync

El paquete es de uso hasta que selecciones parches en tu configuración Capacitor.

Seleccionar IDs de parches

Listar todos los parches embarcados:

npx capgo-capacitor-patch list --all

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

Run sync again:

npx cap sync

Se ejecutan parches de paquete antes de sync y update. Se ejecutan parches de proyecto nativo después de sync y update.

Antes de aplicar, se ejecuta en modo sin 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 las parches seleccionadas:

npx capgo-capacitor-patch apply --phase package

opciones de configuración

Tipo	Valor por defecto	Descripción	Aplica parches __CAPGO_KEEP_0__ como recomendados.
`recommended`	`boolean`	`false`	Applies patches Capgo marks as recommended.
`patches`	`string[]`	`[]`	Aplica IDs de parches explícitos.
`disabled`	`string[]`	`[]`	Saltar IDs de parches seleccionados, incluso cuando se recomiendan.
`strict`	`boolean`	`false`	Lanza una excepción cuando un parche 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 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

Instalar @capgo/capacitor-patch.
Ejecutar npx capgo-capacitor-patch list --all.
Agregar los IDs de parcheo seleccionados a plugins.CapacitorPatch.patches.
Ejecutar npx capgo-capacitor-patch doctor --strict.
Ejecutar npx cap sync.

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

Sigue adelante desde Getting Started

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.