Android 에이전트를 설치하려면 안내 설치를 따르는 것이 좋습니다.
- one.newrelic.com > Integrations & Agents > Mobile > Android으로 이동합니다.
- 안내 설치의 단계에 따라 Android 에이전트를 설정합니다.
- 몇 분 정도 기다린 후 one.newrelic.com > All capabilities > Mobile > (select your app)으로 이동하여 데이터를 확인합니다.
Android 에이전트 수동 설치 방법
아래 단계는 안내 설치에 대한 설명입니다. 에이전트를 수동으로 설치하는 경우에도, 뉴렐릭 앱을 만들고 생성된 애플리케이션 토큰을 확보해야 합니다. 에이전트가 뉴렐릭으로 데이터를 전송하려면 토큰이 반드시 필요합니다.
프로젝트에 Android 에이전트 플러그인을 추가합니다.
플러그인의 위치와 관련해서는 두 가지 옵션이 있습니다.
권장 옵션: Gradle 플러그인 DSL 사용
- 에이전트 버전 7.6.0부터 Android 에이전트 플러그인을 Gradle 플러그인 포털에서 커뮤니티 플러그인으로 사용할 수 있습니다. 추가할 수 있도록 해줍니다.
- 이 방법은 에이전트 플러그인 종속성을 프로젝트의 플러그인 DSL 블록에 추가하는 작업이 포함됩니다.
기존 플러그인 ID(
newrelic) 사용- 이전 프로젝트나 특정 사용 사례의 경우 기존 플러그인 ID를 사용할 수 있습니다.
- 이 방법은 에이전트를 프로젝트의 빌드 스크립트에 종속성으로 추가하고 MavenCentral 저장소를 지정하는 작업이 필요합니다.
선택한 설치 방법에 따라 아래의 세부적인 단계를 따릅니다.
중요
뉴렐릭은 에이전트가 에이전트 버전 7.6.8 이상에 대해 캡처된 데이터를 전달하는 HTTP 요청을 할 수 있도록 다음 권한을 자동으로 추가합니다.
AndroidManifest.xml 파일에서 다음 권한을 추가합니다.
<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />앱이 어떤 Activity에서 열리든 Android가 Activity를 생성하기 전에 에이전트가 실행되도록 Application 클래스의 onCreate() 메서드에서 에이전트를 시작합니다.
앱에 이미 Application 하위 클래스가 있는 경우, 가져오기 구문과 아래의 start() 호출을 추가합니다. 앱에 없는 경우, 생성합니다:
import android.app.Application;import com.newrelic.agent.android.NewRelic;
public class MyApplication extends Application { @Override public void onCreate() { super.onCreate(); NewRelic.withApplicationToken("GENERATED_TOKEN").start(this); }}GENERATED_TOKEN을 앱 토큰으로 교체합니다(뉴렐릭에서 앱을 생성할 때 생성합니다).
새 Application 클래스를 생성한 경우, <application> 요소에 android:name 속성을 추가하여 AndroidManifest.xml에 등록합니다:
<application android:name=".MyApplication" ... >이 단계가 없으면 Android가 클래스를 생성하지 않으며 에이전트가 시작되지 않습니다.
정규화된 클래스 이름이나 점으로 시작하는 이름(예: .MyApplication)을 사용하십시오. Android는 이를 앱의 패키지와 비교 확인합니다.
(선택 사항) Proguard/Dexguard를 위한 추가 설정
ProGuard 또는 Dexguard를 사용하여 코드를 축소하는 경우 다음 단계를 따릅니다.
앱 수준 디렉터리에
newrelic.properties파일을 만듭니다. (예:/projectname/app/newrelic.properties)생성된 파일에 다음 줄을 추가하고
GENERATED_TOKEN을 실제 토큰으로 교체합니다.com.newrelic.application_token=GENERATED_TOKEN
중요
에이전트 버전 7.6.8 이상에 대해서는 proguard 규칙이 자동으로 추가됩니다.
- Android 앱을 위한 ProGuard 또는 DexGuard 구성에 설명된 단계를 따릅니다.
프로젝트를 삭제한 후 에뮬레이터 또는 디바이스에서 앱을 실행하여 트래픽을 생성합니다. 에이전트가 해당 데이터를 캡처하는 동안 몇 분 정도 기다립니다.
one.newrelic.com > All capabilities > Mobile > (select an app)으로 이동하여 뉴렐릭에 있는 앱 데이터를 확인합니다.
에이전트를 시작할 위치 선택
Application.onCreate()에서 에이전트를 시작하는 것을 권장합니다. Android는 어떠한 Activity보다 먼저 Application 클래스를 생성하므로, 앱이 일반적인 출시 Activity에서 열리든, 푸시 알림, 딥 링크, 앱 바로 가기, 위젯 등 다른 곳에서 열리든 에이전트가 실행됩니다.
여전히 Activity의 onCreate() 메서드에서 에이전트를 시작할 수 있습니다. 그러면, 에이전트는 해당 Activity에 도달하는 시작에 대해서만 실행됩니다. start() 호출을 Application 클래스로 이동하는 경우, 이를 Activity에서 제거합니다.
다음 사항에 유의하십시오.
- 에이전트를 한 번 시작합니다. 에이전트는 이미 실행 중일 때
start()에 대한 모든 호출을 무시하므로, 두 곳 모두에 호출을 남겨두어도 에이전트가 두 번 시작되지 않습니다. - Android는 앱이 선언하는 모든 프로세스에서
Application.onCreate()를 실행합니다. 구성 요소 중 하나라도android:process를 설정하면, 에이전트는 해당 각 프로세스에서도 시작되며 각각 자체 세션을 보고합니다. 코드가 앱의 기본 프로세스에서 실행 중일 때만 에이전트를 시작합니다. start()호출하는 스레드에서 작은 파일을 읽고 쓰므로, StrictMode는 이를 호출하는 모든 위치의 기본 스레드에서 디스크 액세스를 보고할 수 있습니다.
다음 단계는?
축하합니다. Android 에이전트 설치가 완료되었습니다. 다음 단계에는 몇 가지 옵션이 있습니다.
- 뉴렐릭 Gradle 플러그인을 사용하여 Gradle 빌드 중에 에이전트 동작을 구성합니다.
- Android 에이전트 SDK를 업그레이드하여 Android 에이전트를 최신 상태로 유지합니다.
- Android 설치에 문제가 있는 경우, 문제 해결 절차를 따르십시오.
Android 4.x: 멀티덱스(multidex) 지원
Android 5.0(API 레벨 21) 이전 Android 버전에 대한 모바일 모니터링은 Dalvik 런타임을 사용하여 앱 코드를 실행합니다. 기본적으로 Dalvik은 앱을 APK당 단일 classes.dex 바이트 코드 파일로 제한합니다. 이 제한 사항을 해결하려면 multidex 지원을 활성화해야 합니다. 그러면 앱의 기본 DEX 파일의 일부가 되는 multidex 지원 라이브러리를 사용할 수 있습니다. 라이브러리는 추가 DEX 파일과 해당 파일이 포함된 코드에 대한 액세스를 관리합니다.