В отличие от файла APK набор App Bundle не предназначен для запуска на устройстве, а используется как формат публикации, который содержит весь скомпилированный код и ресурсы приложения. После того как вы загружаете подписанный набор App Bundle, Google Play может создавать и подписывать APK-файлы приложения и распространять их среди пользователей.
Начать
Для большинства проектов приложений поддержка наборов Android App Bundle не потребует значительных усилий.
Это связано с тем, что модуль, содержащий код и ресурсы для основного APK-файла приложения, является стандартным модулем приложения, который вы получаете по умолчанию при создании нового проекта приложения в Android Studio. Это модуль, который применяет плагин application, как показано в следующем фрагменте кода, к своему файлу build.gradle, предоставляет код и ресурсы для базовой функциональности вашего приложения.
Яркий
// The standard application plugin creates your app's base module. plugins { id 'com.android.application' }
Kotlin
plugins { // The standard application plugin creates your app's base module. id("com.android.application") }
Помимо основных функций приложения, базовый модуль также содержит многие конфигурации сборки и записи манифеста, которые влияют на весь проект приложения.
Конфигурация сборки базового модуля
Для большинства существующих проектов приложений вам не нужно ничего менять в конфигурации сборки базового модуля. Однако если вы планируете добавить в проект приложения модули функций или ранее публиковали приложение с несколькими APK-файлами, вам следует учитывать некоторые аспекты конфигурации сборки основного модуля.
Код версии и обновления приложения
При использовании наборов Android App Bundle вам больше не нужно управлять кодами версий для нескольких APK-файлов, которые вы загружаете в Google Play. Вместо этого вы управляете только одним кодом версии в базовом модуле приложения, как показано ниже:
// In your base module build.gradle file
android {
defaultConfig {
…
// You specify your app's version code only in the base module.
versionCode 5
versionName "1.0"
}
}
После загрузки набора App Bundle Google Play использует код версии в основном модуле, чтобы присвоить его всем APK-файлам, созданным из этого набора. Это означает, что когда устройство скачивает и устанавливает ваше приложение, у всех раздельных APK-файлов для этого приложения будет один и тот же код версии.
Чтобы обновить код или ресурсы приложения, необходимо изменить код версии в основном модуле и создать новый полный набор App Bundle. Когда вы загружаете этот набор App Bundle в Google Play, он генерирует новый набор APK-файлов на основе кода версии, указанного в основном модуле. Когда пользователи обновляют приложение, Google Play предоставляет им обновленные версии всех APK-файлов, установленных на устройстве. Это значит, что все установленные APK-файлы обновляются до новой версии.
Примечание
- Подпись приложения. Если вы включаете информацию о подписи в файлы сборки, ее следует добавлять только в файл конфигурации сборки основного модуля. Подробнее о том, как настроить Gradle для подписания приложения…
- Сокращение кода. Если вы хотите включить сокращение кода для всего проекта приложения (включая модули функций), это нужно сделать в файле
build.gradleосновного модуля. То есть вы можете включить специальные правила ProGuard в модуль функции, но свойствоminifyEnabledв конфигурациях сборки модуля функции игнорируется. - Блок
splitsигнорируется. При создании набора App Bundle Gradle игнорирует свойства в блокеandroid.splits. Если вы хотите указать, какие типы конфигурационных APK-файлов поддерживает ваш набор App Bundle, используйтеandroid.bundle, чтобы отключить типы конфигурационных APK-файлов. - Версии приложения. Базовый модуль определяет код и название версии для всего проекта приложения. Подробнее о коде версии и обновлениях приложения…
Как включить или отключить типы APK конфигурации
По умолчанию при создании набора App Bundle поддерживается генерация APK конфигурации для каждого набора языковых ресурсов, ресурсов плотности экрана и библиотек ABI. С помощью блока android.bundle в файле build.gradle основного модуля можно отключить поддержку одного или нескольких типов APK конфигурации, как показано ниже.
Яркий
android { // When building Android App Bundles, the splits block is ignored. // You can remove it, unless you're going to continue to build multiple // APKs in parallel with the app bundle splits {...} // Instead, use the bundle block to control which types of configuration APKs // you want your app bundle to support. bundle { language { // This property is set to true by default. // You can specify `false` to turn off // generating configuration APKs for language resources. // These resources are instead packaged with each base and // feature APK. // Continue reading below to learn about situations when an app // might change setting to `false`, otherwise consider leaving // the default on for more optimized downloads. enableSplit = false } density { // This property is set to true by default. enableSplit = true } abi { // This property is set to true by default. enableSplit = true } } }
Kotlin
android { // When building Android App Bundles, the splits block is ignored. // You can remove it, unless you're going to continue to build multiple // APKs in parallel with the app bundle splits {...} // Instead, use the bundle block to control which types of configuration APKs // you want your app bundle to support. bundle { language { // This property is set to true by default. // You can specify `false` to turn off // generating configuration APKs for language resources. // These resources are instead packaged with each base and // feature APK. // Continue reading below to learn about situations when an app // might change setting to `false`, otherwise consider leaving // the default on for more optimized downloads. enableSplit = false } density { // This property is set to true by default. enableSplit = true } abi { // This property is set to true by default. enableSplit = true } } }
Как обрабатывать изменения языка
Google Play определяет, какие языковые ресурсы нужно установить вместе с приложением, на основе языка, выбранного в настройках устройства пользователя. Предположим, что пользователь изменил язык системы по умолчанию после того, как скачал ваше приложение. Если приложение поддерживает этот язык, устройство запрашивает и скачивает из Google Play дополнительные APK-файлы конфигурации для ресурсов на этом языке.
Если в приложении есть окно выбора языка и язык динамически меняется независимо от системных настроек, вам нужно внести некоторые изменения, чтобы предотвратить сбои из-за отсутствия ресурсов. Задайте для свойства android.bundle.language.enableSplit значение false или настройте скачивание языковых пакетов по запросу с помощью библиотеки Play Core, как описано в разделе Скачивание дополнительных языковых ресурсов.