@capgo/capacitor-webview-crash 사용하기
복구된 WebView crash를 감지하고, 죽은 WebView를 네이티브로 재시작하며, 메모리 압박이 OOM으로 이어지기 전에 정해진 간격으로 장시간 실행된 WebView를 재활용합니다.
설치
npm install @capgo/capacitor-webview-crash
npx cap sync
플러그인이 제공하는 기능
- iOS 및 Android에서 WebView crash 발생 시 네이티브 재시작 지원.
- 며칠씩 실행되는 키오스크, POS, 사이니지, 스캐너, 대시보드 앱을 위한 일정 간격 네이티브 WebView 재시작.
restartWebView- 페이지를 새로고침하지 않고 JavaScript가 새 네이티브 WebView를 요청할 수 있습니다.WebViewCrashPluginConfig- Typesplugins.WebViewCrash옵션에서capacitor.config.ts.getPendingCrashInfo- 저장된 네이티브 크래시 또는 재시작 마커를 반환하거나,null대기 중인 항목이 없으면 null을 반환합니다.clearPendingCrashInfo- 앱이 상태를 복원한 후 저장된 마커를 지웁니다.simulateCrashRecovery- 로컬에서 복구 흐름을 테스트할 수 있도록 가짜 크래시 마커를 생성합니다.webViewRestoredAfterCrash- 복구된 런타임에서 크래시 마커가 여전히 대기 중일 때 발화되는 리스너 이벤트.webViewRestoredAfterRestart- 네이티브 재시작 마커가 여전히 대기 중일 때 발화되는 리스너 이벤트.
사용 예시
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);
}
Native 자동 재시작
재시작 동작을 설정하려면 capacitor.config.ts JavaScript가 사용 불가능할 때도 계속 작동하도록 설정하세요:
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;
정기 재시작은 reason: 'periodicRestart'. 사용하세요 restartIntervalMs 고정 간격 또는 restartCron 디바이스 로컬 시간대의 5필드 cron 스케줄(예: 0 3 * * * 매일 03:00 재시작용입니다. 두 스케줄을 동시에 설정하지 마세요. 네이티브 초기화는 치명적인 구성 오류를 발생시킵니다. 다음 경우에 restartCron 이(가) 설정되어 있고 restartIntervalMs 값이 ...보다 크면 0)에 따라 동작합니다. 짧은 스케줄을 사용하기 전에 중요한 앱 상태를 저장하세요.
Native 수동 재시작
호출하세요 restartWebView() JavaScript가 네이티브 WebView를 선제적으로 교체해야 한다고 판단할 때, 예를 들어 메모리를 많이 쓰는 워크플로 이후:
await WebViewCrash.restartWebView();
이 메서드는 기록합니다 reason: 'manualRestart' 그리고 네이티브 code에 새 WebView 생성을 요청합니다. Android는 호스트 activity를 재생성하며, iOS는 Capacitor bridge view를 다시 빌드해 새 WKWebView WebView가 생성되도록 합니다. 현재 페이지를 다시 로드하는 대신입니다.
전체 레퍼런스
- GitHub: https://github.com/Cap-go/capacitor-webview-crash/
- 문서: /docs/plugins/webview-crash/
@capgo/capacitor-webview-crash 사용부터 계속하기
사용 중이라면 @capgo/capacitor-webview-crash 사용하기 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-webview-crash @capgo/capacitor-webview-crash의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항은, 그리고 @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player. 사용하기에서의 네이티브 기능은