Getting Started

Copiar 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

Puedes utilizar nuestra configuración asistida por inteligencia artificial para instalar el complemento. Agrega las Capgo habilidades a tu herramienta de inteligencia artificial 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 agrega los IDs de parche que necesita tu 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;

Ejecuta sincronización nuevamente:

npx cap sync

Los parches de paquete se ejecutan antes de sync y update. Proyectos nativos parchean después de sync y update.

Antes de aplicar, pruebe

Usar doctor para verificar si los parches seleccionados coinciden con las versiones de paquete instaladas:

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

Usar apply cuando quieras ejecutar manualmente los parches seleccionados:

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.

comandos 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 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

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 utiliza el parcheado CLI code.

Sigue adelante desde Inicio

Si estás utilizando Iniciación 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 Alternativas de Plugins de Ionic Enterprise.