Обзор предоставления функций Play

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

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

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

При создании нового функционального модуля с помощью 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 функционального модуля следует исключить следующее:

• Конфигурации подписи: Пакеты приложений подписываются с использованием конфигураций подписи, указанных вами в базовом модуле.
• Свойство minifyEnabled : вы можете включить сжатие кода для всего проекта приложения, используя только конфигурацию сборки базового модуля. Поэтому следует исключить это свойство из модулей функций. Однако вы можете указать дополнительные правила ProGuard для каждого модуля функций.
• versionCode и versionName : при сборке пакета приложений Gradle использует информацию о версии приложения, предоставляемую базовым модулем. Эти свойства следует исключить из файла build.gradle вашего функционального модуля.

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

Когда Android Studio создает ваш функциональный модуль, он делает его видимым для базового модуля, добавляя свойство 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 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 объединяются с правилами других модулей (включая базовый) во время сборки. Таким образом, хотя каждый функциональный модуль может определять новый набор правил, эти правила применяются ко всем модулям в проекте приложения.

Разверните свое приложение

При разработке приложения с поддержкой функциональных модулей вы можете развернуть его на подключенном устройстве, как обычно, выбрав «Запустить» > «Запустить» в строке меню (или нажав «Запустить») . на панели инструментов).

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

1. В строке меню выберите Выполнить > Изменить конфигурации .
2. На левой панели диалогового окна «Конфигурации запуска/отладки» выберите нужную конфигурацию приложения Android .
3. В разделе Динамические функции для развертывания на вкладке Общие установите флажок рядом с каждым модулем функций, который вы хотите включить при развертывании приложения.
4. Нажмите ОК .

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

Используйте функциональные модули для индивидуальной доставки

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

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

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

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

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

Создание 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-файлов.

В качестве примера того, как генерируется 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, включите функцию Fusing при создании модуля функции.
• Включите SplitCompat , чтобы ваше приложение имело доступ к загруженным функциональным модулям, которые доставляются по требованию.
• Модули функций не должны указывать действия в манифесте с android:exported установленным в значение true . Это связано с тем, что нет гарантии, что устройство загрузит модуль функции, когда другое приложение попытается запустить действие. Кроме того, ваше приложение должно подтвердить загрузку функции, прежде чем пытаться получить доступ к её коду и ресурсам. Подробнее см. в разделе Управление установленными модулями .
• Поскольку Play Feature Delivery требует, чтобы ваше приложение было опубликовано с использованием пакета приложений, убедитесь, что вы осведомлены об известных проблемах пакета приложений.

Ссылка на манифест модуля функций

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

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

Чтобы узнать больше об использовании функциональных модулей, попробуйте следующие ресурсы.

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

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

Видео

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

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

Получая доступ к библиотеке Play Feature Delivery Library или используя её, вы соглашаетесь с Условиями обслуживания Play Core Software Development Kit . Перед доступом к библиотеке, пожалуйста, ознакомьтесь со всеми применимыми условиями и политиками.

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

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

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

Доставка функций Play

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