Настройте базовый модуль

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