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

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

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

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

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

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

Создание 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 для проверки APK вашего функционального модуля и определения имени пакета:

Рисунок 2. Используйте анализатор APK для проверки имени пакета в скомпилированном файле ресурсов.

Рекомендации по функциональным модулям

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

• Установка 50 или более функциональных модулей на одном устройстве посредством условной доставки или доставки по требованию может привести к проблемам с производительностью. Модули времени установки, которые не настроены как съемные, автоматически включаются в базовый модуль и считаются только одним функциональным модулем на каждом устройстве.
• Ограничьте количество модулей, которые вы настраиваете как съемные для доставки во время установки, до 10 или меньше. В противном случае время загрузки и установки вашего приложения может увеличиться.
• Только устройства под управлением Android 5.0 (уровень API 21) и более поздних версий поддерживают загрузку и установку функций по требованию. Чтобы сделать вашу функцию доступной для более ранних версий Android, включите Fusing при создании функционального модуля.
• Включите SplitCompat , чтобы ваше приложение имело доступ к загруженным функциональным модулям, которые доставляются по требованию.
• Функциональные модули не должны указывать действия в своем манифесте, если для android:exported установлено значение true . Это связано с тем, что нет никакой гарантии, что устройство загрузило функциональный модуль, когда другое приложение попытается запустить это действие. Кроме того, ваше приложение должно подтвердить, что функция загружена, прежде чем пытаться получить доступ к ее коду и ресурсам. Чтобы узнать больше, прочитайте Управление установленными модулями .
• Поскольку доставка функций Play требует, чтобы вы публиковали свое приложение с помощью App Bundle, убедитесь, что вы знаете об известных проблемах с App Bundle .

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

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

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

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

Сообщения в блоге

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

Видео

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

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

Получая доступ к библиотеке доставки функций Play или используя ее, вы соглашаетесь с Условиями использования пакета разработки программного обеспечения Play Core . Пожалуйста, прочтите и поймите все применимые условия и правила, прежде чем получить доступ к библиотеке.

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

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

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

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

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

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

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

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

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

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

Создание 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 для проверки APK вашего функционального модуля и определения имени пакета:

Рисунок 2. Используйте анализатор APK для проверки имени пакета в скомпилированном файле ресурсов.

Рекомендации по функциональным модулям

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

• Установка 50 или более функциональных модулей на одном устройстве посредством условной доставки или доставки по требованию может привести к проблемам с производительностью. Модули времени установки, которые не настроены как съемные, автоматически включаются в базовый модуль и считаются только одним функциональным модулем на каждом устройстве.
• Ограничьте количество модулей, которые вы настраиваете как съемные для доставки во время установки, до 10 или меньше. В противном случае время загрузки и установки вашего приложения может увеличиться.
• Только устройства под управлением Android 5.0 (уровень API 21) и более поздних версий поддерживают загрузку и установку функций по требованию. Чтобы сделать вашу функцию доступной для более ранних версий Android, включите Fusing при создании функционального модуля.
• Включите SplitCompat , чтобы ваше приложение имело доступ к загруженным функциональным модулям, которые доставляются по требованию.
• Функциональные модули не должны указывать действия в своем манифесте, если для android:exported установлено значение true . Это связано с тем, что нет никакой гарантии, что устройство загрузило функциональный модуль, когда другое приложение попытается запустить это действие. Кроме того, ваше приложение должно подтвердить, что функция загружена, прежде чем пытаться получить доступ к ее коду и ресурсам. Чтобы узнать больше, прочитайте Управление установленными модулями .
• Поскольку доставка функций воспроизведения требует, чтобы вы опубликовали свое приложение, используя пакет приложений, убедитесь, что вы знаете о известных проблемах приложения.

Ссылка на модуль функции

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

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

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

Сообщения в блоге

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

Видео

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

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

Доступ или используя библиотеку доставки функций Play, вы соглашаетесь с условиями обслуживания Play Core Development Security . Пожалуйста, прочитайте и поймите все применимые условия и политики, прежде чем получить доступ к библиотеке.

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

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

Дополнительные языки API

Играть в функции доставки

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