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

Usa poi 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 qui 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 ID di patch

Elencare tutti i patch spediti:

npx capgo-capacitor-patch list --all

Inserisci 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

I pacchetti patch vengono eseguiti prima di 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 marche Capgo come raccomandate.
patches	string[]	[]	Applica ID di patch esplicite.
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

Preferisce esplicito patches per le applicazioni 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 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 selezionate 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 comando utilizza il pacchetto CLI code patchato.

Continua da Inizia

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 il dettaglio di implementazione in Plugin Capacitor sviluppati da Capgo, Aggiunta o Aggiornamento dei Plugin per il 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.