Getting Started

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

Puede utilizar nuestra configuración asistida por inteligencia artificial para instalar el complemento. Agregue las Capgo habilidades a su herramienta de inteligencia artificial 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 del plataforma a continuación:

npm install @capgo/capacitor-patch
npx cap sync

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

Seleccione IDs de parches

Listar todos los parches enviados:

npx capgo-capacitor-patch list --all

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

Ejecutar sincronización nuevamente:

npx cap sync

Los parches de paquete se ejecutan antes de sync y update. Proyecto nativo parches ejecutan 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 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 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/cliel parche se aplica al paquete CLI instalado y al siguiente cap command uses the patched CLI code.

Sección titulada “Continuar desde Inicio”

Si estás utilizando Empezar para planificar el trabajo de plugin nativo, conectarlo con Usando @capgo/capacitor-patch para la capacidad nativa en Usando @capgo/capacitor-patch, Directorio de Plugin de Capgo para el flujo de trabajo del producto en Directorio de Plugin de 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 Empresa de Ionic para el flujo de trabajo del producto en Alternativas de Plugins de Empresa de Ionic.