Mulai Dengan Cara Ini

Salin prompt pengaturan dengan langkah-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 Bantu 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

Daftar semua patch yang dikirim:

npx capgo-capacitor-patch list --all

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

Patch paket berjalan sebelum sync dan update. Patch proyek native berjalan setelah sync dan update.

Melakukan simulasi sebelum menerapkan

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

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

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

npx capgo-capacitor-patch apply --phase package

Pilihan konfigurasi

Pilihan	Jenis	Default	Deskripsi
`recommended`	`boolean`	`false`	Mengaplikasikan patch Capgo sebagai yang direkomendasikan.
`patches`	`string[]`	`[]`	Mengaplikasikan ID patch yang 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 diaplikasikan.

CLI perintah

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

Opsi yang berguna:

--root <dir> menetapkan root aplikasi.
--phase package|native|all mengatur fase patch mana yang berjalan.
--platform ios|android menerapkan penyaringan platform di luar Capacitor hook.
--strict menganggap gagalannya patch yang dipilih sebagai kesalahan.

Alur

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

patch ini berlaku untuk paket __CAPGO_KEEP_0__ yang terpasang dan langkah berikutnya menggunakan __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ yang telah diperbaiki. @capacitor/cli, the patch applies to the installed CLI package and the next cap command uses the patched CLI code.

Pasang

Jika Anda menggunakan Getting Started untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-patch untuk kemampuan native di Menggunakan @capgo/capacitor-patch, Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin, Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, dan Alternatif Plugin Bisnis Ionic Enterprise untuk alur kerja produk di Alternatif Plugin Bisnis Ionic Enterprise.