Android Instant Apps용 New Relic 플러그인 설치

Android Instant Apps 를 사용하면 사용자가 설치 없이 애플리케이션을 빠르게 사용할 수 있습니다. Android 에이전트 버전 5.17.0 이상에서는 New Relic을 사용하여 인스턴트 앱의 모든 기능 모듈을 감지하고 계측할 수 있습니다.

이 문서를 표준 New Relic 절차와 함께 사용 하여 Gradle 및 Android Studio로 Android 앱을 설치 합니다. 표준 설치 절차를 따른 후 Android 빠른 실행 앱에 대해 다음 추가 단계를 따르세요.

술어

이 절차에서는 Android Instant Apps 플러그인과 관련된 다음 용어를 사용합니다.

• 모듈 : 패키지된 클래스 및/또는 리소스 컬렉션
• APK : 앱 리소스와 DEX 클래스를 패키징하는 모듈
• 기능 모듈 : 전체 APK의 하위 집합만 포함하는 슬림형 모듈

플러그인 설치

Android Instant Apps용 New Relic 플러그인을 설치하려면:

1. 먼저 Gradle 및 Android Studio로 Android 앱 설치 문서의 단계를 따르세요.

2. 모든 프로젝트 Gradle 빌드 파일에 에이전트 플러그인을 적용합니다.

3. Android 에이전트를 종속성으로 나열합니다.

4. Digital Asset Link 인텐트(예: mobile.example.com/signin)를 통해 테스트용으로 로드할 수 있는 기능의 각 활동 클래스 에서 에이전트를 시작합니다.

   최소 build.gradle 예제

   apply plugin: 'com.android.[application|library|feature|instantapp]'
   apply plugin: 'newrelic'
   
   dependencies {
       implementation "com.newrelic.agent.android:android-agent:${project.agentVersion}"
   }

   카피

5. 계측 에 대한 고려 사항을 검토합니다.

수단

빠른 실행 앱을 계측할 때 APK와 관련된 다음 고려 사항에 유의하세요.

ProGuard 및 Dexguard 지원

Android Studio Gradle 플러그인은 minifyEnabled 가 true 으로 설정된 모든 빌드 구성을 난독화합니다. 이러한 조건에서 New Relic 에이전트는 빌드용으로 생성된 ProGuard 맵을 에이전트가 생성한 고유한 빌드 ID로 태그가 지정된 충돌 수집기로 전달합니다.

난독화는 다른 모듈을 종속성으로 포함하는 애플리케이션 또는 인스턴트 앱 프로젝트에서 가장 잘 구성됩니다. 모듈은 필요에 따라 ProGuard를 구성할 수 있습니다.

자동 계측 문제 해결

에이전트가 빠른 실행 앱 프로젝트를 자동 계측하는지 여부가 아닌 경우 다음 단계를 실행해 보세요.

1. debug ( -d , --debug ) 옵션으로 앱을 빌드하고 빌드 로그를 캡처합니다.

2. 다음 용어 중 하나를 찾아 로그에서 인스턴트 앱의 증거를 검색합니다.

   • This appears to be an Instant App

     카피

   • BuildId[1a2b34c5-def6-7890-g123-h4567890a]

     카피

3. 앱이 빠른 실행 앱인 경우 에이전트는 'instantApp' 이라는 속성을 앱의 세션 속성에 추가합니다.