Getting Started

설치

AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 기능을 추가하려면 다음 명령어를 사용하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음 명령어를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-webview-crash` plugin in my project.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래 플랫폼별 지침을 따르세요:

npm install @capgo/capacitor-webview-crash
npx cap sync

Import

import { WebViewCrash } from '@capgo/capacitor-webview-crash';

Recommended recovery flow

앱 시작 시 recovered runtime이 사용자가 계속 탐색하기 전에 반응할 수 있도록 가능한 한 빠르게 리스너를 연결하십시오.

import { WebViewCrash } from '@capgo/capacitor-webview-crash';

await WebViewCrash.addListener('webViewRestoredAfterCrash', async (info) => {
  console.log('Recovered after a WebView crash', info);

  // Rehydrate critical state, reopen the correct screen, or prompt the user to retry.
  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 auto restart

native __CAPGO_KEEP_0__에서 restart 옵션을 설정하십시오. JavaScript runtime이 충돌하거나 로드되지 않은 경우에도 결정이 유지되도록 하십시오. capacitor.config.ts so the decision stays in native code even when the JavaScript runtime has crashed or has not loaded yet:

import type { CapacitorConfig } from '@capacitor/cli';
import type { WebViewCrashPluginConfig } from '@capgo/capacitor-webview-crash';

const webViewCrash: WebViewCrashPluginConfig = {
  // Enabled by default. Keep this on for long-running apps.
  restartOnCrash: true,

  // Use a 5-field cron schedule in the device local timezone.
  // Do not combine restartCron with an active restartIntervalMs.
  restartCron: '0 3 * * *',

  // Optional delay before restarting after a crash.
  restartAfterCrashDelayMs: 0,
};

const config: CapacitorConfig = {
  plugins: {
    WebViewCrash: webViewCrash,
  },
};

export default config;

사용 restartIntervalMs 다음과 같은 always-on 앱에서 사용하세요: restartCron 키오스크 화면, 0 3 * * * 제어실 대시보드, reason: 'periodicRestart', then Android recreates the host activity and iOS rebuilds the Capacitor bridge view so a new WKWebView is created from native code.

fleet 태블릿, restartCron 디지털 시그니처. *일정 재시작, restartCron 예를 들어 restartIntervalMs 일정 재시작은 0마커를 기록하고,

수동 네이티브 재시작

호출 restartWebView() 호출

await WebViewCrash.restartWebView();

클립보드 복사 reason: 'manualRestart', resolves the current call, then asks native code to create a fresh WebView. Android recreates the host activity. iOS rebuilds the Capacitor bridge view so a new WKWebView 현재 호출을 해제한 후 네이티브 __CAPGO_KEEP_0__에게 새로운 WebView를 생성하도록 요청합니다. Android는 호스트 활동을 재생성하고 iOS는 __CAPGO_KEEP_1__ 브리지를 다시 빌드하여 새로운

API 개요

getPendingCrashInfo

getPendingCrashInfo null nothing이 대기 중이 아닐 때.

const pending = await WebViewCrash.getPendingCrashInfo();
if (pending.value) {
  console.log(pending.value.platform, pending.value.reason);
}

clearPendingCrashInfo

처리 완료 후 저장된 마커를 삭제합니다.

await WebViewCrash.clearPendingCrashInfo();

simulateCrashRecovery

QA 및 로컬 디버깅을 위해 실제 WebView가 충돌하지 않도록 회복 경로를 연습할 수 있는 가짜 충돌 마커를 생성합니다.

const simulated = await WebViewCrash.simulateCrashRecovery();
console.log(simulated.value);

restartWebView

수동 재시작 마커를 저장하고 native code에게 새로운 WebView를 생성하도록 요청합니다.

await WebViewCrash.restartWebView();

플랫폼 참고사항

• Android는 플랫폼이 제공하는 onRenderProcessGone을 저장합니다. didCrash 및 rendererPriorityAtExit 을 포함합니다.
• 플랫폼이 제공하는 webViewWebContentProcessDidTerminate 을 저장합니다.
• Manual and scheduled restarts create a fresh WebView. Android recreates the host activity; iOS rebuilds the Capacitor bridge view.
• 을 추가합니다. reason: 'periodicRestart'현재 애플리케이션 상태가 사용 가능한 경우. reason: 'manualRestart'.
• 수동 및 예약된 재시작은 새로운 WebView를 생성합니다. Android는 호스트 활동을 재생성합니다; iOS는 __CAPGO_KEEP_0__ 브리지 뷰를 재구성합니다.

예약된 재시작은 사용하며, 수동 재시작은 사용합니다.

PendingCrashInfoResult

export interface PendingCrashInfoResult {
  /**
   * Stored crash or restart metadata, or `null` when no marker is pending.
   */
  value: WebViewCrashInfo | null;
}

WebViewCrashPluginConfig

export interface WebViewCrashPluginConfig {
  /**
   * Restart the WebView from native code when the renderer process dies.
   *
   * @default true
   */
  restartOnCrash?: boolean;

  /**
   * Fixed native interval, in milliseconds, for proactively replacing long-running WebViews.
   *
   * Set to `0` to disable interval restarts. Do not combine an active interval
   * with `restartCron`; native initialization fails fast when both schedules are configured.
   *
   * @default 0
   */
  restartIntervalMs?: number;

  /**
   * Cron schedule for proactively replacing long-running WebViews.
   *
   * Uses standard 5-field cron syntax in the device local timezone:
   * `minute hour day-of-month month day-of-week`.
   *
   * Examples:
   * - `0 3 * * *` restarts every day at 03:00.
   * - `0,30 * * * *` restarts every 30 minutes.
   *
   * Do not combine this with an active `restartIntervalMs`; native initialization
   * fails fast when both schedules are configured.
   */
  restartCron?: string;

  /**
   * Delay, in milliseconds, before restarting after a crash.
   *
   * @default 0
   */
  restartAfterCrashDelayMs?: number;
}

WebViewCrashInfo

export interface WebViewCrashInfo {
  /**
   * Platform that detected and stored the marker.
   */
  platform: WebViewCrashPlatform;

  /**
   * Unix timestamp in milliseconds for when the marker was written.
   */
  timestamp: number;

  /**
   * ISO-8601 version of `timestamp`.
   */
  timestampISO: string;

  /**
   * Platform-specific reason for the crash or restart marker.
   */
  reason: WebViewCrashReason;

  /**
   * Last known WebView URL when the marker was written.
   */
  url?: string;

  /**
   * Android-only hint from `RenderProcessGoneDetail.didCrash()`.
   */
  didCrash?: boolean;

  /**
   * Android-only renderer priority reported at exit.
   */
  rendererPriorityAtExit?: number;

  /**
   * iOS-only application state captured when the WebView process died.
   */
  appState?: WebViewCrashAppState;
}

WebViewCrashPlatform

export type WebViewCrashPlatform = 'android' | 'ios' | 'web';

WebViewCrashReason

export type WebViewCrashReason =
  | 'renderProcessGone'
  | 'webContentProcessDidTerminate'
  | 'periodicRestart'
  | 'manualRestart'
  | 'simulated';

WebViewCrashAppState

export type WebViewCrashAppState = 'active' | 'inactive' | 'background' | 'unknown';

진실의 근원

이 페이지는 플러그인의 src/definitions.ts공개 API이 업스트림에서 변경될 때까지 다시 싱크를 실행하세요.

Getting Started에서 계속

native 미디어 및 인터페이스 동작을 계획하고 있다면 Getting Started을 Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-webview-crash Using @capgo/capacitor-webview-crash for the native capability in Using @capgo/capacitor-webview-crash, 라이브 액티비티 @capgo/capacitor 사용 자연스러운 @capgo/capacitor-라이브-액티비티스 @capgo/capacitor-라이브-액티비티스 자연스러운 @capgo/capacitor-라이브-액티비티스 구현 비디오 플레이어 @capgo/capacitor 사용 자연스러운 @capgo/capacitor-비디오-플레이어 @capgo/capacitor-비디오-플레이어 자연스러운 @capgo/capacitor-비디오-플레이어 구현