Saltar al contenido principal
Volver a plugins
@capgo/capacitor-patch
Tutoría
por github.com/Cap-go

Capacitor Parche

Aplicar parches de versión Capacitor core, CLI, plugin y proyecto nativo durante la sincronización y actualización de Cap

Guía

Tutorial sobre Capacitor Patch

Usando @capgo/capacitor-patch

Aplicar las correcciones seleccionadas de Capacitor desde un catálogo de parches versionado durante cap sync y cap update.

Instalar

npm install @capgo/capacitor-patch
npx cap sync

Listar parches disponibles

npx capgo-capacitor-patch list --all

El catálogo incluye IDs de parches, paquetes objetivo, versiones de Capacitor compatibles y enlaces hacia PRs de upstream de Capacitor.

Seleccionar parches en Capacitor config

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;

Prueba en modo seco y sincronización

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

Parches de paquete se ejecutan antes sync y updateParches de proyecto nativo se ejecutan después sync y update.

Configuración

  • patches - IDs de parche explícitos para aplicar.
  • recommended - Aplicar parches con Capgo marcados como recomendados.
  • disabled - Saltar un ID de parche seleccionado.
  • strict - Fallar cuando un parche seleccionado es incompatible o no se puede aplicar.

Referencia Completa