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

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

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

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

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