• 로그인지금 시작하세요

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Gradle 및 Android Studio로 Android 앱 설치

Gradle 또는 Android Studio를 사용하는 경우 다음 지침에 따라 New Relic의 모바일 모니터링을 처음 설치하십시오. 이전에 모바일 모니터링용 Android 에이전트 SDK를 설치한 경우 Gradle 및 Android Studio를 사용하여 최신 버전으로 업그레이드하기 전에 단계를 따르세요.

Android 앱 설치

모바일 모니터링을 위한 설치 프로세스의 일부로 New Relic은 애플리케이션 토큰 을 자동으로 생성합니다. 이것은 New Relic에서 모니터링하는 각 모바일 앱을 인증하기 위한 40자의 16진수 문자열입니다.

  1. one.newrelic.com > Mobile 로 이동합니다.
  2. 해당하는 경우: 모바일 앱 인덱스 에서 새 앱 추가 를 선택합니다.
  3. 시작하기 페이지에서 모바일 모니터링을 위한 플랫폼으로 Android 를 선택합니다.
  4. 모바일 앱의 의미 있는 이름을 입력하고 계속 을 선택합니다.

Gradle 및 Android Studio로 모바일 모니터링을 구성 하는 단계를 계속 진행합니다.

또는:

  • 나중에 새 모바일 앱에 대한 구성 프로세스를 완료하려면: one.newrelic.com > Mobile 로 이동한 다음 모바일 앱 이름 옆에 있는 지침 보기 를 선택합니다.
  • 기존 Android 설치를 업그레이드하려면: one.newrelic.com > Mobile > (앱 선택) > Settings > Installation 로 이동합니다.

Gradle 및 Android Studio로 구성

Gradle 및 Android Studio로 Android 앱을 구성하는 이러한 절차는 New Relic의 시작하기 페이지에도 나타납니다.

  1. Gradle 및 Android Studio 탭에 있는 New Relic의 모바일 모니터링 코드를 build.gradle 파일에 병합합니다.

  2. ProGuard 또는 DexGuard: 프로젝트의 루트 디렉터리( projectname/app )에서 다음 줄과 함께 newrelic.properties 파일을 추가합니다.

    com.newrelic.application_token=GENERATED_TOKEN
  3. New Relic과 함께 ProGuard 또는 DexGuard를 사용하기 위해 필요한 추가 구성 단계를 따르십시오.

  4. 앱 권한 설정: Android 앱이 AndroidManifest.xml 파일에 다음 행을 추가하여 INTERNETACCESS_NETWORK_STATE 권한을 요청하는지 확인합니다.

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  5. New Relic의 모바일 모니터링 에이전트를 시작하려면: 기본 활동 ( 매니페스트 에 정의된 대로)에서 NewRelic 클래스를 가져옵니다.

    import com.newrelic.agent.android.NewRelic;

    중요

    예상치 못한 동작이나 불안정한 동작이 발생할 수 있으므로 다른 클래스에서 모바일 모니터링 에이전트를 시작하는 것은 지원하지 않습니다.

  6. 모바일 모니터링을 초기화하려면: onCreate() 메서드에서 다음 호출을 추가합니다.

    NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplication());
  7. 선택 사항: 로깅 수준 을 변경합니다.

  8. 애플리케이션을 빌드하고 실행하려면 프로젝트를 정리한 다음 에뮬레이터나 기기에서 앱을 실행하여 트래픽을 생성합니다.

  9. 몇 분 정도 기다린 다음 요약 페이지 에서 Android 앱에 대한 데이터를 봅니다. one.newrelic.com > Mobile > (앱 선택)으로 이동합니다.

Android 설치에 문제가 있거나 모바일 모니터링 UI에 데이터가 표시되지 않는 경우 문제 해결 절차 를 따르세요.

While you wait for your data to come in...

Did this doc help you install?

Android 설치 업데이트

Android 에이전트를 최신 상태로 유지하려면 절차에 따라 New Relic용 Android 에이전트 SDK를 업그레이드하십시오 . 모바일 앱용 최신 Android 버전을 설치하려면: one.newrelic.com > Mobile > (앱 선택) > Settings > Installation 로 이동합니다.

Android 4.x: 멀티덱스 지원

Android 5.0(API 레벨 21) 이전의 Android 버전에 대한 New Relic의 모바일 모니터링은 Dalvik 런타임을 사용하여 앱 코드를 실행합니다. 기본적으로 Dalvik은 앱을 APK당 단일 classes.dex 바이트코드 파일로 제한합니다. 이 제한을 해결하려면 multidex 지원을 활성화 해야 합니다 . 그런 다음 앱의 기본 DEX 파일의 일부가 된 다음 추가 DEX 파일 및 포함된 코드에 대한 액세스를 관리하는 multidex 지원 라이브러리 를 사용할 수 있습니다.

multidex 앱에 대한 각 DEX 파일을 빌드할 때 빌드 도구는 앱이 성공적으로 시작될 수 있도록 기본 DEX 파일에 필요한 클래스를 결정하기 위해 복잡한 의사 결정을 수행합니다. 시작하는 동안 필요한 클래스가 기본 DEX 파일에 제공되지 않으면 앱이 오류 java.lang.NoClassDefFoundError 와 함께 충돌합니다.

java.lang.NoClassDefFoundError 오류가 표시되면 기본 DEX 파일에서 필요에 따라 이러한 추가 클래스를 수동으로 지정 해야 합니다.

  1. 프로젝트의 /app 폴더 내에 proguard.multidex.config 파일을 만듭니다. 패키지 이름을 반영하도록 mypackage 를 업데이트하십시오.

    ####################
    # keep class names #
    ####################
    
    #Keep New Relic in the main dex
    -keep class com.newrelic.** { *; }
    -keep class com.mypackage.activities.** { *; }
  2. 다음 코드를 앱 수준 build.gradle 파일에 병합합니다.

    android {
    defaultConfig{
    multiDexKeepProguard file("proguard.multidex.config")
    }
    }

자세한 내용은 기본 DEX 파일에 필요한 클래스 선언에 대한 Android 개발자 문서 를 참조하세요.

New Relic Gradle 플러그인 구성

Gradle 빌드 중 모바일 모니터링 에이전트 플러그인의 동작을 구성하는 방법에 대한 자세한 내용은 New Relic Gradle 플러그인 확장 가이드를 참조하세요.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.