WebView 모니터링¶
WebView 데이터 모니터링¶
WebView 데이터 모니터링을 위해서는 WebView에서 접근하는 페이지에 웹 모니터링 SDK를 연동해야 합니다.
데스크톱 브라우저의 웹 애플리케이션 수집도 함께 지원해야 하는 경우, 데스크톱 애플리케이션 권장 구성에 따라 연동할 것을 권장합니다.
수집 대상이 앱 내 WebView로 한정되고 데스크톱 브라우저의 웹 애플리케이션을 지원할 필요가 없는 경우, 웹 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);
})
두 가지 방법 중 하나를 사용합니다. 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바인딩을 완료한 후 웹페이지 Browser SDK를 로드할 것을 권장합니다. 자세한 내용은 HarmonyOS 세션 리플레이(실험적)를 참고하세요.