メインコンテンツへスキップ
@capgo/capacitor-webview-guardian 認証とセキュリティ オープンソース

WebViewの保護 Capacitor プラグイン

バックグラウンドで WebView が強制終了されたことを検知し、フォアグラウンド復帰時に再起動します

インストール

bun add @capgo/capacitor-webview-guardian bunx cap sync
npm、pnpm、または yarn
  • npm install @capgo/capacitor-webview-guardian
  • pnpm add @capgo/capacitor-webview-guardian
  • yarn add @capgo/capacitor-webview-guardian

ガイド

Capacitor で WebView Guardian を使用する方法

実機でテストする

Capgo アプリをダウンロードして、QR code をスキャンしてください。

WebView Guardian プラグインのプレビュー用QR code

@capgo/capacitor-webview-guardian の使用方法

WebView がバックグラウンドでキルされたことを検知し、フォアグラウンド復帰時に再起動する Capacitor プラグイン。

インストール

bun add @capgo/capacitor-webview-guardian
bunx cap sync

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

API の概要

メソッド 説明
startMonitoring フォアグラウンドイベントの監視を開始し、WebViewのヘルスチェックを自動で行います。
stopMonitoring フォアグラウンドの自動監視を停止します。
getState 最新の監視ステータスを返します。
checkNow WebViewのヘルスプローブを即座に強制実行します。

例

startMonitoring()

フォアグラウンドイベントの監視を開始し、WebViewのヘルスチェックを自動で行います。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.startMonitoring();
console.log(result);

stopMonitoring()

フォアグラウンドの自動監視を停止します。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.stopMonitoring();
console.log(result);

getState()

最新の監視ステータスを返します。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.getState();
console.log(result);

checkNow()

WebViewのヘルスプローブを即座に強制実行します。

import { WebviewGuardian } from '@capgo/capacitor-webview-guardian';

const result = await WebviewGuardian.checkNow();
console.log(result);

イベントをリッスンする

addListener ハンドルを返します。画面がアンマウントされるときに handle.remove() を呼び出してください。

完全なリファレンス

@capgo/capacitor-webview-guardian の使用から続ける

使用している場合 @capgo/capacitor-webview-guardian の使用方法 ネイティブメディアとインターフェースの挙動を計画するには、次と連携させてください @capgo/capacitor-webview-guardian @capgo/capacitor-webview-guardian の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 @capgo/capacitor-live-activities の使用 @capgo/capacitor-live-activities の使用におけるネイティブ機能については、 @capgo/capacitor-live-activities @capgo/capacitor-live-activities の実装の詳細については、 @capgo/capacitor-video-playerの使用方法 「@capgo/capacitor-video-player. の使い方」のネイティブ機能については

よくある質問

WebView Guardian プラグイン FAQ

Capacitor アプリに WebView Guardian プラグインをインストールするにはどうすればよいですか?

"bun add @capgo/capacitor-webview-guardian" (または "npm install @capgo/capacitor-webview-guardian") を実行し、続けて "bunx cap sync" を実行すると、iOS と Android のプロジェクトにネイティブの code が反映されます。アプリの code で "@capgo/capacitor-webview-guardian" からインポートしてください。

@capgo/capacitor-webview-guardian は React、Vue、Angular で動作しますか?

はい。WebView Guardian は Capacitor パッケージなので、Ionic、React、Vue、Angular、Svelte、素の JavaScript など、Capacitor 内で動く Web フレームワークならどれでも使えます。

@capgo/capacitor-webview-guardian はどの Capacitor バージョンをサポートしていますか?

Capgo プラグインは Capacitor のメジャーバージョンに合わせています。使用している Capacitor のメジャーバージョンに一致するプラグインのメジャーバージョンを使ってください (例: Capacitor 8 ならプラグイン v8)。GitHub の README にある互換性テーブルに、メンテナンス中のバージョンが記載されています。

@capgo/capacitor-webview-guardianは無料かつオープンソースですか?

はい。codeのソースコードはGitHub(https://github.com/Cap-go/capacitor-webview-guardian/)で公開されており、パッケージはnpmから無料でインストールできます。バグ報告やプルリクエストも歓迎しています。

WebView Guardianを使用しているcodeを、App Storeの審査なしでアップデートできますか?

プラグインのインストールやアップグレードはネイティブの code を変更するため、新しいストアビルドが必要です。その後は、プラグインを呼び出す JavaScript、HTML、CSS の変更を Capgo Live Updates で即座に配信できます。

アプリの審査を待たずに WebView Guardian の変更をリリース

プラグインをストア用ビルドに組み込めば、Capgo live updates で JavaScript、HTML、CSS の変更を数分でユーザーに配信できます

Capgo から始める