Общая информация о Play Feature Delivery

Модель распространения приложений в Google Play использует наборы Android App Bundle, чтобы создавать и предоставлять оптимизированные APK-файлы для конфигурации устройства каждого пользователя. Таким образом, пользователи скачивают только код и ресурсы, необходимые для запуска приложения.

Play Feature Delivery использует расширенные возможности наборов App Bundle, позволяя скачивать определенные функции приложения по запросу или при соблюдении заданных условий. Для этого сначала нужно отделить эти функции от основного приложения и поместить их в модули функций.

Конфигурация сборки модуля функции

Когда вы создаете новый модуль функции в Android Studio, 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 Studio создает модуль функции, он становится видимым для основного модуля, поскольку в файл build.gradle основного модуля добавляется свойство android.dynamicFeatures, как показано ниже:

// 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 Studio включает базовый модуль в качестве зависимости модуля функции, как показано ниже:

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

Укажите дополнительные правила ProGuard

Хотя сокращение кода для проекта приложения можно включить только в конфигурации сборки основного модуля, вы можете задать собственные правила ProGuard для каждого модуля функции с помощью свойства proguardFiles, как показано ниже.

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 (Приложение Android).
3. На вкладке General (Общие) в разделе Dynamic features to deploy (Динамические функции для развертывания) установите флажки рядом с модулями функций, которые нужно включить при развертывании приложения.
4. Нажмите ОК.

По умолчанию Android Studio не использует наборы App Bundle для развертывания приложения. Вместо этого IDE создает и устанавливает на устройство APK-файлы, оптимизированные для скорости развертывания, а не для размера APK. Чтобы настроить Android Studio для создания и развертывания APK-файлов и приложений с мгновенным запуском из набора App Bundle, измените конфигурацию выполнения/отладки.

Как использовать модули функций для выборочной доставки

Уникальное преимущество модулей функций – возможность настраивать, как и когда различные функции приложения скачиваются на устройства с Android 5.0 (уровень API 21) или более поздней версии. Например, чтобы уменьшить размер приложения при скачивании, вы можете настроить загрузку некоторых функций по запросу или только на устройства, которые поддерживают определенные возможности, такие как фотосъемка или дополненная реальность.

При загрузке приложения в виде набора App Bundle вы по умолчанию получаете оптимизированные скачиваемые файлы. Однако для более продвинутых и настраиваемых вариантов доставки функций требуется дополнительная настройка и модульное разделение функций приложения с помощью модулей функций. Другими словами, модули функций – это строительные блоки для создания модульных функций, которые можно настроить для скачивания по мере необходимости.

Предположим, что у вас есть приложение, которое позволяет пользователям покупать и продавать товары на онлайн-площадке. Вы можете выделить в отдельные модули следующие функции приложения:

• Вход в аккаунт и его создание
• Просмотр торговой площадки
• Выставление товара на продажу
• Обработка платежей

В таблице ниже описаны разные варианты доставки, которые поддерживают модули функций, и то, как их можно использовать для оптимизации размера скачиваемого файла на примере приложения торговой площадки.

Как создать URI для ресурса

Если вы хотите получить доступ к ресурсу, хранящемуся в модуле функции, с помощью URI, вот как сгенерировать URI ресурса модуля функции с помощью Uri.Builder():

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.

Предположим, у вас есть приложение и модули функций со следующими названиями:

• Название пакета приложения: 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, ознакомьтесь с известными проблемами, которые могут возникнуть при работе с такими наборами.

Справочная информация о манифесте модуля функции

При создании нового модуля функции в Android Studio интегрированная среда разработки включает большинство атрибутов манифеста, необходимых для работы модуля функции. Кроме того, некоторые атрибуты добавляются системой сборки во время компиляции, поэтому вам не нужно указывать или изменять их самостоятельно. В таблице ниже описаны атрибуты манифеста, которые важны для модулей функций.

Дополнительные ресурсы

Дополнительную информацию о модулях функций можно найти по ссылкам ниже.

Записи в блоге

• Новые функции, которые помогут вам разрабатывать и выпускать приложения, а также развивать бизнес в Google Play
• Последние обновления Android App Bundle, включая API дополнительных языков
• Patchwork Plaid — A modularization story

Видео

• Настройка загружаемого контента с помощью наборов App Bundle и предоставление доступа к тестовым сборкам
• Новые инструменты для оптимизации размера приложения и увеличения количества установок в Google Play

Условия использования и безопасность данных

Получая доступ к библиотеке Play Feature Delivery или используя ее, вы принимаете Условия использования пакета средств разработки Play Core. Прежде чем начать работу с библиотекой, ознакомьтесь со всеми действующими условиями и правилами.

Безопасность данных

Библиотеки Play Core – это интерфейс среды выполнения приложения, который связывает его с Google Play. Когда вы используете Play Core в своем приложении, Google Play запускает собственные процессы, в том числе обработку данных, которая регулируется Условиями использования Google Play. Ниже описано, как библиотеки Play Core обрабатывают данные, чтобы выполнять определенные запросы из вашего приложения.

API дополнительных языков

Play Feature Delivery

Мы постарались максимально полно описать работу SDK, однако вы несете единоличную ответственность за то, какую информацию о сборе, передаче и защите пользовательских данных вы добавляете в раздел безопасности данных Google Play.