Inizia

Copia una richiesta di configurazione con i passaggi 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.

Installazione

npm install @capgo/capacitor-patch
npx cap sync

Il pacchetto è un no-op fino a quando non selezioni le patch nella tua configurazione Capacitor.

Seleziona ID di patch

Elencare tutti i patch spediti:

npx capgo-capacitor-patch list --all

Inserisci quindi gli ID di patch che il tuo app necessita 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;

Esegui nuovamente la sincronizzazione:

npx cap sync

I pacchetti patch vengono eseguiti prima di sync e update. Progetti nativi patch vengono eseguiti dopo sync e update.

Esecuzione secca prima di applicare

Usa doctor per verificare se le patch selezionate corrispondono alle versioni del pacchetto installato:

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 Capgo come raccomandate.
`patches`	`string[]`	`[]`	Applica gli ID delle patch esplicite.
`disabled`	`string[]`	`[]`	Salta gli ID delle patch selezionati, anche quando raccomandati.
`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'applicazione.
--phase package|native|all limita la fase di patch che esegue.
--platform ios|android applica il filtro per piattaforma al di fuori di un Capacitor hook.
--strict tratta le fallite di patch selezionate come errori.

Ciclo di lavoro

Installa @capgo/capacitor-patch.
Esegui npx capgo-capacitor-patch list --all.
Aggiungi gli ID delle patch selezionati a plugins.CapacitorPatch.patches.
Esegui npx capgo-capacitor-patch doctor --strict.
Esegui npx cap sync.

Quando una patch selezionata si applica a @capacitor/clila patch si applica al pacchetto CLI installato e al successivo cap command uses the patched CLI code.

Sezione intitolata “Continua da Iniziare”

Installa Avvio per pianificare il lavoro di plugin nativo, connettilo con Utilizzo di @capgo/capacitor-patch per la capacità nativa in Utilizzo di @capgo/capacitor-patch, Directory dei Plugin Capgo per il flusso di lavoro del prodotto in Directory dei Plugin Capgo, I Plugin Capacitor di Capgo per il dettaglio di implementazione in I Plugin Capacitor di Capgo, Aggiunta o Aggiornamento dei Plugin per il dettaglio di implementazione in Aggiunta o Aggiornamento dei Plugin, e Sostituti dei Plugin Enterprise di Ionic per il flusso di lavoro del prodotto in Sostituti dei Plugin Enterprise di Ionic.