Tunggu tidak perlu

Copy 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

Kamu bisa menggunakan Setup Bantuan AI untuk menginstal plugin. Tambahkan Capgo kemampuan ke alat AI kamu 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 kamu lebih suka Setup 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 kamu memilih patch di konfigurasi Capacitor kamu.

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

Paket patch dijalankan sebelum sync dan updateProyek native diperbaiki setelah sync dan update.

Melakukan tes kering 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

Pilihan Konfigurasi

Pilihan	Jenis	context	Description
`recommended`	`boolean`	`false`	Menerapkan patch Capgo menandai sebagai yang direkomendasikan.
`patches`	`string[]`	`[]`	Menerapkan ID patch eksplisit.
`disabled`	`string[]`	`[]`	Mengaplikasikan patch __CAPGO_KEEP_0__ sebagai yang direkomendasikan.
`strict`	`boolean`	`false`	Throws when a selected patch is incompatible or cannot apply.

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 hook Capacitor.
--strict menganggap gagal patch yang dipilih sebagai kesalahan.

Alur Kerja

Instal @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 mengarah ke @capacitor/cli, patch ini berlaku untuk paket CLI yang terpasang dan yang berikutnya cap perintah menggunakan patch CLI code.

Teruskan dari Getting Started

Bagian berjudul “Teruskan dari Getting Started” Mulai Berjalan untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-patch untuk kemampuan native di Menggunakan @capgo/capacitor-patch, Daftar Direktori Plugin Capgo untuk alur kerja produk di Daftar 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.