Mulai Sekarang

Salin 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 Bantu AI 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 aplikasi Anda butuhkan 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

Paket patch berjalan sebelum sync dan updatePaket patch asli berjalan setelah sync dan update.

Melakukan simulasi sebelum menerapkan

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

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

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

npx capgo-capacitor-patch apply --phase package

Opsi pengaturan

Pilihan	Jenis	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 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 batasan fase patch yang berjalan.
--platform ios|android menerapkan penyaringan platform di luar sebuah Capacitor hook.
--strict menganggap gagalannya patch yang dipilih sebagai kesalahan.

Alur Kerja

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 mengarahkan ke @capacitor/cli, patch tersebut berlaku untuk paket yang diinstal CLI dan langkah berikutnya cap Jalankan perintah menggunakan CLI yang telah diperbaiki code.

Teruskan dari Getting Started

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 dalam Alternatif Plugin Bisnis Ionic Enterprise.