기능 모듈을 사용하면 앱의 기본 모듈에서 특정 기능 및 리소스를 분리하여 App Bundle에 포함할 수 있습니다. 그런 다음, Android 5.0(API 수준 21) 이상을 실행하는 기기가 앱의 기능을 다운로드하는 시기와 방법을 제어하는 제공 옵션을 맞춤설정할 수 있습니다.
이런 유형의 모듈화는 더 많은 작업이 필요하고 앱의 기존 코드를 리팩터링해야 할 수 있으므로 사용자가 주문형으로 이용함으로써 얻을 수 있는 이점이 가장 큰 앱 기능이 어떤 것인지 신중하게 고려해야 합니다.
앱의 동작을 변경하거나 고급 제공 옵션을 맞춤설정하지 않고 시간 경과에 따라 앱 기능을 점차 모듈화하려면 설치 시 제공을 위해 구성되는 기능 모듈을 생성하면 됩니다. 즉 기능을 기능 모듈로 모듈화할 수 있지만 고급 옵션을 사용 설정하지 않으므로 사용자가 앱을 설치할 때 그 기능을 사용할 수 있습니다.
또한 설치 시 제공을 위해 구성된 기능 모듈은 더 이상 필요하지 않은 경우 나중에 제거할 수 있는 옵션이 있습니다. 이를 위해 삭제 가능으로 설정해야 합니다.
이 섹션에서는 설치 시 제공을 위한 기능 모듈을 만드는 방법을 설명합니다.
시작하기 전에 Android 스튜디오 3.5 이상 및 Android Gradle 플러그인 3.5.0 이상을 사용하고 있는지 확인하세요.
설치 시 제공을 위한 새 모듈 구성
새 기능 모듈을 만드는 가장 쉬운 방법은 Android 스튜디오 3.5 이상을 사용하는 것입니다.
기능 모듈은 본질적으로 기본 앱 모듈에 종속되기 때문에 기존 앱 프로젝트에만 추가할 수 있습니다.
Android 스튜디오를 사용하여 앱 프로젝트에 기능 모듈을 추가하려면 다음 단계를 따르세요.
아직 앱 프로젝트를 열지 않았다면 IDE에서 앱 프로젝트를 엽니다.
메뉴 바에서 File > New > New Module을 선택합니다.
Create New Module 대화상자에서 Dynamic Feature Module을 선택하고 Next를 클릭합니다.
Configure your new module 섹션에서 다음을 완료합니다.
드롭다운 메뉴에서 앱 프로젝트의 Base application module을 선택합니다.
Module name을 지정합니다. IDE는 이 이름을 사용하여 Gradle 설정 파일에서 모듈을 Gradle 하위 프로젝트로 식별합니다. App Bundle을 빌드할 때 Gradle은 하위 프로젝트 이름의 마지막 요소를 사용하여 기능 모듈의 매니페스트에 <manifest split> 속성을 삽입합니다.
모듈의 package name을 지정합니다. 기본적으로 Android 스튜디오는 기본 모듈의 루트 패키지 이름과 이전 단계에서 지정한 모듈 이름을 결합한 패키지 이름을 제안합니다.
모듈에서 지원할 Minimum API level을 선택합니다.
이 값은 기본 모듈의 값과 일치해야 합니다.
Next를 클릭합니다.
Module Download Options 섹션에서 다음을 완료합니다.
최대 50자(영문 기준)를 사용하여 Module title을 지정합니다.
앱의 기본 모듈은 번역이 가능한 문자열 리소스로 된 모듈 제목을 포함해야 합니다. Android 스튜디오를 사용하여 모듈을 만들 때 IDE는 문자열 리소스를 기본 모듈에 추가하고 다음 항목을 기능 모듈의 매니페스트에 삽입합니다.
앱 설치 후 다운로드할 수 있는 기능 모듈을 만드는 방법에 관해 자세히 알아보려면 주문형 제공 구성을 참고하세요.
이 모듈을 Android 4.4(API 수준 20) 이하를 실행하는 기기에서 사용하고 다중 APK에 포함하려면 Fusing 옆에 있는 체크박스를 선택하세요. 즉, 분할 APK의 다운로드 및 설치를 지원하지 않는 기기에서는 모듈을 제외할 수 있습니다. Android 스튜디오는 모듈의 매니페스트에 다음을 삽입하여 선택사항을 반영합니다.
Android 스튜디오에서 모듈 생성을 완료한 후에는 Project 창에서 직접 콘텐츠를 검사합니다(메뉴 바에서 View > Tool Windows > Project 선택). 기본 코드, 리소스 및 구성은 표준 앱 모듈과 비슷해야 합니다.
설치 시 모듈을 삭제 가능하도록 구성
설치 시 제공을 위한 기능 모듈이 더 이상 필요하지 않은 경우 나중에 제거하는 옵션이 있도록 구성하는 것이 유용할 수 있습니다. 예를 들어 앱의 설치 크기를 줄이려면 학습이나 온보딩에 필요한 콘텐츠를 모듈화하고 사용자가 사용할 수 있도록 앱이 설정된 후 Play Core API를 사용하여 기능 모듈을 제거하면 됩니다.
기본적으로 설치 시 모듈은 삭제할 수 없습니다. 모듈을 삭제 가능으로 표시하고 제거할 수 있도록 하려면 removable 태그를 추가하고 값을 true로 설정합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Configure install-time delivery\n\nFeature modules allow you to separate certain features and resources\nfrom the base module of your app and include them in your app bundle. You can\nthen [customize delivery options](/guide/playcore/feature-delivery#customize_delivery)\nto control when and how devices running Android 5.0 (API level 21) or higher\ndownload your app's features.\n\nKeep in mind, this type of modularization requires more effort and possibly\nrefactoring your app's existing code, so consider carefully which of your\napp's features would benefit the most from being available to users on demand.\n\nIf you want to gradually modularize app features over time, without\nchanging the behavior of your app or customizing advanced delivery options, you\ncan do so by creating feature modules that are configured for install-time\ndelivery. That is, you can modularize a feature as a feature module, but not\nenable advanced options so the feature is available when a user installs your\napp.\n\nAdditionally, feature modules that are configured for install-time delivery have the option to later be uninstalled if they're no longer required. For that, they need to be [set up as removable](#make-removable).\n\nThis section describes how to create a feature module for install-time\ndelivery. Before you begin, make sure you're\nusing [Android Studio 3.5](/studio) or higher and Android Gradle Plugin 3.5.0\nor higher.\n\nConfigure a new module for install-time delivery\n------------------------------------------------\n\nThe easiest way to create a new feature module is by using\n[Android Studio 3.5](/studio) or higher.\nBecause feature modules have an\ninherent dependency on the base app module, you can add them only to existing\napp projects.\n\nTo add a feature module to your app project using Android Studio,\nproceed as follows:\n\n1. If you haven't already done so, open your app project in the IDE.\n2. Select **File \\\u003e New \\\u003e New Module** from the menu bar.\n3. In the **Create New Module** dialog, select **Dynamic Feature Module** and click **Next**.\n4. In the **Configure your new module** section, complete the following:\n 1. Select the **Base application module** for your app project from the dropdown menu.\n 2. Specify a **Module name** . The IDE uses this name to identify the module as a Gradle subproject in your [Gradle settings file](/studio/build#settings-file). When you build your app bundle, Gradle uses the last element of the subproject name to inject the `\u003cmanifest split\u003e` attribute in the [feature module's manifest](/guide/app-bundle/dynamic-delivery#dynamic_feature_manifest).\n 3. Specify the module's **package name**. By default, Android Studio suggests a package name that combines the root package name of the base module and the module name you specified in the previous step.\n 4. Select the **Minimum API level** you want the module to support. This value should match that of the base module.\n5. Click **Next**.\n6. In the **Module Download Options** section, complete the following:\n\n 1. Specify the **Module title** using up to 50 characters. Your app's base\n module must include the module title as a\n [string resource](/guide/topics/resources/string-resource), which you\n can translate. When creating the module using Android Studio, the IDE\n adds the string resource to the base module for you and injects the\n following entry in the feature module's manifest:\n\n \u003cdist:module\n ...\n dist:title=\"@string/feature_title\"\u003e\n \u003c/dist:module\u003e\n\n | **Note:** If you enable resource shrinking, such as for your release builds, the shrinker might remove the module title string resource if code in your base module does not reference it. To make sure the string resource remains in the build output, include the resource in a [custom resource keep file](/studio/build/shrink-code#keep-resources).\n 2. In the dropdown menu under **Install-time inclusion** , select **Include\n module at install-time**. Android Studio injects the following in the\n module's manifest to reflect your choice:\n\n \u003cdist:module ... \u003e\n \u003cdist:delivery\u003e\n \u003cdist:install-time /\u003e\n \u003c/dist:delivery\u003e\n \u003c/dist:module\u003e\n\n If you want to learn how to create a feature module\n that you can download after app install, read\n [configure on-demand delivery](/studio/projects/dynamic-delivery/on-demand-delivery).\n 3. Check the box next to **Fusing** if you want this module to be available\n to devices running Android 4.4 (API level 20) and lower and included in\n multi-APKs. That means you can omit it from devices that don't support\n downloading and installing split APKs. Android Studio injects the\n following in the module's manifest to reflect your choice:\n\n \u003cdist:module ...\u003e\n \u003cdist:fusing dist:include=\"true | false\" /\u003e\n \u003c/dist:module\u003e\n\n7. Click **Finish**.\n\nAfter Android Studio finishes creating your module, inspect its contents\nyourself from the **Project** pane (select **View \\\u003e Tool Windows \\\u003e Project**\nfrom the menu bar). The default code, resources, and organization should be\nsimilar to those of the standard app module.\n\nMake an install-time module removable\n-------------------------------------\n\nIt might be useful to create feature modules for install-time delivery that have the option to be later uninstalled if no longer required. For example, to reduce the installed size of\nyour app, you can modularize content that's required for training or onboarding,\nand then\n[uninstall the feature module](/guide/playcore/feature-delivery/on-demand#uninstall_modules) using the Play Core API\nafter the user is set up to use your app.\n\nInstall-time modules are not removable by default. To mark a module as removable and allow it to be uninstalled, add the `removable` tag and set its value to `true`: \n\n \u003cdist:module ... \u003e\n \u003cdist:delivery\u003e\n \u003cdist:install-time\u003e\n \u003cdist:removable dist:value=\"true\"/\u003e\n \u003c/dist:install-time\u003e\n \u003c/dist:delivery\u003e\n \u003c/dist:module\u003e\n\n| **Note:** Configuring too many install-time modules as removable might increase the download and install time for your app. To avoid this issue, keep the number of removable install-time delivery modules under 10."]]
