Gradle 및 Android Studio로 Android 앱 구성

Android 에이전트를 설치하면 성능, 안정성 및 사용자 참여를 개선하도록 모바일 앱을 구성할 수 있습니다. Gradle 및 Android Studio를 사용하는 경우 아래 단계를 따릅니다.

Gradle 및 Android Studio로 구성

Gradle 및 Android Studio로 Android 앱을 구성하는 절차는 Android UI 안내 설치의 "DSL 코드 추가" 단계에도 표시됩니다.

1. 플러그인이 적용되기 전에 프로젝트의 최상위 레벨 build.gradle 파일에서 다음 코드를 병합하거나 추가합니다.

   프로젝트 레벨 build.gradle 파일:

   프로젝트 레벨 구성은 프로젝트의 모든 앱에 대한 에이전트를 구성하는 데 사용됩니다. 여기에는 프로젝트 토큰 설정, 기능 활성화 또는 비활성화, 알림 임계값 설정이 포함됩니다. 이 예에서, AGENT_VERSION은 에이전트 버전 번호를 나타냅니다. 에이전트 릴리스 정보에서 최신 버전이 사용되고 있는지 확인합니다.

   buildscript {
       repositories {
       mavenCentral()
       }
   
       dependencies {
       classpath "com.newrelic.agent.android:agent-gradle-plugin:AGENT_VERSION"
       }
   }

   복사

   앱 레벨 build.gradle 파일:

   특정 앱에 대한 설정을 구성하려면 앱 레벨 구성을 사용합니다. 이 예에서, AGENT_VERSION은 에이전트 버전 번호를 나타냅니다. 에이전트 릴리스 정보에서 최신 버전이 사용되고 있는지 확인합니다.

   repositories {
       mavenCentral()
   }
   
   apply plugin: 'android'
   apply plugin: 'newrelic'
   
   dependencies {
       implementation 'com.newrelic.agent.android:android-agent:AGENT_VERSION'
   }

   복사

2. (선택 사항) ProGuard 또는 DexGuard의 경우:

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

   com.newrelic.application_token=GENERATED_TOKEN

   복사

   b. Android 앱을 위한 ProGuard 또는 DexGuard 구성에서 명시된 구성 단계를 완료합니다. 그런 다음 이 페이지로 돌아와 다음 단계로 이동합니다.

3. 앱 권한을 설정합니다. AndroidManifest.xml 파일에 다음 행을 추가하여 Android 앱이 INTERNET 및 ACCESS_NETWORK_STATE 권한을 요청하도록 합니다.

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

   복사

4. Android 에이전트를 시작합니다. Default Activity (Manifest에 정의된 대로)에서 NewRelic 클래스를 가져옵니다.

   import com.newrelic.agent.android.NewRelic;

   복사

   중요

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

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

   NewRelic.withApplicationToken("GENERATED_TOKEN").start(this.getApplication());

   복사

6. (선택 사항) 로깅 레벨을 변경합니다.

7. 애플리케이션을 빌드하고 실행합니다. 프로젝트를 삭제한 후 에뮬레이터 또는 디바이스에서 앱을 실행하여 트래픽을 생성합니다.

8. 몇 분 정도 기다린 다음 Summary 페이지에서 Android 앱에 대한 데이터를 확인합니다. one.newrelic.com > Mobile > (select an app)으로 이동합니다.

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

Android 앱에 대한 multidex 지원을 활성화하여 64K 레퍼런스 제한을 피하는 방법은 아래 설명을 확인하시기 바랍니다.

Multidex 지원 활성화

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

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