Inicio

Copie una solicitud de configuración con los pasos de instalación y la guía de markdown completa para este complemento.

        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 utilizar nuestra configuración asistida por IA para instalar el complemento. Agrega las Capgo habilidades a tu herramienta de IA utilizando el siguiente comando:

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

Luego utiliza 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 complemento ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:

npm install @capgo/capacitor-patch
npx cap sync

El paquete es de no-op hasta que selecciones parches en tu configuración de Capacitor.

Selecciona IDs de parches

Listar todos los parches enviados:

npx capgo-capacitor-patch list --all

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

Los parches de paquete se ejecutan antes sync y updateLos parches de proyecto nativo se ejecutan después sync y update.

Prueba en modo sin 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 los parches seleccionados manualmente:

npx capgo-capacitor-patch apply --phase package

Opciones de configuración

Opción	Tipo	Valor 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`	Lanza una excepción cuando un parche seleccionado es incompatible o no se puede aplicar.

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 parcheo que 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 parche seleccionados a plugins.CapacitorPatch.patches.
Ejecutar npx capgo-capacitor-patch doctor --strict.
Ejecutar npx cap sync.

Cuando un parche seleccionado apunta a @capacitor/cli, el parche se aplica al paquete CLI instalado y al siguiente cap command uses the patched CLI code.

Sección titulada “Continuar desde Getting Started”

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