Android 에이전트 수동 설치(Gradle/Android Studio)

Android 모니터링을 설정하려면 안내 설치를 사용하는 것이 좋습니다. 그러나 에이전트를 수동으로 설치해야 하는 경우, 아래 단계에 따라 Gradle 및 Android Studio를 사용하여 뉴렐릭 Android 에이전트를 설치하시기 바랍니다.

Android 앱 설치

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

one.newrelic.com > All capabilities > Mobile 로 이동합니다.
해당되는 경우: 모바일 앱 인덱스에서 Add a new app을 선택합니다.
Get started 페이지에서 모바일 모니터링을 위한 플랫폼으로 Android를 선택합니다.
모바일 앱의 이름을 입력하고 Continue를 선택합니다.

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

또는:

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

Gradle 및 Android Studio로 구성

Gradle 및 Android Studio로 Android 앱을 구성하는 절차는 뉴렐릭의 Get started 페이지에도 표시됩니다.

Gradle 및 Android Studio 탭에서 뉴렐릭의 모바일 모니터링 코드를 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의 경우:
a. 프로젝트의 루트 디렉터리(projectname/app)에서 다음 줄과 함께 newrelic.properties 파일을 추가합니다.
```
com.newrelic.application_token=GENERATED_TOKEN
```
b. Android 앱을 위한 ProGuard 또는 DexGuard 구성에서 명시된 구성 단계를 완료합니다. 그런 다음 이 페이지로 돌아와 다음 단계로 이동합니다.

앱 권한 설정: AndroidManifest.xml 파일에 다음 행을 추가하여 Android 앱이 INTERNET 및 ACCESS_NETWORK_STATE 권한을 요청하도록 합니다.
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```
뉴렐릭의 모바일 모니터링 에이전트를 시작하려면: Default Activity(Manifest에 정의된 대로)에서 NewRelic 클래스를 가져옵니다.
```
import com.newrelic.agent.android.NewRelic;
```
중요
예기치 않거나 불안정한 동작이 발생할 수 있으므로 다른 클래스에서 모바일 모니터링 에이전트를 시작하는 것은 지원되지 않습니다.
모바일 모니터링을 초기화하려면: onCreate() 메서드에서 다음 호출을 추가합니다.
```
NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplication());
```
선택 사항: 로깅 수준을 변경합니다.
애플리케이션 빌드 및 실행하려면: 프로젝트를 삭제한 후 에뮬레이터 또는 디바이스에서 앱을 실행하여 트래픽을 생성합니다.
몇 분 정도 기다린 다음 Summary 페이지에서 Android 앱에 대한 데이터를 확인합니다. one.newrelic.com > All capabilities > Mobile > (select an app)으로 이동합니다.

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

이 문서가 설치하는데 도움이 되셨나요?

Android 설치 업데이트

Android 에이전트를 최신 상태로 유지하려면 절차에 따라 뉴렐릭용 Android 에이전트 SDK를 업그레이드합니다. 모바일 앱용 최신 Android 버전 설치: one.newrelic.com > All capabilities > Mobile > (select an app) > Settings > Installation으로 이동합니다.

Android 4.x: 멀티덱스(multidex) 지원

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

멀티덱스 앱을 위해 각 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 빌드 중에 모바일 모니터링 에이전트 플러그인의 동작을 구성하는 방법에 대한 자세한 내용은 뉴렐릭 Gradle 플러그인 확장 가이드를 참조하십시오.