Inizia a utilizzare

Installazione

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 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 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à di prova prima dell'applicazione

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	Impostazione predefinita	Descrizione
recommended	boolean	false	Applica patch Capgo con marchio di raccomandazione.
patches	string[]	[]	Applica patch ID esplicito.
disabled	string[]	[]	Ssaltare ID di patch selezionati, anche quando raccomandati.
strict	boolean	false	Lancia un errore quando un patch selezionato è incompatibile o non può essere applicato.

Suggerimento

Preferisci 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'app.
• --phase package|native|all limita la fase di patch che esegue.
• --platform ios|android applica la filtrazione per piattaforma fuori da un hook Capacitor.
• --strict tratta le fallite di patch selezionate come errori.

Flusso di lavoro

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

Quando un patch selezionato mira a @capacitor/cli, il patch si applica al pacchetto CLI installato e al successivo cap command uses the patched CLI code.