Avvio

Installa

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 la configurazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche del tuo platform sotto:

npm install @capgo/capacitor-patch
npx cap sync

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

Seleziona gli ID delle patch

Elencare tutte le patch spedite:

npx capgo-capacitor-patch list --all

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

npx cap sync

Le patch dei pacchetti vengono eseguite prima sync e updateLe patch dei progetti nativi vengono eseguite dopo sync e update.

Esecuzione in modalità dry-run 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 marche Capgo come raccomandate.
patches	string[]	[]	Applica ID di patch esplicite.
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.

Consiglio

Preferisci esplicite patches per applicazioni in 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 per piattaforma al di fuori di un Capacitor hook.
• --strict tratta le fallite di patch selezionate come errori.

Ciclo di lavoro

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

Quando una patch selezionata mira a @capacitor/cli, la patch si applica al pacchetto CLI installato e al successivo cap command utilizza il pacchetto CLI code patchato.

Continua da Inizia

Se stai utilizzando Inizia per pianificare il lavoro del plugin nativo, connettilo con Utilizzare @capgo/capacitor-patch per la capacità nativa in Utilizzare @capgo/capacitor-patch, Capgo Directory dei plugin per il flusso di lavoro del prodotto in Capgo Directory dei plugin, Capacitor Plugin da Capgo per il 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 per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise Ionic.