Getting Started

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 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 del tuo platform 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.

Seleziona ID di patch

Elencare tutti i patch spediti:

npx capgo-capacitor-patch list --all

Poi aggiungi 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 sincronizzazione nuovamente:

npx cap sync

Il pacchetto di patch esegue prima sync e update. Progetti nativi patch vengono eseguiti dopo sync e update.

Esecuzione di 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

Impostazioni di configurazione

Opzione	Tipo	Predefinito	Descrizione
recommended	boolean	false	Applica marchi Capgo come raccomandati.
patches	string[]	[]	Applica ID di patch espliciti.
disabled	string[]	[]	Ssaltare gli ID di patch selezionati, anche quando raccomandati.
strict	boolean	false	Lancia un errore quando una patch selezionata è incompatibile o non può essere applicata.

Suggerimento

Prefer esplicito per le app di produzione in modo che le correzioni applicate siano visibili nella __CAPGO_KEEP_0__ revisione. 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 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 uses the patched CLI code.

Sezione intitolata “Continua da Iniziare”

Se stai utilizzando Inizio 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 flusso di lavoro del prodotto in Directory dei Plugin Capgo, Plugin Capacitor sviluppati da Capgo per la dettaglio di implementazione in Plugin Capacitor sviluppati da Capgo, Aggiunta o Aggiornamento dei Plugin per la dettaglio di implementazione in Aggiunta o Aggiornamento dei Plugin, e Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto in Alternative per Plugin Enterprise Ionic.