개요
“개요” 섹션크래시된 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모든 네이티브 재시작 마커에 대해.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
getPendingCrashInfo | 저장된 네이티브 크래시 또는 재시작 마커를 반환하거나, null 대기 중인 항목이 없으면 null을 반환합니다. |
clearPendingCrashInfo | 앱이 상태를 복구한 후 저장된 마커를 지웁니다. |
simulateCrashRecovery | 복구 플로우를 로컬에서 테스트할 수 있도록 가짜 크래시 마커를 생성합니다. |
restartWebView | 쓰기 reason: 'manualRestart' 네이티브 code에 새 WebView를 생성하도록 요청합니다. |
addListener | 발생합니다. webViewRestoredAfterCrash 또는 webViewRestoredAfterRestart 리스너가 연결되고 일치하는 마커가 아직 대기 중일 때 발생합니다. |
removeAllListeners | 모든 플러그인 리스너를 제거합니다. |
Config 타입
“Config Type” 섹션이 플러그인은 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뷰가 생성됩니다.
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. 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.의 구현 세부 사항