Avvio

Copia un prompt 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

Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Poi utilizza il seguente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-patch` plugin in my project.

Se preferisci la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito:

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 spedite:

npx capgo-capacitor-patch list --all

Aggiungi quindi 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 di nuovo:

npx cap sync

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

Esegui in modo secco prima di applicare

Usa doctor per verificare se i patch selezionati corrispondono alle versioni del pacchetto installato:

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

Usa apply quando desideri eseguire manualmente i patch selezionati:

npx capgo-capacitor-patch apply --phase package

Opzioni di configurazione

Opzione	Tipo	Predefinito	Descrizione
`recommended`	`boolean`	`false`	Applica patch Capgo con il marchio di raccomandazione.
`patches`	`string[]`	`[]`	Applica ID di patch espliciti.
`disabled`	`string[]`	`[]`	Salta gli ID di patch selezionati, anche quando raccomandati.
`strict`	`boolean`	`false`	Lancia un errore quando un patch selezionato è incompatibile o non può essere applicato.

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 il filtro di piattaforma al di fuori di un Capacitor hook.
--strict gestisce le fallite delle patch selezionate come errori.

Flusso di lavoro

Sezione intitolata “Flusso di lavoro” @capgo/capacitor-patch.
Installa npx capgo-capacitor-patch list --all.
Esegui plugins.CapacitorPatch.patches.
Aggiungi gli ID delle patch selezionate a npx capgo-capacitor-patch doctor --strict.
Esegui npx cap sync.

Esegui @capacitor/cli, the patch applies to the installed CLI package and the next cap command uses the patched CLI code.

Continua da Iniziare

Se stai utilizzando Inizia per pianificare il lavoro sui plugin nativi, connettilo con Utilizzando @capgo/capacitor-patch per la capacità nativa in Utilizzando @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 i Plugin per la dettaglio di implementazione in Aggiungere o Aggiornare i Plugin, e Alternative plugin Ionic Enterprise per il workflow del prodotto in Alternative plugin Ionic Enterprise