React Native 앱 연동¶
React Native 앱의 메트릭 데이터를 수집하여 애플리케이션 성능을 시각적으로 분석합니다.
학습 경로¶
- 처음 연동 시: 먼저 빠른 시작을 확인하세요.
- 전체 연동: 이 문서를 계속 읽어보세요.
- 파라미터 상세: SDK 초기화, RUM 구성, Log 구성, Trace 구성을 확인하세요.
- 사용자 정의 기능: 사용자 정의 태그 사용, 데이터 수집 사용자 정의 규칙, 데이터 수집 마스킹을 확인하세요.
- 고급 시나리오: "고급 시나리오" 그룹의 전용 페이지를 확인하세요.
- 문제 해결: 문제 해결을 확인하세요.
전제 조건¶
참고
이미 RUM Headless 서비스를 활성화한 경우 전제 조건이 자동으로 구성되므로 앱을 직접 연동할 수 있습니다.
- DataKit을 설치합니다.
- RUM 수집기를 구성합니다.
- DataKit을 공개 인터넷에서 액세스 가능하도록 구성하고 IP 지리 정보 데이터베이스를 설치합니다.
앱 연동¶
참고
현재 React Native 버전은 Android 및 iOS 플랫폼만 지원합니다.
- RUM > 앱 생성 > React Native로 이동합니다.
- React Native Android 및 React Native iOS용 앱을 각각 생성하여 Android 및 iOS 플랫폼의 RUM 데이터를 각각 수신합니다.
- 각 플랫폼의 앱에 해당하는 앱 이름과 앱 ID를 입력합니다.
-
앱 연동 방식을 선택합니다.
- 공용 DataWay: DataKit 수집기 설치 없이 RUM 데이터를 직접 수신합니다.
- 로컬 환경 배포: 전제 조건을 충족한 후 RUM 데이터를 수신합니다.
설치¶
소스 코드 주소: https://github.com/GuanceCloud/datakit-react-native
데모 주소: https://github.com/GuanceCloud/datakit-react-native/example
프로젝트 경로에서 터미널에 다음 명령어를 실행합니다.
그러면 패키지의 package.json에 다음 종속성이 추가됩니다.
Android 통합 추가 구성:
-
Gradle Plugin ft-plugin을 구성하여 앱 시작 이벤트 및 네트워크 요청 데이터와 Android Native 관련 이벤트(페이지 이동, 클릭 이벤트, Native 네트워크 요청, WebView 데이터)를 수집합니다.
-
또한 Gradle에서 Guance Android Maven 저장소 주소를 구성해야 합니다. Plugin과 AAR 모두 필요합니다. 구성 세부 사항은 example의 build.gradle을 참조하세요.
초기화 설명¶
최소 초기화 예제는 빠른 시작을 참조하세요.
전체 FTMobileConfig 파라미터 설명은 SDK 초기화를 참조하세요.
상세 구성 진입점¶
고급 시나리오¶
- 사용자 정의 태그 사용
- 데이터 수집 사용자 정의 규칙
- 데이터 수집 마스킹
- 동적 구성
- 심볼 파일 업로드
- 핫 업데이트 SourceMap 버전 매칭
- WebView 데이터 모니터링
- Native와 React Native 혼합 개발
- Android Resource 수동 구성