WebView モニタリング¶
WebView データモニタリング¶
WebView データモニタリングでは、WebView でアクセスするページに Web モニタリング SDK を統合する必要があります。
デスクトップブラウザの Web アプリケーションの収集も同時にサポートする場合は、デスクトップアプリケーションの推奨設定に従って接続することをお勧めします。
収集シナリオがアプリ内の WebView に限定され、デスクトップブラウザの Web アプリケーションをサポートする必要がない場合は、Web SDK の基本接続設定を完了した後、任意の applicationId を使用して初期化できます。
ネイティブ側で RUM の初期化を完了し、FTWebViewHandler を介して JavaScript Bridge を確立すると、アプリ内 WebView の収集データはアプリ側で一元的に管理されます。
WebView の収集を無効にする場合、または Host で収集範囲をフィルタリングする場合は、以下の設定説明を参照してください:
FTRUMConfig.setAllowWebViewHostは非推奨です。アップグレード後はFTSDKConfig.setAllowWebViewHostを使用して、WebView RUM と Replay の Host 範囲を一元的に制御してください。
コード呼び出し¶
アプリケーションのエントリポイントで SDK と RUM を初期化し、WebView データ収集を有効にします:
import { FTSDK, FTSDKConfig, FTRUMConfig } from '@guancecloud/ft_sdk/Index';
const sdkConfig = FTSDKConfig.builder('YOUR_DATAKIT_URL')
.setAllowWebViewHost(['example.com']);
FTSDK.install(sdkConfig, this.context);
FTSDK.installRUMConfig(new FTRUMConfig()
.setRumAppId('your-rum-app-id')
.setEnableTraceWebView(true));
ページライフサイクルでのバインディング¶
import { FTWebViewHandler } from '@guancecloud/ft_sdk/Index';
import { webview } from '@kit.ArkWeb';
@Component
export struct MyWebViewPage {
@State webController: webview.WebviewController = new webview.WebviewController();
private webViewHandler: FTWebViewHandler = new FTWebViewHandler();
aboutToAppear() {
this.webViewHandler.setWebView(this.webController);
}
aboutToDisappear() {
this.webViewHandler.clearWebController();
}
build() {
Web({
src: 'https://example.com',
controller: this.webController
})
.javaScriptAccess(true)
.javaScriptProxy(this.webViewHandler.getJavaScriptProxy(this.webController))
}
}
Web controller の準備完了後にバインド¶
onControllerAttached(...) を使用して、Web コンポーネントと controller のバインド完了後に setWebView(...) を呼び出すこともできます:
Web({
src: 'https://example.com',
controller: this.webController
})
.javaScriptAccess(true)
.javaScriptProxy(this.webViewHandler.getJavaScriptProxy(this.webController))
.onControllerAttached(() => {
this.webViewHandler.setWebView(this.webController);
})
2 つの記述方法のいずれかを使用します。onControllerAttached(...) を使用する場合は、上記の例で aboutToAppear() のバインディング呼び出しを削除し、aboutToDisappear() 内の clearWebController() によるクリーンアップ処理は残してください。
説明:
view_path_nameが含まれていない場合、SDK はこのフィールドを補完しません。含まれている場合はその値を保持します。view_referrerが含まれていない場合は、現在のネイティブ View にフォールバックします。- WebView データの
sdk_versionはネイティブ SDK を基準とします。Browser SDK のバージョン情報はsdk_pkg_infoに保持されます。
よくあるトラブルシューティングの入口¶
- WebView データが送信されない場合は、該当する収集スイッチ、Host ホワイトリスト、および
FTWebViewHandlerのバインディングを確認してください。診断ログの有効化方法については、トラブルシューティング を参照してください。 - WebView のセッションリプレイを収集する必要がある場合は、先にネイティブ Replay を開始して
FTWebViewHandlerのバインディングを完了し、その後で Web ページの Browser SDK をロードすることをお勧めします。詳細は HarmonyOS セッションリプレイ(実験的) を参照してください。