Play Feature Delivery 개요

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Google Play의 앱 제공 모델은 Android App Bundle을 사용하여 각 사용자의 기기 설정에 최적화된 APK를 생성하고 제공하므로 사용자는 앱을 실행하는 데 필요한 코드와 리소스만 다운로드하면 됩니다.

Play Feature Delivery는 App Bundle의 고급 기능을 사용하여 앱의 특정 기능을 조건부로 전송하거나 주문형으로 다운로드할 수 있도록 합니다. 이를 위해 먼저 이러한 기본 앱의 기능을 기능 모듈로 분리해야 합니다.

기능 모듈 빌드 구성

Android 스튜디오를 사용해 새 기능 모듈을 만들 때 IDE는 다음과 같은 Gradle 플러그인을 모듈의 build.gradle 파일에 적용합니다.

// The following applies the dynamic-feature plugin to your feature module.
// The plugin includes the Gradle tasks and properties required to configure and build
// an app bundle that includes your feature module.

plugins {
  id 'com.android.dynamic-feature'
}

표준 애플리케이션 플러그인에서 사용 가능한 많은 속성은 기능 모듈에서도 사용할 수 있습니다. 다음 섹션에서는 기능 모듈의 빌드 구성에 포함해야 할 속성 또는 포함해서는 안 될 속성에 관해 설명합니다.

기능 모듈 빌드 구성에 포함해서는 안 되는 것

각 기능 모듈은 기본 모듈에 종속되기 때문에 특정 구성도 상속합니다. 따라서 기능 모듈의 build.gradle 파일에서 다음을 생략해야 합니다.

• 서명 구성: App Bundle은 기본 모듈에 지정된 서명 구성을 사용해 서명됩니다.
• minifyEnabled 속성: 기본 모듈의 빌드 구성에서만 앱 프로젝트 전체의 코드 축소를 사용 설정할 수 있습니다. 따라서 기능 모듈에서 이 속성을 생략해야 합니다. 그러나 각 기능 모듈에 추가 ProGuard 규칙을 지정할 수 있습니다.
• versionCode 및 versionName: App Bundle을 빌드할 때 Gradle은 기본 모듈이 제공하는 앱 버전 정보를 사용합니다. 기능 모듈의 build.gradle 파일에서 이러한 속성을 생략해야 합니다.

기본 모듈과의 관계 설정

Android 스튜디오는 기능 모듈을 생성할 때 아래와 같이 android.dynamicFeatures 속성을 기본 모듈의 build.gradle 파일에 추가하여 기능 모듈이 기본 모듈에 표시되게 합니다.

// In the base module’s build.gradle file.
android {
    ...
    // Specifies feature modules that have a dependency on
    // this base module.
    dynamicFeatures = [":dynamic_feature", ":dynamic_feature2"]
}

또한 Android 스튜디오는 아래와 같이 기본 모듈을 기능 모듈의 종속 항목으로 포함합니다.

// In the feature module’s build.gradle file:
...
dependencies {
    ...
    // Declares a dependency on the base module, ':app'.
    implementation project(':app')
}

추가 ProGuard 규칙 지정

기본 모듈의 빌드 구성만이 앱 프로젝트의 코드 축소를 사용 설정할 수 있지만 아래와 같이 proguardFiles 속성을 사용해 각 기능 모듈에 맞춤 ProGuard 규칙을 제공할 수 있습니다.

android.buildTypes {
     release {
         // You must use the following property to specify additional ProGuard
         // rules for feature modules.
         proguardFiles 'proguard-rules-dynamic-features.pro'
     }
}

이러한 ProGuard 규칙은 빌드 시에 다른 모듈(기본 모듈 포함)의 규칙과 병합됩니다. 따라서 각 기능 모듈에서 새로운 규칙 집합을 지정할 수 있지만 이 규칙은 앱 프로젝트의 모든 모듈에 적용됩니다.

앱 배포

기능 모듈을 지원하는 앱을 개발하는 동안 일반적인 방식과 마찬가지로 메뉴 바에서 Run > Run을 선택(또는 툴바에서 Run 을 클릭)하여 연결된 기기에 앱을 배포할 수 있습니다.

앱 프로젝트에 하나 이상의 기능 모듈이 포함된 경우 다음과 같이 기존 실행/디버그 구성을 수정하여 앱을 배포할 때 포함할 기능을 선택할 수 있습니다.

1. 메뉴 바에서 Run > Edit Configurations를 선택합니다.
2. Run/Debug Configurations 대화상자의 왼쪽 패널에서 원하는 Android App 구성을 선택합니다.
3. General 탭의 Dynamic features to deploy에서 앱을 배포할 때 포함할 각 기능 모듈 옆의 체크박스를 선택합니다.
4. OK를 클릭합니다.

기본적으로 Android 스튜디오는 App Bundle을 사용하여 앱을 배포하지 않습니다. 대신 IDE가 APK 크기보다는 배포 속도에 최적화된 APK를 빌드하여 기기에 설치합니다. App Bundle에서 APK와 인스턴트 환경을 대신 빌드하고 배포하도록 Android 스튜디오를 구성하려면 실행/디버그 구성을 수정해야 합니다.

맞춤 전송을 위한 기능 모듈 사용

기능 모듈의 고유한 이점은 Android 5.0(API 수준 21) 이상을 실행하는 기기에 앱의 다양한 기능을 다운로드하는 방법 및 시기를 맞춤설정할 수 있다는 점입니다. 예를 들어 앱의 최초 다운로드 크기를 줄이기 위해 특정 기능은 주문형으로 필요에 따라 다운로드되도록 설정하거나 사진 촬영 또는 증강 현실 기능 지원과 같은 특정 기능을 지원하는 기기에만 다운로드되도록 설정할 수 있습니다.

앱을 App Bundle로 업로드하면 기본적으로 매우 최적화된 다운로드를 제공할 수 있지만 더 고급의 맞춤설정 가능한 기능 제공 옵션을 사용하려면 기능 모듈을 사용하여 앱 기능을 추가로 설정하고 모듈화해야 합니다. 즉, 기능 모듈은 각각 필요에 따라 다운로드되도록 설정할 수 있는 모듈식 기능을 생성하기 위한 기본 구성요소를 제공합니다.

사용자가 온라인 마켓플레이스에서 상품을 사고팔 수 있는 앱을 생각해 보세요. 앱의 다음 기능을 각각 별도의 기능 모듈로 모듈화할 수 있습니다.

• 계정 로그인 및 생성
• 마켓플레이스 탐색
• 판매할 상품 배치
• 결제 처리

아래 표에서는 기능 모듈이 지원하는 다양한 제공 옵션을 소개하고, 이러한 옵션을 사용하여 샘플 마켓플레이스 앱의 최초 다운로드 크기를 최적화할 수 있는 방법을 설명합니다.

리소스의 URI 빌드

URI를 사용하여 기능 모듈에 저장된 리소스에 액세스하려면 다음과 같이 Uri.Builder()를 사용하여 기능 모듈 리소스 URI를 생성하는 방법을 사용하세요.

val uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build()

String uri = Uri.Builder()
                .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
                .authority(context.getPackageName()) // Look up the resources in the application with its splits loaded
                .appendPath(resources.getResourceTypeName(resId))
                .appendPath(String.format("%s:%s",
                  resources.getResourcePackageName(resId), // Look up the dynamic resource in the split namespace.
                  resources.getResourceEntryName(resId)
                  ))
                .build().toString();

리소스 경로의 각 부분은 런타임 시 구성되며 분할 APK가 로드된 후 올바른 네임스페이스가 생성되었는지 확인합니다.

URI가 생성되는 방식의 예로 다음과 같은 이름의 앱 및 기능 모듈이 있다고 가정해 보겠습니다.

• 앱 패키지 이름: com.example.my_app_package
• 기능의 리소스 패키지 이름: com.example.my_app_package.my_dynamic_feature

위 코드 스니펫의 resId가 기능 모듈의 'my_video'라는 원시 파일 리소스를 참조한다면 위의 Uri.Builder() 코드는 다음을 출력합니다.

android.resource://com.example.my_app_package/raw/com.example.my_app_package.my_dynamic_feature:my_video

그러면 앱에서 이 URI를 사용하여 기능 모듈의 리소스에 액세스할 수 있습니다.

URI의 경로를 검증하기 위해 다음과 같이 APK Analyzer를 사용하여 기능 모듈 APK를 검사하고 패키지 이름을 확인할 수 있습니다.

기능 모듈 고려사항

기능 모듈을 사용하면 빌드 속도와 엔지니어링 속도를 개선하고 앱 기능 제공 범위를 광범위하게 맞춤설정하여 앱 크기를 줄일 수 있습니다. 하지만 기능 모듈을 사용할 때 유념해야 할 몇 가지 제약 조건과 극단적 사례가 있습니다.

• 50개 이상의 기능 모듈을 조건부 제공 또는 주문형 제공을 통해 단일 기기에 설치하면 성능 문제가 발생할 수 있습니다. 삭제 가능으로 구성되지 않은 설치 시 모듈은 기본 모듈에 자동으로 포함되며 각 기기에서 하나의 기능 모듈로만 간주됩니다.
• 설치 시 제공을 위해 삭제 가능으로 구성하는 모듈 수를 10개 이하로 제한하세요. 제한하지 않으면 앱의 다운로드 및 설치 시간이 늘어날 수 있습니다.
• Android 5.0(API 수준 21) 이상을 실행하는 기기에서만 주문형 기능 다운로드 및 설치를 지원합니다. 이전 버전의 Android에서 기능을 사용할 수 있도록 하려면 기능 모듈을 만들 때 융합을 사용 설정해야 합니다.
• SplitCompat을 사용 설정하여 다운로드된 기능 모듈 중에서 주문형으로 제공된 기능 모듈에 앱이 액세스할 수 있도록 합니다.
• 기능 모듈은 android:exported가 true로 설정된 매니페스트에서 활동을 지정하면 안 됩니다. 다른 앱이 활동을 실행하려고 할 때 기기가 기능 모듈을 다운로드했다는 보장이 없기 때문입니다. 또한 앱은 코드 및 리소스에 액세스하기 전에 기능이 다운로드되었는지 확인해야 합니다. 자세한 내용은 설치된 모듈 관리를 참고하세요.
• Play Feature Delivery를 사용하려면 App Bundle을 사용하여 앱을 게시해야 하므로 App Bundle의 알려진 문제에 관해 알고 있어야 합니다.

기능 모듈 매니페스트 참조

Android 스튜디오를 사용하여 새로운 기능 모듈을 만들 때 IDE에는 모듈이 기능 모듈처럼 작동하는 데 필요한 대부분의 매니페스트 속성이 포함됩니다. 또한 일부 속성은 컴파일 시 빌드 시스템에 의해 삽입되므로 직접 지정하거나 수정하지 않아도 됩니다. 다음 표에서는 기능 모듈에 중요한 매니페스트 속성을 설명합니다.

추가 리소스

기능 모듈 사용에 관해 자세히 알아보려면 다음 리소스를 참고하세요.

블로그 게시물

• Google Play에서 비즈니스를 개발하여 출시 및 성장시키는 것을 도와주는 새로운 기능
• 추가 언어 API를 포함한 Android App Bundle의 최신 업데이트
• 패치워크 격자 - 모듈화 스토리

동영상

• App Bundle을 이용한 맞춤형 전송 및 테스트 빌드의 간편한 공유
• 앱 크기를 최적화하고 Google Play에서 설치 수를 높이는 최신 도구

서비스 약관 및 데이터 보안

Play Feature Delivery 라이브러리에 액세스하거나 이를 사용하면 Play Core 소프트웨어 개발 키트 서비스 약관에 동의하는 것으로 간주됩니다. 라이브러리에 액세스하기 전에 모든 관련 약관 및 정책을 자세히 읽고 숙지하세요.

데이터 보안

Play Core 라이브러리는 Google Play 스토어와 연결하는 앱의 런타임 인터페이스입니다. 따라서 앱에서 Play Core를 사용할 때 Play 스토어는 Google Play 서비스 약관에 따라 데이터를 처리하는 등 자체 프로세스를 실행합니다. 아래 정보는 Play Core 라이브러리가 앱의 특정 요청을 처리하기 위해 데이터를 처리하는 방법을 설명합니다.

추가 언어 API

Play Feature Delivery

Google은 최대한 투명하게 공개하는 것을 목표로 하지만, 앱의 사용자 데이터 수집, 공유 및 보안 관행과 관련하여 Google Play의 데이터 보안 섹션 양식에 응답하는 방법을 결정할 책임은 전적으로 개발자에게 있습니다.