Gradle 및 Android Studio로 Android 앱 설치

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

Android 앱 설치

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

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

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

또는:

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

Gradle 및 Android Studio로 구성

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

Gradle 및 Android Studio 탭에 있는 New Relic의 모바일 모니터링 코드를 build.gradle 파일에 병합합니다.
이 예에서 AGENT_VERSION 은 에이전트 버전 번호를 나타냅니다. 에이전트 릴리스 정보 를 참조하고 최신 버전을 사용하십시오.
buildscript { repositories { mavenCentral() } dependencies { classpath "com.newrelic.agent.android:agent-gradle-plugin:AGENT_VERSION" } }
이 예에서 AGENT_VERSION 은 에이전트 버전 번호를 나타냅니다. 에이전트 릴리스 정보 를 참조하고 최신 버전을 사용하십시오.
repositories { mavenCentral() } apply plugin: 'android' apply plugin: 'newrelic' dependencies { implementation 'com.newrelic.agent.android:android-agent:AGENT_VERSION' }
ProGuard 또는 DexGuard: 프로젝트의 루트 디렉터리( projectname/app )에서 다음 줄과 함께 newrelic.properties 파일을 추가합니다.
```
com.newrelic.application_token=GENERATED_TOKEN
```
New Relic과 함께 ProGuard 또는 DexGuard를 사용하기 위해 필요한 추가 구성 단계를 따르십시오.
앱 권한 설정: Android 앱이 AndroidManifest.xml 파일에 다음 행을 추가하여 INTERNET 및 ACCESS_NETWORK_STATE 권한을 요청하는지 확인합니다.
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```
New Relic의 모바일 모니터링 에이전트를 시작하려면: 기본 활동 ( 매니페스트 에 정의된 대로)에서 NewRelic 클래스를 가져옵니다.
```
import com.newrelic.agent.android.NewRelic;
```
중요
예상치 못한 동작이나 불안정한 동작이 발생할 수 있으므로 다른 클래스에서 모바일 모니터링 에이전트를 시작하는 것은 지원하지 않습니다.
모바일 모니터링을 초기화하려면: onCreate() 메서드에서 다음 호출을 추가합니다.
```
NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplication());
```
선택 사항: 로깅 수준 을 변경합니다.
애플리케이션을 빌드하고 실행하려면 프로젝트를 정리한 다음 에뮬레이터나 기기에서 앱을 실행하여 트래픽을 생성합니다.
몇 분 정도 기다린 다음 요약 페이지 에서 Android 앱에 대한 데이터를 봅니다. one.newrelic.com > Mobile > (앱 선택)으로 이동합니다.

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

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 파일에서 필요에 따라 이러한 추가 클래스를 수동으로 지정 해야 합니다.

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

####################
# keep class names #
####################

#Keep New Relic in the main dex
-keep class com.newrelic.** { *; }
-keep class com.mypackage.activities.** { *; }

다음 코드를 앱 수준 build.gradle 파일에 병합합니다.

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

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

New Relic Gradle 플러그인 구성

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

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