Getting Started

Copy sebuah prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-patch`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/capacitor-patch/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Instalasi

Anda dapat menggunakan Pengaturan Bantuan AI kami untuk menginstal plugin. Tambahkan Capgo kemampuan ke alat AI Anda menggunakan perintah berikut:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Lalu gunakan prompt berikut:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-patch` plugin in my project.

Jika Anda lebih suka Pengaturan Manual, instal plugin dengan menjalankan perintah-perintah berikut dan ikuti instruksi spesifik platform di bawah ini:

npm install @capgo/capacitor-patch
npx cap sync

Paket ini tidak berfungsi sampai Anda memilih patch di konfigurasi Capacitor Anda.

Pilih ID patch

Tampilkan semua patch yang dikirim:

npx capgo-capacitor-patch list --all

Lalu tambahkan ID patch yang diperlukan aplikasi Anda 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;

Jalankan sync lagi:

npx cap sync

Paket patch dijalankan sebelum sync dan update. Projek native diperbaiki setelahnya sync dan update.

Sebelum menerapkan, lakukan simulasi

Gunakan doctor untuk memeriksa apakah patch yang dipilih sesuai dengan versi paket yang terinstal:

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

Gunakan apply ketika Anda ingin menjalankan patch yang dipilih secara manual:

npx capgo-capacitor-patch apply --phase package

Pilihan konfigurasi

Pilihan	Tipe	Nilai default	Deskripsi
`recommended`	`boolean`	`false`	Mengaplikasikan patch Capgo sebagai yang direkomendasikan.
`patches`	`string[]`	`[]`	Mengaplikasikan ID patch eksplisit.
`disabled`	`string[]`	`[]`	Mengabaikan ID patch yang dipilih, bahkan ketika direkomendasikan.
`strict`	`boolean`	`false`	Mengeluarkan kesalahan ketika patch yang dipilih tidak kompatibel atau tidak dapat diterapkan.

Judul bagian “CLI perintah”

npx capgo-capacitor-patch list --all
npx capgo-capacitor-patch doctor
npx capgo-capacitor-patch apply

Mengatur root aplikasi.

--root <dir> Mengatur fase patch mana yang berjalan.
--phase package|native|all Mengatur penyaringan platform di luar hook __CAPGO_KEEP_0__.
--platform ios|android applies platform filtering outside a Capacitor hook.
--strict Alur kerja

__CAPGO_KEEP_0__

Pasang @capgo/capacitor-patch.
Jalankan npx capgo-capacitor-patch list --all.
Tambahkan ID patch yang dipilih ke plugins.CapacitorPatch.patches.
Jalankan npx capgo-capacitor-patch doctor --strict.
Jalankan npx cap sync.

Ketika patch yang dipilih menargetkan @capacitor/cli, patch tersebut berlaku untuk paket CLI yang terpasang dan paket selanjutnya cap command uses the patched CLI code.

Bagian berjudul “Lanjutkan dari Getting Started”

Install Mulai Berlari untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-patch untuk kemampuan native di Menggunakan @capgo/capacitor-patch, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin-Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin-Plugin Capacitor oleh Capgo, Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, dan Alternatif Plugin Enterprise Ionic untuk alur kerja produk di Alternatif Plugin Enterprise Ionic.