Android 에이전트 설치 방법

프로젝트에 Android 에이전트 플러그인을 추가합니다.

플러그인의 위치와 관련해서는 두 가지 옵션이 있습니다.

• 권장 옵션: Gradle 플러그인 DSL 사용

  • 에이전트 버전 7.6.0부터 Android 에이전트 플러그인을 Gradle 플러그인 포털에서 커뮤니티 플러그인으로 사용할 수 있습니다. Gradle 플러그인 DSL은 앱에 플러그인 종속성을 쉽게
  • 이 방법은 에이전트 플러그인 종속성을 프로젝트의 플러그인 DSL 블록에 추가하는 작업이 포함됩니다.

• 기존 플러그인 ID(newrelic) 사용

  • 이전 프로젝트나 특정 사용 사례의 경우 기존 플러그인 ID를 사용할 수 있습니다.
  • 이 방법은 에이전트를 프로젝트의 빌드 스크립트에 종속성으로 추가하고 MavenCentral 저장소를 지정하는 작업이 필요합니다.

  선택한 설치 방법에 따라 아래의 세부적인 단계를 따릅니다.

  (권장) 플러그인 DSL 블록을 사용하여 플러그인 적용

  Gradle에서 플러그인 종속성을 관리하기 위해 권장되는 접근 방식은 플러그인 DSL 블록을 활용합니다. 이 섹션에서는 구조 내에서 플러그인 ID(com.newrelic.agent.android)의 유효한 형식을 적용하는 방법을 자세히 설명합니다.

  1. Gradle 플러그인 포털 플러그인 ID를 사용해 최상위 build.gradle(.kts) 파일에 뉴렐릭 플러그인을 선언합니다.

     plugins {
       // for binary Gradle plugins that need to be resolved
       id("com.newrelic.agent.android") version "AGENT_VERSION" apply false
     }

     카피

     AGENT_VERSION을 에이전트 버전 번호로 바꿔야 합니다. 최신 버전을 사용할 것을 적극 권장합니다.

  2. 다음 구문을 사용하여 앱 수준 빌드 파일(및 계측을 위한 모든 하위 모듈)에 플러그인을 명시적으로 적용합니다.

     plugins {
       id("com.newrelic.agent.android")
     }

     카피

     Gradle 내에서 플러그인을 적용하는 방법에 대한 자세한 내용은 Gradle 문서를 참조하십시오.

  buildscript{} 블록을 사용해 플러그인을 적용합니다.

  Android 에이전트 플러그인은 MavenCentral에서 사용할 수 있으며 이전 프로젝트와의 호환성을 위해 플러그인 ID newrelic을 사용합니다. 기존 앱에 이 ID를 사용하는 경우, MavenCentral에 대한 클래스 경로를 명시적으로 구성해야 합니다. 그래야 빌드 프로세스 중에 Gradle이 플러그인을 찾을 수 있습니다. 플러그인을 해결하는 다양한 방법은 Gradle 문서를 참조하십시오.

  Gradle 플러그인 포털보다 MavenCentral을 선호하는 경우, Gradle 파일을 다음과 같이 변경해야 합니다.

  1. 이 스니펫을 최상위 build.gradle(.kts) 파일에 추가합니다.

     buildscript {
       repositories {
         mavenCentral()
       }
     
       // not required if plugin classpath in resolutionStrategy{} below
       dependencies {
         classpath "com.newrelic.agent.android:agent-gradle-plugin:AGENT_VERSION"
       }
     }

     카피

  2. pluginManagement {} 블록을 통해 settings.gradle(.kts) 파일에 이 스니펫을 추가합니다.

     pluginManagement {
       repositories {
         mavenCentral()  // adds repo for NewRelic artifacts
       }
       resolutionStrategy {
         eachPlugin {
           // not required if using `classpath dependency` above
           if (requested.id.id.startsWith("newrelic") || requested.id.id.startsWith("com.newrelic.agent.android"))) {
             useModule("com.newrelic.agent.android:agent-gradle-plugin:${AGENT_VERSION}")
           }
         }
       }
       plugins {
          id("newrelic") apply false
       }
     }

     카피

     AGENT_VERSION을 에이전트 버전 번호로 바꿔야 합니다. 최신 버전을 사용할 것을 적극 권장합니다.

  3. 플러그인을 앱 수준 빌드 파일과 계측될 다른 모든 하위 모듈에 적용합니다.

     plugins {
       id("newrelic")
     }

     카피

AndroidManifest.xml 파일에서 다음 권한을 추가합니다.

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

onCreate 메서드 내의 기본 Activity 클래스에 다음 import 문을 추가합니다.

import com.newrelic.agent.android.NewRelic;

참고: Activity 클래스에 이 import 문을 추가해야 합니다. 다른 클래스에서 에이전트를 시작하는 것은 지원되지 않습니다.

onCreate 메서드에서, 다음 줄을 추가합니다. 이때 GENERATED_TOKEN을 실제 앱 토큰(안내 설치 중에 생성됨)으로 바꿔야 합니다.

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

(선택 사항) Proguard/Dexguard를 위한 추가 설정

ProGuard 또는 Dexguard를 사용하여 코드를 축소하는 경우 다음 단계를 따릅니다.

1. 앱 수준 디렉터리에 newrelic.properties 파일을 만듭니다. (예: /projectname/app/newrelic.properties)

2. 생성된 파일에 다음 줄을 추가하고 GENERATED_TOKEN 을 실제 토큰으로 교체합니다.

   com.newrelic.application_token=GENERATED_TOKEN

   카피

3. Android 앱을 위한 ProGuard 또는 DexGuard 구성에 설명된 단계를 따릅니다.

프로젝트를 삭제한 후 에뮬레이터 또는 디바이스에서 앱을 실행하여 트래픽을 생성합니다. 에이전트가 해당 데이터를 캡처하는 동안 몇 분 정도 기다립니다.

one.newrelic.com > All capabilities > Mobile > (select an app)으로 이동하여 뉴렐릭에 있는 앱 데이터를 확인합니다.