Langsung ke konten

@capgo/capacitor-patch

Terapkan perbaikan yang telah diverifikasi ke paket inti Capacitor, CLI, plugin, dan proyek native saat sync dan update hooks.

@capgo/capacitor-patch adalah paket Capacitor berbasis hook yang menerapkan file patch tertentu setiap kali Capacitor dijalankan sync atau update.

Dibangun untuk perbaikan yang berguna sebelum masuk ke rilis resmi Capacitor. Katalog yang dibundel melacak PR Capacitor upstream eksternal yang dicerminkan oleh Capacitor+ sync/upstream-pr-* cabang.

PlatformDukunganCatatan
iOSHookcap sync patches
AndroidHookcap sync patches
WebN/Ahanya CLI

paket Capacitor

Patch @capacitor/core, @capacitor/android, @capacitor/ios, serta plugin Capacitor pihak ketiga di bawah node_modules.

Capacitor CLI

Patch mengirimkan file JavaScript CLI. Saat patch CLI diterapkan, perintah cap berikutnya menggunakan code yang sudah di-patch.

Proyek native

Terapkan patch proyek Android atau iOS yang dihasilkan setelah cap sync atau cap update.

Pemilihan aman

Rentang versi, pengecekan idempotensi, dan strict mode membantu mencegah patch usang diterapkan tanpa disadari.

Patch bersifat opt-in secara default. Lihat katalog yang disertakan, pilih ID patch yang dibutuhkan app Anda, lalu tambahkan ke plugins.CapacitorPatch.patches.

Setiap entri katalog mencakup:

  • ID patch yang stabil
  • target package atau fase native project
  • rentang versi yang didukung
  • PR Capacitor upstream
  • branch sync Capacitor+ yang sesuai
  • file patch yang disertakan dalam package

Gunakan @capgo/capacitor-patch saat:

  • perbaikan Capacitor sudah ada di upstream tapi belum dirilis
  • aplikasi Anda butuh perbaikan tersebut tanpa harus mengelola script patch lokal
  • Anda ingin patch diterapkan ulang setiap kali Capacitor sync/update
  • Anda butuh katalog perbaikan yang mudah dibaca tim untuk patch yang diandalkan aplikasi Anda

Untuk katalog lengkap dan panduan kontribusi, lihat repositori capacitor-patch.

Jika Anda menggunakan @capgo/capacitor-patch untuk merencanakan pekerjaan plugin native, hubungkan 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 Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.