@capgo/capacitor-pembaruan

Juga tersedia untuk Cordova dan Electron

Capgo pembaruan hidup tidak terbatas pada Capacitor. Gunakan backend yang sama dan CLI dengan plugin klien saudara:

Pembaruan Cordova Pembaruan OTA untuk Cordova iOS 7+ dan Android 13+.

Pembaruan Electron Pembaruan desktop dengan API yang sama.

Ringkasan

Live update untuk aplikasi capacitor.

Fungsi Utama

• notifyAppReady - Perluas lapisan native bahwa JavaScript telah berjalan dengan sukses.
• setUpdateUrl - Atur URL pembaruan untuk aplikasi secara dinamis pada waktu runtime.
• setStatsUrl - Atur URL statistik untuk aplikasi secara dinamis pada waktu runtime.
• setChannelUrl - Atur URL saluran untuk aplikasi secara dinamis pada waktu runtime.

Publik API

Metode	Deskripsi
notifyAppReady	Perluas lapisan native bahwa JavaScript telah berjalan dengan sukses.
setUpdateUrl	Atur URL pembaruan untuk aplikasi secara dinamis pada waktu runtime.
setStatsUrl	Atur URL statistik untuk aplikasi secara dinamis pada waktu runtime.
setChannelUrl	Set URL kanal aplikasi secara dinamis pada saat runtime.
download	Unduh bundle baru dari URL yang disediakan untuk instalasi nanti.
next	Setel bundle berikutnya yang akan diaktifkan ketika aplikasi berlatar belakang atau restart.
set	Setel bundle saat ini dan muat ulang aplikasi secara langsung.
delete	Hapus bundle dari penyimpanan lokal untuk menghemat ruang disk.
setBundleError	Mark bundle secara manual sebagai gagal/terjadi kesalahan dalam mode update manual.
list	Dapatkan semua bundle yang diunduh secara lokal yang disimpan di aplikasi Anda.
reset	Reset aplikasi ke bundle yang diketahui baik.
current	Dapatkan informasi tentang bundle yang aktif saat ini.
reload	Muat ulang aplikasi secara manual untuk menerapkan update yang tertunda.
setMultiDelay	Konfigurasi kondisi yang harus dipenuhi sebelum update yang tertunda diterapkan.
cancelDelay	Batalkan semua kondisi delay dan terapkan update yang tertunda secara langsung.
getLatest	Periksa server pembaruan untuk versi bundle terbaru yang tersedia.
setChannel	Setel saluran pembaruan runtime lokal untuk perangkat ini. Ini tidak membuat override dashboard/API perangkat.
unsetChannel	Hapus pengaturan saluran perangkat dan kembali ke saluran default.
getChannel	Ambil saluran yang saat ini ditetapkan untuk perangkat ini.
listChannels	Dapatkan daftar semua saluran yang tersedia untuk perangkat ini agar dapat menetapkan sendiri.
setCustomId	Setel identifikasi khusus untuk perangkat ini.
getBuiltinVersion	Dapatkan versi bundle bawaan (versi asli yang dikirimkan dengan aplikasi native Anda).
getDeviceId	Dapatkan identifikasi unik dan ramah privasi untuk perangkat ini.
getPluginVersion	Dapatkan versi dari Capacitor Plugin Pembaruan yang terinstal di aplikasi Anda.
isAutoUpdateEnabled	Periksa apakah pembaruan otomatis saat ini diaktifkan.
removeAllListeners	Hapus semua pendengar acara yang terdaftar untuk plugin ini.
addListener	Dengarkan acara download bundle di Aplikasi. Melempar sekali ketika download dimulai, selama download dan ketika selesai. Ini akan kembali persentase download selama download.
addListener	Dengarkan tidak perlu update event, berguna ketika Anda ingin memeriksa setiap kali aplikasi diluncurkan.
addListener	Dengarkan event update yang tersedia, berguna ketika Anda ingin memeriksa update setiap kali aplikasi diluncurkan.
addListener	Dengarkan event download selesai.
addListener	Dengarkan event update breaking ketika backend menandai update sebagai tidak kompatibel dengan aplikasi saat ini. Mengeluarkan payload yang sama seperti listener legacy. majorAvailable listener.
addListener	Dengarkan event update gagal dalam Aplikasi, biarkan Anda tahu ketika update gagal terpasang di aplikasi selanjutnya.
addListener	Dengarkan event gagal update di Aplikasi, memberitahu Anda ketika update gagal terpasang di aplikasi selanjutnya.
addListener	Listen for set event in the App, let you know when a bundle has been applied successfully. This event is retained natively until JavaScript consumes it, so if the app reloads before your listener is attached, the last pending set event akan dikirimkan setelah pengguna berlangganan.
addListener	Dengarkan untuk setiap event berikutnya di Aplikasi, dan informasikan Anda ketika sebuah paket telah ditetapkan sebagai paket berikutnya untuk diinstal.
addListener	Dengarkan event gagal download di Aplikasi, memberitahu Anda ketika bundle download gagal.
addListener	Dengarkan event reload di Aplikasi, biarkan Anda tahu ketika reload telah terjadi.
addListener	Menunggu event siap aplikasi di App, memungkinkan Anda mengetahui ketika aplikasi siap digunakan. Event ini disimpan secara native hingga JavaScript mengonsumsinya, sehingga masih dapat dikirimkan setelah reload bahkan jika pendengar terpasang lebih awal dalam proses startup aplikasi.
addListener	Menunggu event privat channel, diluncurkan ketika mencoba mengatur channel yang tidak memungkinkan perangkat pengasasan sendiri.
addListener	Menunggu perubahan status update fleksibel pada Android.
isAutoUpdateAvailable	Periksa jika fitur auto-update tersedia (tidak dinonaktifkan oleh konfigurasi server kustom).
getNextBundle	Pilih informasi tentang paket yang diantre untuk diaktifkan pada reload berikutnya.
getFailedUpdate	Pilih informasi tentang paket terbaru yang gagal dimuat.
setShakeMenu	Aktifkan atau nonaktifkan menu guncangan untuk debugging dan testing.
isShakeMenuEnabled	Periksa jika menu guncangan debug saat ini aktif.
setShakeChannelSelector	Aktifkan atau nonaktifkan pilihan channel guncangan pada runtime.
isShakeChannelSelectorEnabled	Periksa jika pilihan channel guncangan saat ini aktif.
getAppId	Pilih ID Aplikasi yang saat ini dikonfigurasi untuk komunikasi server update.
setAppId	Ganti ID Aplikasi secara dinamis yang digunakan untuk komunikasi server update.
getAppUpdateInfo	Peroleh informasi tentang ketersediaan aplikasi di App Store atau Play Store.
openAppStore	Terbuka halaman aplikasi di App Store atau Play Store.
performImmediateUpdate	Perbarui aplikasi secara langsung di Android.
startFlexibleUpdate	Mulai perbarui aplikasi fleksibel di Android.
completeFlexibleUpdate	Selesaikan perbarui aplikasi fleksibel di Android.

Sumber Kebenaran

Referensi ini disinkronkan dari src/definitions.ts in capacitor-perbarui.

Teruskan dari @capgo/capacitor-updater

Jika Anda menggunakan @capgo/capacitor-updater Untuk merencanakan pekerjaan plugin native, hubungkannya dengan Menggunakan @capgo/capacitor-pembarui Untuk kemampuan asli di Using @capgo/capacitor-updater, Direktori Plugin Capgo untuk alur kerja produk di direktori plugin Capgo. Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo Mengaktifkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk di Ionic Enterprise Plugin Alternatives.