콘텐츠로 이동

React Native 애플리케이션 연동


React Native 애플리케이션의 메트릭 데이터를 수집하여 애플리케이션 성능을 시각화 방식으로 분석합니다.

읽기 경로

사전 요구 사항

주의

RUM Headless 서비스가 이미 활성화된 경우 사전 요구 사항이 자동으로 구성되었으므로 애플리케이션을 바로 연동할 수 있습니다.

로컬 환경에 배포하는 경우 다음 데이터 수신 측 구성을 완료해야 합니다. 공인 DataWay를 사용하는 경우 DataKit을 직접 배포할 필요가 없습니다.

애플리케이션 연동

주의

현재 React Native 버전은 Android 및 iOS 플랫폼만 지원합니다.

  1. RUM > 새 애플리케이션 > React Native로 이동합니다.
  2. Android 및 iOS 플랫폼의 RUM 데이터를 각각 수신할 수 있도록 React Native Android용과 React Native iOS용 애플리케이션을 각각 생성합니다.
  3. 각 플랫폼의 애플리케이션에 해당 애플리케이션 이름과 애플리케이션 ID를 입력합니다.
  4. 「연동 방식 선택」에서 Agent 자동 연동 또는 수동 연동을 선택한 후 「연동 구성」을 완료합니다.

연동 방식 선택

애플리케이션 구성 페이지에서 「Agent 자동 연동」 또는 「수동 연동」을 선택한 후 「연동 구성」을 완료합니다. 기존 애플리케이션은 구성 페이지로 바로 이동하여 연동을 계속할 수 있습니다.

연동 방식 사용 사례 작업 경로
Agent 자동 연동 코딩 어시스턴트가 프로젝트를 분석하고 SDK 연동을 완료하도록 하려는 경우 콘솔에서 생성된 프롬프트를 복사하여 애플리케이션 코드 저장소에서 코딩 어시스턴트에 전달해 실행
수동 연동 SDK를 직접 설치하고 파라미터를 구성하려는 경우 데이터 보고 방식을 확인한 후 본 문서와 빠른 시작에 따라 구성을 완료

Agent 자동 연동

  1. 현재 애플리케이션의 구성 페이지에서 「Agent 자동 연동」을 선택합니다.
  2. 「연동 구성」의 전체 프롬프트를 복사하고 현재 애플리케이션의 연동 정보가 사용되었는지 확인합니다.
  3. 애플리케이션 코드 저장소에서 코딩 어시스턴트를 열고 프롬프트를 붙여넣으면 Agent가 연동 가이드에 따라 프로젝트를 분석하고 SDK 구성을 완료합니다.
  4. 애플리케이션을 빌드하고 실행한 뒤 페이지 방문 등의 작업을 수행하여 현재 애플리케이션의 탐색기에서 데이터 수신을 확인합니다.

크로스 플랫폼 프레임워크를 사용하는 경우 Agent에 프레임워크와 대상 플랫폼을 설명하고 각 플랫폼에 해당하는 애플리케이션 정보를 각각 제공하세요.

페이지에 개인 API Key 또는 임시 인증 코드가 준비되지 않았다고 표시되면 안내에 따라 보완한 후 프롬프트를 다시 복사하세요.

수동 연동

애플리케이션 구성 페이지에서 「수동 연동」을 선택하고 데이터 보고 방식을 확인합니다.

  • 공인 DataWay: RUM 데이터를 직접 수신하며 DataKit 수집기를 설치할 필요가 없습니다.
  • 로컬 환경 배포: 사전 요구 사항을 충족한 후 RUM 데이터를 수신합니다.

아래 설치 및 빠른 시작에 따라 SDK 설치, 초기화 및 검증을 완료합니다. 기존 SDK 구성이 있는 경우 먼저 확인하고 재사용하여 중복 초기화를 방지해야 합니다.

설치

소스 코드 주소: https://github.com/GuanceCloud/datakit-react-native

Demo 주소: https://github.com/GuanceCloud/datakit-react-native/example

프로젝트 경로의 터미널에서 다음 명령을 실행합니다:

npm install @cloudcare/react-native-mobile

이렇게 하면 패키지의 package.json에 다음 종속성이 추가됩니다:

"dependencies": {
"@cloudcare/react-native-mobile": "[latest_version]",
"..."
}

Android 통합 추가 구성:

  • Gradle Plugin ft-plugin을 구성하여 App 시작 이벤트와 네트워크 요청 데이터, Android Native 관련 이벤트(페이지 이동, 클릭 이벤트, Native 네트워크 요청, WebView 데이터)를 수집합니다.

  • Gradle에서 Guance Android Maven 저장소 주소를 동시에 구성해야 하며 Plugin과 AAR 모두 필요합니다. 구성 세부 사항은 example의 build.gradle을 참고하세요.

초기화 설명

최소 초기화 예시는 빠른 시작을 참고하세요.

전체 FTMobileConfig 파라미터 설명은 SDK 초기화를 참고하세요.

상세 구성 경로

고급 시나리오

자주 묻는 질문

문서 평가

이 페이지가 도움이 되었나요?