Menggunakan @capgo/capacitor-webview-crash
Deteksi crash WebView yang pulih, restart WebView mati secara native, dan daur ulang WebView yang berjalan lama pada interval tetap sebelum tekanan memori berubah menjadi OOM.
Instal
npm install @capgo/capacitor-webview-crash
npx cap sync
Apa yang Diekspos Plugin Ini
- Restart native setelah crash WebView di iOS dan Android.
- Restart native WebView interval tetap untuk aplikasi kiosk, POS, signage, scanner, dan dashboard yang berjalan selama berhari-hari.
restartWebView- Memungkinkan JavaScript meminta WebView native baru tanpa melakukan reload halaman.WebViewCrashPluginConfig- Typesplugins.WebViewCrashopsi dicapacitor.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.webViewRestoredAfterCrash- Listener event yang dipicu ketika crash marker masih pending di runtime yang dipulihkan.webViewRestoredAfterRestart- Listener event yang dipicu ketika native restart marker apa pun masih pending.
Contoh Penggunaan
import { WebViewCrash } from '@capgo/capacitor-webview-crash';
await WebViewCrash.addListener('webViewRestoredAfterCrash', async (info) => {
console.log('Recovered after a WebView crash', info);
await WebViewCrash.clearPendingCrashInfo();
});
await WebViewCrash.addListener('webViewRestoredAfterRestart', async (info) => {
console.log('Recovered after a native WebView restart', info);
await WebViewCrash.clearPendingCrashInfo();
});
const pending = await WebViewCrash.getPendingCrashInfo();
// Note: the listener callback may have already cleared the pending marker.
if (pending.value) {
console.log('Pending crash or restart marker', pending.value);
}
Auto Restart Native
Konfigurasi perilaku restart di capacitor.config.ts agar tetap berfungsi ketika JavaScript tidak tersedia:
import type { CapacitorConfig } from '@capacitor/cli';
import type { WebViewCrashPluginConfig } from '@capgo/capacitor-webview-crash';
const webViewCrash: WebViewCrashPluginConfig = {
restartOnCrash: true,
restartCron: '0 3 * * *',
restartAfterCrashDelayMs: 0,
};
const config: CapacitorConfig = {
plugins: {
WebViewCrash: webViewCrash,
},
};
export default config;
Restart terjadwal ditetapkan reason: 'periodicRestart'. Gunakan restartIntervalMs untuk interval tetap atau restartCron untuk jadwal cron 5-field di zona waktu lokal perangkat, seperti 0 3 * * * untuk restart harian pukul 03:00. Jangan konfigurasi kedua jadwal sekaligus: inisialisasi native akan memicu error konfigurasi fatal saat restartCron diatur dan restartIntervalMs lebih besar dari 0. Simpan state aplikasi yang kritis sebelum menggunakan jadwal pendek.
Restart Native Manual
Panggil restartWebView() ketika JavaScript memutuskan WebView native harus diganti secara proaktif, misalnya setelah workflow yang berat memori:
await WebViewCrash.restartWebView();
Metode ini menulis reason: 'manualRestart' dan meminta code native untuk membuat WebView baru. Android membuat ulang host activity. iOS membangun ulang Capacitor bridge view sehingga yang baru WKWebView dibuat alih-alih memuat ulang halaman saat ini.
Referensi Lengkap
- GitHub: https://github.com/Cap-go/capacitor-webview-crash/
- Dokumentasi: /docs/plugins/webview-crash/
Lanjutkan dengan menggunakan @capgo/capacitor-webview-crash
Jika Anda menggunakan Menggunakan @capgo/capacitor-webview-crash untuk merencanakan perilaku media dan antarmuka native, hubungkan dengan @capgo/capacitor-webview-crash untuk detail implementasi di @capgo/capacitor-webview-crash, Panduan Memulai untuk detail implementasi di Getting Started, 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, dan Menggunakan @capgo/capacitor-video-player untuk kapabilitas native saat menggunakan @capgo/capacitor-video-player.