Per iniziare

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.

Installa

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

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

Poi usa 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 questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

npm install @capgo/capacitor-patch
npx cap sync

Il pacchetto è un no-op finché non selezioni le patch nella tua config Capacitor.

Avvio rapido

bun add @capgo/capacitor-patch
npx cap sync

Errori comuni

Controlla i version gates prima di aggiornare Capacitor.
Installa in CI prima di cap sync.
Rilancia la sync dopo modifiche native.

Seleziona gli ID delle patch

Elenca tutte le patch rilasciate:

npx capgo-capacitor-patch list --all

Aggiungi quindi gli ID delle patch necessarie alla tua app 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;

Esegui di nuovo sync:

npx cap sync

Le patch dei pacchetti vengono eseguite prima sync e update. Native project patches run after sync e update.

Dry-run prima di applicare

Usa doctor per verificare se le patch selezionate corrispondono alle versioni dei pacchetti installati:

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

Usa apply quando si desidera eseguire manualmente le patch selezionate:

npx capgo-capacitor-patch apply --phase package

Opzioni di configurazione

Opzione	Tipo	Predefinito	Descrizione
`recommended`	`boolean`	`false`	Applica i patch che Capgo segna come consigliati.
`patches`	`string[]`	`[]`	Applica ID di patch espliciti.
`disabled`	`string[]`	`[]`	Ignora gli ID di patch selezionati, anche se consigliati.
`strict`	`boolean`	`false`	Genera un errore se un patch selezionato è incompatibile o non può essere applicato.

comandi CLI

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

Opzioni utili:

--root <dir> imposta la root dell'app.
--phase package|native|all limita quale fase della patch viene eseguita.
--platform ios|android applica il filtro per piattaforma fuori da un hook Capacitor.
--strict considera come errori i fallimenti delle patch selezionate.

Workflow

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

Quando un patch selezionato ha come target @capacitor/cli, il patch viene applicato al pacchetto CLI installato e al successivo cap il comando utilizza il CLI code patchato.

Continua da Getting Started

Se stai usando Per iniziare per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-patch per la funzionalità nativa in Usare @capgo/capacitor-patch, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.