Android 앱 및 라이브러리 개발자는 모두 원활한 사용자 환경을 제공하는 고성능 앱이라는 동일한 목표를 달성하기 위해 노력합니다. 이러한 노력의 상당 부분은 Android의 앱 최적화 도구인 R8과 관련이 있습니다. R8은 사용되지 않는 코드를 삭제하고 나머지를 최적화 및 난독화하여 앱 성능을 개선합니다.
Google Play는 최근 앱과 게임의 시작 시간을 개선하고 메모리 사용량을 줄이며 과도한 메모리를 사용하는 앱으로부터 사용자 환경을 보호하려는 Android의 노력에 부합하는 새로운 DEX 코드 최적화 기준을 발표했습니다. 이러한 기준점은 앱과 게임에 적용되지만, 이를 충족하는 것은 생태계 전반의 공동 책임입니다. R8은 앱이 종속된 라이브러리에서 번들로 제공하는 유지 규칙을 포함하여 주어진 매개변수 내에서만 앱을 최적화할 수 있습니다.
R8 구성 분석기는 앱 최적화, 축소, 난독화 비율을 평가하는 데 유용한 도구로, Google Play의 기술 요구사항에서 핵심적인 역할을 합니다. R8 구성 분석기는 이러한 비율을 추적하는 것 외에도 앱뿐만 아니라 앱이 종속된 라이브러리에 번들로 포함된 소비자 유지 규칙에서 발생하는 비효율적인 유지 규칙도 표시합니다.
이 가이드에서는 라이브러리 제공업체가 직면하는 가장 일반적인 문제를 해결하고 좁고 고성능의 규칙을 제공하여 고객이 Google Play 기술 요구사항을 충족하도록 지원하는 방법을 설명합니다.
소비자 보관 규칙이란 무엇인가요?
소비자 유지 규칙은 Android 또는 JAR 라이브러리 내에 번들로 제공되는 명령어로, 앱 수준 컴파일 프로세스 중에 라이브러리 코드의 어떤 부분을 최적화할 수 없는지 R8에 알려줍니다. 아티팩트 축소에 사용되는 앱 또는 라이브러리에서 작성한 표준 유지 규칙과 달리 소비자 유지 규칙은 라이브러리 내에 삽입되며 전체 앱 최적화 중에 라이브러리가 축소되는 방식에 영향을 미칩니다. 이를 통해 앱 개발자가 수동으로 식별하지 않아도 내부 리플렉션 타겟과 네이티브 인터페이스가 그대로 유지됩니다.
의도적이고 범위가 좁은 소비자 유지 규칙은 라이브러리와 라이브러리를 사용하는 앱 모두에 도움이 되는 중요한 권장사항입니다. 지나치게 광범위한 소비자 보존 규칙은 사용되지 않는 코드를 보존하므로 앱의 최적화와 성능에 영향을 미칩니다. DEX 코드 최적화 인사이트가 Play Console에 추가됨에 따라 앱 개발자에게 표시되는 측정항목은 앱과 통합 라이브러리의 규칙이 결합된 영향을 나타냅니다.
안정성과 성능의 균형
라이브러리 제공업체는 광범위한 소비자 유지 규칙을 제공하는 데 선의를 가지고 있는 경우가 많습니다. 리플렉션 중에 클래스 삭제로 인해 SDK에서 비정상 종료가 발생하는 것을 원하는 사람은 없습니다.
그러나 패키지 전체 또는 광범위한 유지 규칙은 R8의 전체 프로그램 앱 최적화 가능성을 심각하게 제한하므로 비정상 종료 방지를 위한 장기적인 솔루션으로 권장되지 않습니다. 다음은 안정성을 유지하면서 좁은 범위의 고성능 규칙을 배포하는 데 도움이 되는 몇 가지 권장 전략입니다.
1. 좁은 범위의 규칙 테스트 및 출시
좁은 범위의 규칙을 안심하고 출시하려면 다음 권장사항을 고려하세요.
- 샘플 앱에서 테스트: 최적화 테스트의 로컬 테스트 가이드는 샘플 앱에도 적용됩니다. R8을 사용 설정한 후 중요한 사용자 여정을 테스트하여 기능이 예상대로 작동하는지 확인합니다.
- 샘플 앱에서 R8 구성 분석기를 실행하여 앱 개발자가 R8 구성을 감사할 때 표시되는 내용을 확인합니다. 이를 통해 보관 규칙이 다운스트림 앱에 미치는 영향을 쉽게 시각화할 수 있습니다.
- Android CLI의 analyze 명령어를 사용하여 유지된 메서드, 클래스, 필드를 비롯한 AAR 또는 JAR의 최적화를 평가합니다. 출시 버전 간에 이러한 수치를 비교하여 회귀를 모니터링할 수 있습니다.
- Google Play SDK Console에서 라이브러리 버전 사용량과 비정상 종료를 모니터링합니다.
- 라이브러리 작성자를 위한 최적화 가이드와 R8 문서에서 권장사항을 참고하세요.
2. 광범위한 keep 규칙 없이 리플렉션 및 JNI 타겟 보존
광범위한 또는 패키지 전체 보존 규칙이 있는 라이브러리를 제공하면 SDK에만 영향을 미치는 것이 아니라 개발자가 앱 시작 시간을 늦추고 앱 다운로드 크기, 메모리 사용량, ANR 발생률을 증가시키는 코드 비대화를 수용해야 합니다. 성능을 중시하는 앱은 라이브러리와 함께 번들로 제공되는 규칙을 대체하는 맞춤 규칙을 작성할 수도 있습니다. 이 경우 위험을 줄이기 위해 향후 라이브러리 업데이트를 채택하지 않을 수도 있습니다.
SDK가 게임이나 사진 및 동영상 편집기와 같은 네이티브 코드를 타겟팅하는 경우 JNI를 사용하는 모든 클래스에 규칙을 제공합니다. 대부분의 게임은 게임을 네이티브 코드로 컴파일하는 Unity 및 Unreal과 같은 게임 엔진을 기반으로 실행됩니다. 게임 네이티브 코드와 플러그인은 JNI 호출을 통해 Android 프레임워크와 통신합니다.
현재 알파 버전인 Jetpack Keep 주석을 사용하면 리플렉션 사용에 주석을 달 수 있어 리플렉션에 필요한 유지보수를 줄일 수 있습니다. 이 주석은 빌드 시 유지 규칙을 생성하는 데 사용할 수 있습니다.
리플렉션 대신 코드 생성 고려
리플렉션으로 인한 비정상 종료를 방지하기 위한 가장 중요한 팁은 리플렉션을 피하고 가능한 경우 codegen을 사용하는 것입니다.
런타임 리플렉션은 컴파일 중에 R8에서 코드 사용을 숨기므로 비정상 종료를 방지하기 위해 유지 규칙이 필요합니다. codegen을 사용하면 빌드 프로세스 중에 코드가 최적화되므로 R8이 최소한의 유지 규칙으로 코드를 안전하게 최적화하는 데 필요한 가시성을 확보할 수 있습니다. 코드 생성이 적합한 일반적인 시나리오에는 직렬화 및 역직렬화, 종속 항목 삽입이 포함됩니다(Hilt는 코드 생성을 사용하는 라이브러리의 예).
하지만 코드 생성은 모든 시나리오에 적합한 선택은 아닙니다. 선택적 종속 항목과 같은 패턴의 경우 리플렉션이 여전히 필요합니다. 선택적 종속 항목을 지원하는 리플렉션에 관한 가이드에 설명된 대로 리플렉션을 필수 진입점만 보호하는 좁은 범위의 유지 규칙과 페어링하는 것이 좋습니다.
사전 최적화된 라이브러리 빌드의 경우에도 규칙 범위를 좁게 지정
리플렉션을 피할 수 없는 경우 소비자 유지 규칙이 라이브러리가 반영하는 항목만 지정하도록 합니다. 라이브러리가 클래스나 메서드에 동적으로 액세스하는 경우 진입점만 지정하면 R8이 나머지를 처리합니다. R8은 진입점을 사용하여 참조된 코드의 그래프를 빌드하고 참조되지 않은 클래스, 메서드, 필드를 삭제합니다.
이는 이미 라이브러리 빌드를 최적화하거나 난독화한 경우에도 적용되며, 이는 성능이 우수하고 가벼운 SDK를 보장하는 좋은 방법입니다. 규칙은 앱의 컴파일 단계에서 적용되므로 R8은 다운스트림 앱에서 사용하는 실제 클래스와 메서드를 기반으로 라이브러리를 더 최적화할 수 있습니다. Android CLI 분석 명령어는 최적화 차단에 기여하는 사용된 패키지 전체 유지 규칙과 사용되지 않은 패키지 전체 유지 규칙을 모두 사전에 표시합니다.
서드 파티 종속 항목에 대한 유지 규칙의 범위를 좁게 설정
이는 다음과 같은 일반적인 패턴입니다.
-keep public class com.google.android.gms.** { *; }SDK를 통합하는 앱이 다른 GMS 라이브러리도 사용하고 유지되는 코드의 양을 제한하는 유지 규칙을 포함하는 경우 이 광범위한 규칙이 이를 대체하여 불필요한 앱 비대화를 초래합니다.
외부 라이브러리를 호출할 때는 리플렉션을 통해 라이브러리가 액세스하는 특정 요소만 엄격하게 보존하는 유지 규칙을 설계해야 합니다. 또한 GMS를 비롯한 많은 라이브러리가 이미 자체 소비자 유지 규칙을 제공하고 있습니다. 패키지 전체 유지 규칙을 도입하면 다운스트림 라이브러리에서 신중하게 작성되고 범위가 좁은 소비자 규칙도 포함할 수 있습니다.
광고 미디에이션 어댑터에 조건부 유지 규칙 고려
미디에이션 어댑터를 사용하여 광고 라이브러리를 로드하는 경우에도 좁은 유지 규칙을 사용할 수 있습니다. 이 시나리오에서는 앱에 해당 어댑터가 포함된 경우에만 특정 기능이나 형식을 보존하도록 조건부 보관 규칙을 사용하는 것이 좋습니다. 이렇게 하면 R8이 앱에서 사용하지 않는 기능을 축소할 수 있습니다. 또 다른 옵션으로, 복잡한 규칙을 직접 작성하는 대신 Jetpack Keep 주석을 사용하여 소스 코드에서 직접 리플렉션 호출에 주석을 달고 선택적 부가기능 모듈을 포함한 조건부 소비자 유지 규칙을 자동으로 생성할 수도 있습니다.
문서가 아닌 소비자 규칙에 규칙을 적용
라이브러리와 함께 소비자 규칙을 제공하면 R8 지원 빌드가 있는 앱에서 라이브러리를 즉시 사용하고 최적화를 극대화할 수 있습니다.
문서에 규칙을 지정하면 수동 설정 마찰이 추가되고(특히 번들로 제공되는 소비자 유지 규칙이 수년 동안 AAR 및 JAR에서 지원되었기 때문) 지속적인 유지보수 오버헤드가 발생합니다. 라이브러리를 업데이트할 때(리팩터링, 클래스 이름 바꾸기, 리플렉션 사용 방식 변경 포함) 문서를 업데이트해야 하며 앱은 새 규칙을 확인해야 합니다. 시간이 지남에 따라 앱이 여러 버전의 라이브러리를 통해 업그레이드되면 더 이상 필요하지 않은 기존 유지 규칙이 누적되어 불필요한 앱 비대화가 발생할 수 있습니다.
3. 출시 스택 트레이스 읽기
난독화된 코드로 인해 읽을 수 없는 스택 트레이스가 발생했을 수 있습니다. 중요한 분석을 차단 해제하기 위해 keepnames를 사용하고 싶을 수 있습니다. 는 축소를 허용하지만, 스택 트레이스를 디버깅할 때 필요한 정확한 값인 소비 앱의 이름 바꾸기와 같은 추가 최적화를 방지합니다.
읽을 수 있는 스택 트레이스를 가져오기 위해 추가 최적화를 방지할 필요는 없습니다.
Firebase Crashlytics, Play Console, Android 스튜디오의 Logcat은 앱 개발자를 위해 스택 트레이스를 가독화합니다. 즉, 앱 개발자가 스택 트레이스를 공유하는 경우 이를 읽기 위해 난독화를 방지할 필요가 없습니다.
매핑 파일을 SDK Console에 업로드하면 SDK Console에서 가독화된 스택 트레이스를 확인할 수 있습니다.
추측에 의존하지 않는 최적화
라이브러리를 최적화하는 과정이 시행착오를 겪는 게임처럼 느껴져서는 안 됩니다.
라이브러리 제공업체는 소비자 유지 규칙을 유지함으로써 생태계 전반의 앱이 최적화에서 차단되지 않도록 할 수 있습니다.
라이브러리가 더 나은 규칙을 제공하면 앱이 더 작아지고 빨라집니다. 지금 바로 소비자 유지 규칙을 감사하여 라이브러리에 종속된 앱이 최상의 성능을 발휘하도록 하세요.
-
방법프로필 기반 최적화, Jetpack Compose 성능 개선, 백그라운드 작업 시 고려사항을 다룹니다.
Ben Weiss, Breana Tate, Jossi Wolf • 읽는 데 8분 소요 -
방법'지능형 Android 앱 빌드' 블로그 게시물 시리즈에 다시 오신 것을 환영합니다. 이 시리즈에서는 기본 Android 앱을 맞춤설정된 지능형 에이전트 환경으로 변환하는 방법을 알아봅니다. 이전 게시물에서는 AppFunctions를 사용하여 인텔리전스 시스템에 연결하는 방법을 알아봤습니다.
Jolanda Verhoef • 읽는 데 9분 소요 -
방법Media3 1.11이 출시되었습니다. 대부분의 인기 Android 미디어 앱을 지원하는 이 버전에서는 재생, 편집, UI 구성요소 전반에 걸쳐 새로운 기능, 버그 수정, 개선사항이 제공됩니다.
Toni Heidenreich • 읽는 데 3분 소요
Android 개발 관련 최신 정보를 이메일로 받아 보세요.