@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()Yang membantu aplikasi kiosk, POS, dashboard, scanner, dan signage menghindari pembangunan memori selama sesi panjang.

Kemampuan Utama

• 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 ditipe - Mengungkapkan
• Typed Capacitor config - Exposes WebViewCrashPluginConfig dalam plugins.WebViewCrash - Mengembalikan marker pemulihan native atau restart yang disimpan, atau capacitor.config.ts.
• getPendingCrashInfo ketika tidak ada yang menunggu. null - Membersihkan marker yang disimpan setelah aplikasi Anda telah memulihkan keadaan.
• clearPendingCrashInfo - Mengembalikan marker pemulihan native atau restart yang disimpan, atau
• simulateCrashRecovery - Membuat marker kecelakaan palsu agar aliran pemulihan dapat diuji secara lokal.
• addListener - Mengirimkan webViewRestoredAfterCrash untuk marker kecelakaan dan webViewRestoredAfterRestart untuk marker restart native apa pun.

Bagian Publik API

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

Menghapus semua pendengar plugin.

The plugin augments Capacitor’s PluginsConfig Plugin ini memperluas __CAPGO_KEEP_0__’s WebViewCrash dengan entri konfigurasi yang ditipekan:

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 dipulihkan adalah baru, jadi semua keadaan di memori dari WebView sebelumnya sudah hilang ketika API ini berjalan.
• 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 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 untuk merencanakan perilaku media dan antarmuka native, hubungkannya dengan Menggunakan @capgo/capacitor-webview-crash untuk kemampuan native di 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 {"targetLanguage":"Indonesia","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"}]}