@capgo/capacitor-webview-crash
Ikhtisar
Bagian berjudul “Ringkasan”Restart WebView yang crash secara native dan recycle WebView yang berjalan lama pada interval tetap
Mulai dengan getPendingCrashInfo() dan metode inti lainnya yang tercantum di bawah ini.
Dukungan platform
Bagian berjudul “Dukungan platform”| Platform | Dukungan | Catatan |
|---|---|---|
| iOS | Ya | Native |
| Android | Ya | Native |
| Web | Parsial | Lihat panduan memulai |
Kemampuan Utama
Bagian berjudul “Kemampuan Utama”- Restart crash native - Restart WebView dari iOS atau Android saat proses renderer mati.
- Restart terjadwal - Recycle WebView yang berjalan lama dengan timer native menggunakan
restartIntervalMsatau waktu aktualrestartCron. - Restart native manual - Memungkinkan JavaScript meminta WebView native baru dengan
restartWebView()tanpa melakukan reload halaman. - Konfigurasi Capacitor bertipe - Mengekspos
WebViewCrashPluginConfiguntukplugins.WebViewCrashdicapacitor.config.ts. getPendingCrashInfo- Mengembalikan marker native crash atau restart yang tersimpan, ataunullsaat tidak ada yang tertunda.clearPendingCrashInfo- Menghapus marker yang tersimpan setelah app memulihkan state-nya.simulateCrashRecovery- Membuat marker crash palsu agar alur recovery bisa diuji secara lokal.addListener- MemicuwebViewRestoredAfterCrashuntuk marker crash danwebViewRestoredAfterRestartuntuk setiap native restart marker.
API Publik
Bagian berjudul “Public API”| Metode | Deskripsi |
|---|---|
getPendingCrashInfo | Mengembalikan marker crash native atau restart yang tersimpan, atau null saat tidak ada yang tertunda. |
clearPendingCrashInfo | Menghapus marker tersimpan setelah aplikasi Anda memulihkan state-nya. |
simulateCrashRecovery | Membuat marker crash palsu agar alur recovery bisa diuji secara lokal. |
restartWebView | Menulis reason: 'manualRestart' dan meminta native code untuk membuat WebView baru. |
addListener | Terpicu webViewRestoredAfterCrash atau webViewRestoredAfterRestart saat listener terpasang dan marker yang cocok masih tertunda. |
removeAllListeners | Menghapus semua listener plugin. |
Tipe konfigurasi
Bagian berjudul “Config Type”Plugin ini memperluas Capacitor PluginsConfig dengan tipe WebViewCrash entri config bertipe:
export interface WebViewCrashPluginConfig { restartOnCrash?: boolean; restartIntervalMs?: number; restartCron?: string; restartAfterCrashDelayMs?: number;}Catatan
Bagian berjudul “Notes”- Plugin ini mendeteksi pemulihan setelah crash WebView. Plugin ini tidak mencegah crash yang mendasarinya.
- Runtime JavaScript yang dipulihkan adalah runtime baru, sehingga state in-memory apa pun dari WebView sebelumnya sudah hilang saat API ini dipicu.
- Restart terjadwal ditetapkan
reason: 'periodicRestart'; restart manual menulisreason: 'manualRestart'. Simpan state yang belum disimpan sebelum mengaktifkan interval restart pendek, jadwal cron, atau memanggilrestartWebView(). restartCronmenggunakan sintaks cron 5-field di zona waktu lokal perangkat, misalnya0 3 * * *untuk restart harian pukul 03:00. Jangan konfigurasi kedua jadwal sekaligus: inisialisasi native akan memicu error konfigurasi fatal saatrestartCrondiatur danrestartIntervalMslebih besar dari0.- Di Android, field tambahan seperti
didCrashdanrendererPriorityAtExitmungkin tersedia. - Di iOS, plugin mencatat
appStateketika proses WebView yang diakhiri terdeteksi. Restart manual dan terjadwal membangun ulang bridge view Capacitor sehingga yang baruWKWebViewdibuat.
Sumber Kebenaran
Bagian berjudul “Sumber Kebenaran”Referensi ini disinkronkan dari src/definitions.ts di capacitor-webview-crash.
Lanjut dari @capgo/capacitor-webview-crash
Bagian berjudul “Lanjut dari @capgo/capacitor-webview-crash”Jika Anda menggunakan @capgo/capacitor-webview-crash untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan Menggunakan @capgo/capacitor-webview-crash untuk kapabilitas native di bagian Menggunakan @capgo/capacitor-webview-crash, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-live-activities untuk detail implementasi di @capgo/capacitor-live-activities, Menggunakan @capgo/capacitor-video-player untuk kemampuan native di Menggunakan @capgo/capacitor-video-player, dan @capgo/capacitor-video-player untuk detail implementasi di @capgo/capacitor-video-player.