Getting Started

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 da AI per installare il plugin. Aggiungi le Capgo competenze al tuo strumento AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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

Se preferisci l'installazione 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 nella tua Capacitor configurazione.

Scegli gli ID delle patch

npx capgo-capacitor-patch list --all

Aggiungi poi gli ID delle 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;

Eseguisci nuovamente la sincronizzazione:

npx cap sync

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

Esegui un test senza applicare modifiche

Use doctor verificare se le patch selezionate corrispondono alle versioni del pacchetto installate

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

Use apply Esegui un dry-run prima di applicare

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'eccezione 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'applicazione.
--phase package|native|all limita la fase di patch che esegue.
--platform ios|android applica il filtro per piattaforma fuori da 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.
Se il patch selezionato si concentra su plugins.CapacitorPatch.patches.
Esegui npx capgo-capacitor-patch doctor --strict.
Esegui npx cap sync.

Quando un patch selezionato si concentra su @capacitor/clila patch si applica al pacchetto CLI installato e al successivo cap il comando utilizza la patch CLI code.

Keep going from Getting Started

Se stai utilizzando Getting Started 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 workflow del prodotto nella directory del plugin Capgo Plugin Capacitor di Capgo per il dettaglio di implementazione in 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 Ionic per il flusso di lavoro del prodotto in Sostituti dei Plugin Enterprise Ionic.