Android 에이전트 호환성 및 요구 사항

기능은 Google Play Store, Amazon Appstore 등을 포함한 표준 애플리케이션 스토어와 호환됩니다. Android 애플리케이션과 함께 모바일 에이전트를 설치하고 구성하기 전에 호환성 및 기타 요구 사항에 대한 다음 지침을 따르십시오.

포그라운드 모니터링

Android 에이전트는 앱이 포그라운드에 있는 동안에만 앱을 모니터링합니다. 에이전트는 앱이 닫혀 있는 동안 백그라운드 서비스를 모니터링하지 않습니다. 자세한 내용은 모바일 데이터 개인 정보 보호 및 보안 문서 를 참조하십시오.

안드로이드 호환성

Android 앱이 다음 요구 사항을 충족하는지 확인하세요.

요소	신청 요건
운영 체제	안드로이드 7.0 이상
API/SDK	HttpURLConnection, OkHttp2(버전 2.0 및 2.4 제외), OkHttp(버전 2.8, 3.5+, 4.0+), OkIO(버전 1.11), AndroidHttpClient, Volley(버전 1.0.0) 및 Apache HTTP 클라이언트 네트워킹 API 중요 AndroidHttpClient는 버전 23의 SDK에서 제거되었으며 Android 에이전트 버전 6.5.0 이하에서만 지원됩니다. Android agent version 7.0.0 or higher 다음이 필요합니다: Android 스튜디오 플라밍고 그래들 7.2 Android Gradle 플러그인 7.0.0 DexGuard 9.0 이상 Android agent version 6.6.0 or higher Android SDK Tools version 24 or higher 필요합니다. Android SDK 도구 버전 24 이상의 경우 다음 요구 사항도 충족해야 합니다. 안드로이드 스튜디오 그라들 5.1.1 Android Gradle 플러그인 3.4 프로가드 5.0 DexGuard 8.0 - 9.x 이전 Android 에이전트 버전의 경우 빌드의 Android SDK 도구 버전이 Android 에이전트 버전과 호환되어야 합니다. Android agent version 6.0.0 through 6.5.0 빌드를 Android SDK Tools version 21 or higher 으로 컴파일해야 합니다. Android agent version 5.0.0 through 5.9.9 빌드를 Android SDK Tools version 14 or higher 으로 컴파일해야 합니다. 참고: Android 에이전트를 설치하기 전에 SDK 도구를 최신 버전으로 업그레이드해야 합니다. 중요 2022년 5월 현재 Android Gradle 플러그인 버전 7.2.1 릴리스는 ASM API와 함께 사용할 때 변환 API를 중단하며, 이는 New Relic Android 에이전트 기능에 영향을 미쳤습니다. 이 문제는 Android Gradle 플러그인 버전 7.2.2 에서 수정되었습니다.
언어	Java 1.7 - Java 9. JDK 11은 버전 6.2.0 이상에서 지원됩니다. JDK 17은 버전 7.0.0 이상에서 지원됩니다.
장치	모든 Android 호환 기기(스마트폰, 태블릿, Android TV, Amazon Fire 등)
파일 크기	에이전트가 출시 APK에 500KB 미만을 추가합니다.
아키텍처	ARM, 인텔 아톰
서명 검증	에이전트는 서명하는 동안 서명 유효성 검사 를 사용하는 JAR을 계측할 수 없습니다. `SHA1-Digest` 또는 `SHA-256-Digest` 속성을 포함하는 매니페스트가 있는 JAR은 수정되지 않습니다.

에이전트 및 Gradle 호환성

다음은 New Relic Android 에이전트, Gradle 및 Android Gradle 플러그인 의 호환 버전입니다.

중요

2021년 1월부터 Android 에이전트는 Android Gradle 플러그인 버전 2에 대한 지원을 중단했습니다. 자세한 내용은 지원 포럼 게시물 을 참조하세요.

안드로이드 Gradle 플러그인	New Relic Android 에이전트 호환성
2.3	버전 6.0 이상에서는 더 이상 지원되지 않습니다. 5.25 - 5.26 은 지원되지 않습니다.
3.0 - 3.3	버전 6.0 이상에서는 더 이상 지원되지 않습니다.
3.4	5.25 이상
4.+	5.26 이상
7.1.0	6.2.0 이상
8.+	7.0.0 이상

코틀린과 코틀린 DSL

Gradle 및 New Relic의 Android 에이전트와 함께 Kotlin 프로젝트를 사용할 수도 있습니다.

Android 에이전트 버전별 Kotlin DSL 지원

Android Gradle 플러그인 에서 언급된 비호환성을 제외하고, 뉴렐릭의 Android 에이전트는 Kotlin Gradle 플러그인의 1.3 - 1.4 버전과 호환됩니다.

코틀린 DSL 버전	New Relic Android 에이전트 호환성
1.2	지원되지 않음
1.3	5.24 and lower: Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다. 5.25: Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다. 5.26: Android 에이전트 버전 5.26.0-5.28.0에서는 지원되지 않습니다.
1.4	5.24 and lower: Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다. 5.25: 지원 5.26: Android 에이전트 버전 5.26.0-5.28.0에서는 지원되지 않습니다.

AGP 버전별 Kotlin DSL 지원

Kotlin DSL 지원은 공식적으로 버전 4.1의 Android Gradle 플러그인에 추가되었지만 많은 개발자가 이미 Groovy 대신 이를 사용하고 있습니다.

코틀린 DSL 버전	Android Gradle 플러그인 및 Android Gradle 호환성
1.3	3.2 (AGP), 4.6 (Gradle) : Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다. 3.3 (AGP), 5.1.1 (Gradle): Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다. 3.4 (AGP), 5.1.1 (Gradle): Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다. 3.5 (AGP), 5.4.1 (Gradle): Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다. 3.6 (AGP), 5.6.4 (Gradle): Kotlin Gradle 플러그인 버전 1.3.40 이상이 필요합니다. 4.0 (AGP), 6.1.1 (Gradle): Kotlin Gradle 플러그인 버전 1.3.40 이상이 필요합니다. 4.1 (AGP), 6.5 (Gradle): Kotlin Gradle 플러그인 버전 1.3.40 이상이 필요합니다.
1.4	3.2 (AGP), 4.6 (Gradle) : Gradle 5.3 필요 3.3 (AGP), 5.1.1 (Gradle): Gradle 5.3 필요 3.4 (AGP), 5.1.1 (Gradle): 지원 3.5 (AGP), 5.4.1 (Gradle): 지원 3.6 (AGP), 5.6.4 (Gradle): 지원 4.0 (AGP), 6.1.1 (Gradle): 지원 4.1 (AGP), 6.5 (Gradle): 지원

코틀린 DSL 버전

Android Gradle 플러그인 및 Android Gradle 호환성

1.3

3.2 (AGP), 4.6 (Gradle) :
Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다.
3.3 (AGP), 5.1.1 (Gradle):
Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다.
3.4 (AGP), 5.1.1 (Gradle):
Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다.
3.5 (AGP), 5.4.1 (Gradle):
Kotlin Gradle 플러그인 버전 1.3.10 이상이 필요합니다.
3.6 (AGP), 5.6.4 (Gradle):
Kotlin Gradle 플러그인 버전 1.3.40 이상이 필요합니다.
4.0 (AGP), 6.1.1 (Gradle):
Kotlin Gradle 플러그인 버전 1.3.40 이상이 필요합니다.
4.1 (AGP), 6.5 (Gradle):
Kotlin Gradle 플러그인 버전 1.3.40 이상이 필요합니다.

1.4

3.2 (AGP), 4.6 (Gradle) :
Gradle 5.3 필요
3.3 (AGP), 5.1.1 (Gradle):
Gradle 5.3 필요
3.4 (AGP), 5.1.1 (Gradle):
지원
3.5 (AGP), 5.4.1 (Gradle):
지원
3.6 (AGP), 5.6.4 (Gradle):
지원
4.0 (AGP), 6.1.1 (Gradle):
지원
4.1 (AGP), 6.5 (Gradle):
지원

단위 테스트가 지원되지 않음

New Relic 모바일 에이전트는 일반적인 앱 수명 주기에서 작동하도록 설계 및 테스트되었습니다. 에이전트를 사용하여 애플리케이션에서 테스트 환경을 실행하는 것은 지원하지 않습니다. 테스트는 충돌과 예측할 수 없는 동작을 유발할 수 있습니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.