콘텐츠로 이동

빠른 시작

이 문서는 Android RUM SDK의 최단 연동 경로를 제공하여 최소한의 단계로 검증 가능한 데이터 보고를 완료할 수 있도록 지원합니다.

앱은 Agent 자동 연동 및 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 구성을 설명합니다.

사전 준비

시작하기 전에 다음 준비를 완료하십시오:

  1. 실제 사용자 모니터링(RUM)에서 Android 앱을 생성하고 RUM App ID를 확인합니다.
  2. 리포트 주소와 인증 방식을 확인합니다:
    • 로컬 환경 배포: datakitUrl을 준비합니다.
    • 퍼블릭 DataWay: datawayUrl 및 clientToken을 준비합니다.
  3. 앱에 Application이 이미 존재하는지 확인하거나, 새로 생성하여 AndroidManifest.xml에 선언합니다.

연동 단계

  1. Maven 저장소를 구성하고 ft-sdk를 추가합니다.
  2. 필요에 따라 ft-plugin, ft-native, okhttp를 추가합니다.
  3. Application.onCreate()에서 SDK를 설치하고 RUM을 초기화하며, 크래시 및 지연 감지를 활성화합니다.
  4. 로그 수집 또는 분산 추적이 필요한 경우 Log, Trace를 추가로 초기화합니다.
  5. 디버그 로그를 활성화하고 페이지 열기 또는 네트워크 요청을 한 번 트리거하여 데이터 보고가 성공했는지 확인합니다.

Maven 저장소

ft-plugin과 ft-sdk를 동시에 연동하는 경우 플러그인과 AAR 의존성에 대해 각각 Maven 저장소를 구성해야 합니다. 구체적인 Gradle 구성 방법은 앱 연동을 직접 참고하십시오.

최소 의존성

// build.gradle
plugins {
    id 'com.cloudcare.ft.mobile.sdk.tracker.plugin' version '[latest_version]'
    }
// app/build.gradle
dependencies {
    implementation 'com.cloudcare.ft.mobile.sdk.tracker.agent:ft-sdk:[latest_version]'
    // JSON 직렬화
    implementation 'com.google.code.gson:gson:2.8.+'
    // 선택 사항: 네트워크 요청 자동 수집 및 자동 추적 활성화가 필요한 경우 반드시 추가해야 하며, 최소 3.12.+ 이상 버전과 호환됩니다.
    implementation 'com.squareup.okhttp3:okhttp:4.+'
}
// app/build.gradle
apply plugin: 'ft-plugin'

다음 기능이 필요한 경우 해당 의존성을 계속 추가하십시오:

  • ft-native: Native Crash 수집.
  • okhttp: 네트워크 요청 자동 수집 또는 Trace Header 자동 주입 시 필요합니다.

ft-plugin은 페이지, 클릭, OkHttp 요청, WebView 등의 데이터를 자동 수집하는 데 사용됩니다. 현재 프로젝트에서 이전 버전 AGP를 사용하는 경우 ft-plugin-legacy를 대신 사용하십시오. 전체 작성 방법은 앱 연동을 참고하십시오.

Application 선언

프로젝트에 사용자 정의 Application이 아직 없는 경우 먼저 생성하고 AndroidManifest.xml에 선언하십시오:

<application
    android:name=".DemoApplication">
</application>

최소 초기화 예제

public class DemoApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        // 로컬 환경 배포 시 FTSDKConfig.builder(datakitUrl) 사용
        FTSDKConfig config = FTSDKConfig.builder(datawayUrl, clientToken);
        config.setDebug(true);
        FTSdk.install(config);

        FTSdk.initRUMWithConfig(
                new FTRUMConfig()
                        .setRumAppId(RUM_APP_ID)
                        .setEnableTraceUserView(true)
                        .setEnableTraceUserAction(true)
                        .setEnableTraceUserResource(true)
                        .setEnableTrackAppUIBlock(true)
                        .setEnableTrackAppCrash(true)
                        .setEnableTrackAppANR(true)
        );
    }
}
class DemoApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        // 로컬 환경 배포 시 FTSDKConfig.builder(datakitUrl) 사용
        val config = FTSDKConfig.builder(datawayUrl, clientToken)
        config.setDebug(true)
        FTSdk.install(config)

        FTSdk.initRUMWithConfig(
            FTRUMConfig()
                .setRumAppId(RUM_APP_ID)
                .setEnableTraceUserView(true)
                .setEnableTraceUserAction(true)
                .setEnableTraceUserResource(true)
                .setEnableTrackAppUIBlock(true)
                .setEnableTrackAppCrash(true)
                .setEnableTrackAppANR(true)
        )
    }
}

위 예제는 최소 RUM 연동을 충족하며 기본적으로 크래시 및 지연 감지를 활성화합니다. 로컬 환경 배포를 사용하는 경우 FTSDKConfig.builder(datawayUrl, clientToken)을 FTSDKConfig.builder(datakitUrl)로 바꾸십시오.

선택 사항: Log 및 Trace 초기화

로그 수집 또는 분산 추적이 추가로 필요한 경우 다음 초기화를 계속 추가할 수 있습니다:

FTSdk.initLogWithConfig(
    FTLoggerConfig()
        .setEnableCustomLog(true)
        .setEnableLinkRUMData(true)
)

FTSdk.initTraceWithConfig(
    FTTraceConfig()
        .setEnableAutoTrace(true)
        .setEnableLinkRUMData(true)
)

연동 성공 여부 확인

  1. config.setDebug(true)를 활성화한 상태로 유지하고 앱을 실행합니다.
  2. 페이지를 열거나, okhttp가 연동된 환경에서 네트워크 요청을 한 번 발생시킵니다.
  3. Logcat에서 [FT-SDK]를 검색하여 initRUMWithConfig complete 또는 Sync Success와 유사한 로그가 나타나는지 확인합니다.
  4. Guance 콘솔로 돌아가 앱에 해당 RUM 데이터가 표시되는지 확인합니다.

다음 단계

문서 평가

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