WebView 데이터 모니터링¶
먼저 아래 실행 플랫폼과 패키징 방식에 따라 호스트 구성을 완료한 후 Web 페이지를 초기화합니다.
Android는 오프라인 패키징과 uni 미니프로그램 시나리오만 지원합니다.
설정¶
일반 uni-app은 RUM 초기화 시 설정합니다.
import { rum } from '@/uni_modules/GC-UniPlugin';
rum.setConfig({
enableTraceWebView: true,
allowWebViewHost: [
'example.com'
]
});
enableTraceWebView: WebView RUM 브리지 사용 여부이며 기본값은true입니다.allowWebViewHost: 추적을 허용할 WebView 호스트 목록입니다. 설정하지 않으면 모든 호스트를 수집합니다.
일반 uni-app은 먼저 Mobile SDK와 RUM 초기화를 완료한 후 WebView를 로드해야 합니다. uni 미니프로그램은 호스트 앱에서 SDK와 RUM 초기화를 완료하며 중복 초기화하지 않습니다.
플랫폼 설명¶
- Android, iOS는 표준
<web-view>를 사용하며 실제 기능은 Native SDK와 패키징 방식에 따라 달라집니다. - HarmonyOS는 비즈니스 측에서
WebviewController를 보유하는지에 따라 해당 연동 방식을 선택합니다. 자세한 내용은 HarmonyOS 연동을 참조하세요. - uni 미니프로그램의 WebView 수집 기능은 호스트 앱에 통합된 Native SDK에서 제공합니다. Android 호스트는
ft-plugin을 설치하고 적용해야 합니다.
HarmonyOS 연동¶
HarmonyOS의 WebView Bridge는 대상 페이지가 로드되기 전에 설치해야 합니다. 비즈니스 측에서 WebviewController를 보유하는지에 따라 다음 방식 중 하나를 선택하세요. 동일한 WebView에서 두 방식을 동시에 사용하지 마세요.
비즈니스 측에서 WebviewController를 보유하지 않는 경우¶
일반 uni-app 페이지에서 WebviewController를 직접 관리하지 않는 경우 HarmonyOS 플랫폼에서 플러그인이 제공하는 네이티브 임베디드 컴포넌트 gcwebview를 사용합니다. 이 컴포넌트는 컨트롤러를 사용할 수 있을 때 Bridge를 자동으로 설치하고 컴포넌트가 소멸될 때 자동으로 해제합니다.
<!-- #ifdef APP-HARMONY -->
<embed
class="harmony-webview"
tag="gcwebview"
:options="{
src: webviewUrl,
viewName: 'order-detail'
}"
></embed>
<!-- #endif -->
<!-- #ifndef APP-HARMONY -->
<web-view :src="webviewUrl" />
<!-- #endif -->
src: 로드할 Web 페이지 주소입니다.viewName: 선택 사항인 Native RUM View 이름입니다. 각 비즈니스 WebView에 의미 있고 안정적인 이름을 설정하는 것이 좋습니다. 설정하지 않으면 기본값으로webview를 사용합니다.gcwebview를 사용할 때는rum.attachWebView()또는rum.detachWebView()를 호출할 필요가 없습니다.
비즈니스 측에서 WebviewController를 보유하는 경우¶
HarmonyOS 네이티브 페이지, UTS 네이티브 WebView 또는 uni 미니프로그램 호스트 앱에서 비즈니스 코드가 WebviewController를 직접 보유하는 경우 컨트롤러의 onControllerAttached 콜백에서 rum.attachWebView()를 호출하고 이 시점에 대상 페이지가 아직 로드되지 않았는지 확인하세요.
Web({ src: webviewUrl, controller })
.onControllerAttached(() => {
rum.attachWebView(controller, 'order-detail');
});
WebView가 소멸될 때 해당 Bridge를 해제합니다.
rum.attachWebView()는 RUM 초기화가 완료되고 enableTraceWebView가 true인 경우에만 적용됩니다. 따라서 먼저 rum.setConfig()를 실행한 후 WebView를 생성하거나 컨트롤러를 바인딩해야 합니다. 페이지 로드가 완료된 후 바인딩하면 첫 번째 문서의 Web RUM Bridge를 놓치게 됩니다.
uni 미니프로그램 호스트 앱에서 이 방식을 사용하기 전에, uni 미니프로그램을 처음 열기 전에 호스트 확장의 registerNativeModules(context) 등록을 완료해야 합니다.
Web 페이지 초기화¶
위의 호스트 구성을 완료한 후 페이지 초기화를 진행한 다음 WebView 데이터 검증에 따라 보고 상태를 확인하세요.
권장 사항¶
- 위 페이지 초기화 설명에 따라 Web SDK 연동을 완료합니다.
- Native SDK/RUM 초기화가 완료된 후 WebView를 로드합니다.
allowWebViewHost를 사용하여 브리지를 허용할 비즈니스 도메인을 제한합니다.- HarmonyOS의
gcwebview와 수동attachWebView()방식 중 하나를 선택합니다. - Android, iOS, HarmonyOS 실기기 환경에서 각각 WebView 데이터와 현재 RUM View의 연관성을 검증합니다.