Avvio

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

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

npx cap sync

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

Eseguire un dry-run prima di applicare

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

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

Usare 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 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.

Consiglio

Preferire esplicito patches per le app di produzione in modo che le correzioni applicate siano visibili nella code revisione.

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

Flusso di lavoro

1. Sottosezione intitolata “Flusso di lavoro” @capgo/capacitor-patch.
2. Installa npx capgo-capacitor-patch list --all.
3. Esegui plugins.CapacitorPatch.patches.
4. Aggiungi gli ID delle patch selezionate a npx capgo-capacitor-patch doctor --strict.
5. 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.

il comando successivo utilizza il pacchetto __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ patchato.

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