본문 바로가기

@capgo/capacitor-webview-crash

크래시된 WebView를 네이티브로 재시작하고, 오래 실행된 WebView를 일정 간격으로 재활용합니다

크래시된 WebView를 네이티브로 재시작하고, 오래 실행된 WebView를 일정 간격으로 재활용합니다

시작하기 getPendingCrashInfo() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.

플랫폼지원참고 사항
iOS지원네이티브
Android지원네이티브
웹부분시작하기 보기
  • 네이티브 크래시 재시작 - 렌더러 프로세스가 종료되면 iOS 또는 Android에서 WebView를 재시작합니다.
  • 예약된 재시작 - 네이티브 타이머를 사용하여 장시간 실행 중인 WebView를 재사용합니다 restartIntervalMs 또는 벽시계 restartCron.
  • 수동 네이티브 재시작 - JavaScript가 restartWebView() 을(를) 사용하여 페이지 리로드 없이 새로운 네이티브 WebView를 요청할 수 있습니다.
  • 타입 지정된 Capacitor 설정 - 노출 WebViewCrashPluginConfig 위해 plugins.WebViewCrash 에서 capacitor.config.ts.
  • getPendingCrashInfo - 저장된 네이티브 크래시 또는 재시작 마커를 반환하거나, null 대기 중인 항목이 없으면 null을 반환합니다.
  • clearPendingCrashInfo - 앱이 상태를 복원한 후 저장된 마커를 지웁니다.
  • simulateCrashRecovery - 로컬에서 복구 흐름을 테스트할 수 있도록 가짜 크래시 마커를 생성합니다.
  • addListener - 발생시킵니다 webViewRestoredAfterCrash 크래시 마커 및 webViewRestoredAfterRestart 모든 네이티브 재시작 마커에 대해.
메서드설명
getPendingCrashInfo저장된 네이티브 크래시 또는 재시작 마커를 반환하거나, null 대기 중인 항목이 없으면 null을 반환합니다.
clearPendingCrashInfo앱이 상태를 복구한 후 저장된 마커를 지웁니다.
simulateCrashRecovery복구 플로우를 로컬에서 테스트할 수 있도록 가짜 크래시 마커를 생성합니다.
restartWebView쓰기 reason: 'manualRestart' 네이티브 code에 새 WebView를 생성하도록 요청합니다.
addListener발생합니다. webViewRestoredAfterCrash 또는 webViewRestoredAfterRestart 리스너가 연결되고 일치하는 마커가 아직 대기 중일 때 발생합니다.
removeAllListeners모든 플러그인 리스너를 제거합니다.

이 플러그인은 Capacitor의 PluginsConfig 에 타입이 지정된 WebViewCrash config 항목을 추가합니다:

export interface WebViewCrashPluginConfig {
restartOnCrash?: boolean;
restartIntervalMs?: number;
restartCron?: string;
restartAfterCrashDelayMs?: number;
}
  • 이 플러그인은 WebView 크래시 후 복구 상황을 감지합니다. 근본적인 크래시를 방지하지는 않습니다.
  • 복구된 JavaScript 런타임은 새로 생성되므로, 이 API가 발화될 때 이전 WebView의 인메모리 상태는 이미 사라져 있습니다.
  • 예약된 재시작은 reason: 'periodicRestart'을(를) 기록하고, 수동 재시작은 reason: 'manualRestart'을(를) 기록합니다. 짧은 재시작 간격, cron 스케줄, 또는 restartWebView().
  • restartCron 기기 로컬 시간대를 기준으로 5필드 cron 구문을 사용합니다. 예를 들어 0 3 * * * 매일 03:00 재시작용입니다. 두 스케줄을 동시에 설정하지 마세요. 네이티브 초기화는 치명적인 구성 오류를 발생시킵니다. 다음 경우에 restartCron 이(가) 설정되어 있고 restartIntervalMs 값이 ...보다 크면 0.
  • Android에서는 ...와 같은 추가 필드가 didCrash 및 rendererPriorityAtExit 있을 수 있습니다.
  • iOS에서 플러그인은 appState 종료된 WebView 프로세스가 감지되면 기록합니다. 수동 및 예약 재시작은 Capacitor 브리지 뷰를 재구성하므로 새로운 WKWebView 뷰가 생성됩니다.

이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-webview-crash.

@capgo/capacitor-webview-crash에서 계속하기

“@capgo/capacitor-webview-crash에서 계속하기” 섹션

사용 중이라면 @capgo/capacitor-webview-crash 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-webview-crash 사용하기 @capgo/capacitor-webview-crash 사용의 네이티브 기능에 대해, @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항, @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player 사용에서의 네이티브 기능 및 @capgo/capacitor-video-player @capgo/capacitor-video-player.의 구현 세부 사항