Avvio rapido

Copia un prompt di configurazione con le istruzioni di installazione e la guida markdown completa per questo 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.

Installa

npm install @capgo/capacitor-patch
npx cap sync

Il pacchetto è un no-op fino a quando non selezioni le patch nel tuo Capacitor config.

Seleziona gli ID delle patch

Elenco di tutte le patch spedita:

npx capgo-capacitor-patch list --all

Poi aggiungi gli ID delle patch che il tuo app ha bisogno di 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;

Eseguisci sync nuovamente:

npx cap sync

I patch dei pacchetti vengono eseguiti prima sync e updateI patch del progetto nativo vengono eseguiti dopo sync e update.

Esecuzione in modalità di prova prima di applicare

Usa doctor per verificare se i patch selezionati corrispondono alle versioni dei pacchetti installati:

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

Usa apply quando desideri eseguire manualmente le patch selezionate:

npx capgo-capacitor-patch apply --phase package

Opzioni di configurazione

Opzione	Tipo	Predefinito	Descrizione
`recommended`	`boolean`	`false`	Applica le patch con Capgo segnate come raccomandate.
`patches`	`string[]`	`[]`	Applica gli ID delle patch esplicite.
`disabled`	`string[]`	`[]`	Svuota gli ID delle patch selezionate, anche quando raccomandate.
`strict`	`boolean`	`false`	Lancia un errore quando una patch selezionata è incompatibile o non può essere applicata.

CLI comandi

npx capgo-capacitor-patch list --all
npx capgo-capacitor-patch doctor
npx capgo-capacitor-patch apply

Opzioni utili:

--root <dir> imposta la radice dell'app.
--phase package|native|all limita la fase di patch che esegue.
--platform ios|android applica la filtrazione del sistema operativo fuori da un Capacitor hook.
--strict tratta le fallite di patch selezionate come errori.

Flusso di lavoro

Installare @capgo/capacitor-patch.
Eseguire npx capgo-capacitor-patch list --all.
Aggiungi gli ID delle patch selezionate a plugins.CapacitorPatch.patches.
Eseguire npx capgo-capacitor-patch doctor --strict.
Eseguire npx cap sync.

Quando una patch selezionata mira a @capacitor/cli, la patch si applica al pacchetto CLI installato e al successivo cap il comando utilizza il patch CLI code.

Continua da Getting Started

Se stai utilizzando Getting Started per pianificare il lavoro di plugin nativo, connettilo con Utilizza @capgo/capacitor-patch per la capacità nativa in Utilizza @capgo/capacitor-patch, Directory dei Plugin Capgo per il flusso di lavoro del prodotto in Directory dei Plugin Capgo, Plugin Capacitor di Capgo per la dettaglio di implementazione in Plugin Capacitor di Capgo, Aggiungere o Aggiornare Plugin per la dettagliata implementazione in Aggiungere o Aggiornare Plugin, e Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise Ionic.