@capgo/capacitor-webview-crash

Ringkasan

This plugin stores a native marker when the previous Capacitor WebView process dies or is recycled, then exposes that marker to the next JavaScript runtime after the app recovers. It can also restart the WebView from native code after a crash, on a fixed interval, on a cron schedule, or when JavaScript explicitly requests restartWebView()Fungsi Utama

Fungsi Utama Capgo

• Restart crash native - Menghidupkan kembali WebView dari iOS atau Android ketika proses renderer mati.
• Pemulihan yang dijadwalkan - Mengganti WebViews yang berjalan lama menggunakan timer native dengan restartIntervalMs atau jam dinding restartCron.
• Pemulihan native manual - Mengizinkan JavaScript meminta WebView native segar tanpa melakukan reload halaman. restartWebView() Konfigurasi __CAPGO_KEEP_0__ yang ditipekan - Menampilkan
• Typed Capacitor config - Exposes WebViewCrashPluginConfig dalam plugins.WebViewCrash Pengembalian marker crash atau restart native yang disimpan - Mengembalikan marker yang disimpan atau capacitor.config.ts.
• getPendingCrashInfo ketika tidak ada yang menunggu. null Penghapusan marker yang disimpan - Menghapus marker yang disimpan setelah aplikasi Anda telah memulihkan keadaan.
• clearPendingCrashInfo Restart native manual - Mengizinkan JavaScript meminta WebView native segar tanpa melakukan reload halaman.
• simulateCrashRecovery - Membuat marker kecelakaan palsu sehingga aliran pemulihan dapat diuji secara lokal.
• addListener - Mengirimkan webViewRestoredAfterCrash - untuk marker kecelakaan dan webViewRestoredAfterRestart - untuk marker restart native apa pun.

Bagian Publik API

Deskripsi	Mengembalikan marker kecelakaan native yang disimpan, atau
getPendingCrashInfo	- ketika tidak ada yang menunggu. null Menghapus marker yang disimpan setelah aplikasi Anda telah memulihkan keadaan.
clearPendingCrashInfo	Membuat marker kecelakaan palsu sehingga aliran pemulihan dapat diuji secara lokal.
simulateCrashRecovery	- Fires for crash markers and for any native restart marker.
restartWebView	Menghasilkan reason: 'manualRestart' dan meminta native code untuk membuat WebView yang segar.
addListener	Mengaktifkan webViewRestoredAfterCrash atau webViewRestoredAfterRestart ketika seorang pendengar menambahkan dan marker yang sesuai masih menunggu.
removeAllListeners	Menghapus semua pendengar plugin.

Jenis Konfigurasi

Plugin ini memperluas Capacitor’s PluginsConfig dengan entri konfigurasi yang ditipekan: WebViewCrash Menggunakan Ctrl+C untuk menyalin

export interface WebViewCrashPluginConfig {
  restartOnCrash?: boolean;
  restartIntervalMs?: number;
  restartCron?: string;
  restartAfterCrashDelayMs?: number;
}

Catatan

• Plugin ini mendeteksi pemulihan setelah crash WebView. Ini tidak mencegah crash dasar.
• Runtime JavaScript yang diperoleh setelah crash WebView adalah baru, sehingga semua keadaan di memori dari WebView sebelumnya sudah hilang ketika API ini dipicu.
• Restart yang dijadwalkan menulis reason: 'periodicRestart'Restart manual menulis reason: 'manualRestart'. Simpan keadaan yang belum disimpan sebelum mengaktifkan interval restart singkat, jadwal cron, atau memanggil restartWebView().
• restartCron gunakan sintaks cron 5-kolom di zona waktu lokal perangkat, misalnya 0 3 * * * untuk restart harian pada pukul 03:00. Jangan konfigurasi kedua jadwal sekaligus: inisialisasi native akan melemparkan kesalahan konfigurasi fatal ketika restartCron diatur dan restartIntervalMs lebih besar dari 0.
• Pada Android, bidang tambahan seperti didCrash dan rendererPriorityAtExit mungkin tersedia.
• Pada iOS, plugin merekam appState ketika proses WebView yang dihentikan diamati. Restart manual dan yang dijadwalkan membangun kembali jembatan Capacitor view sehingga Capacitor baru WKWebView Sumber Kebenaran

Bab berjudul “Sumber Kebenaran”

dalam src/definitions.ts __CAPGO_KEEP_0__-webview-crash Teruskan dari @capacitor/__CAPGO_KEEP_1__-webview-crash.

Bab berjudul “Teruskan dari @capgo/capacitor-webview-crash”

Jika Anda menggunakan @capgo/capacitor-webview-crash Menggunakan untuk kemampuan native di Menggunakan Using @capgo/capacitor-webview-crash for the native capability in Using @capgo/capacitor-webview-crash, Using @capgo/capacitor-live-activities for the native capability in Using @capgo/capacitor-live-activities, @capgo/capacitor-live-activities for the implementation detail in @capgo/capacitor-live-activities, Using @capgo/capacitor-video-player for the native capability in Using @capgo/capacitor-video-player, and @capgo/capacitor-video-player {"targetLanguage":"Indonesian","pagePath":"/id/docs/plugins/webview-crash/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"untuk detail implementasi di @capgo/capacitor-player video."},{"text":"Edit halaman"}]}