Как настроить доставку при установке

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

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

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

Кроме того, модули функций, настроенные для доставки при установке, можно удалить, если они больше не нужны. Для этого их нужно настроить как съемные.

В этом разделе описывается, как создать модуль функции для доставки при установке. Прежде чем начать, убедитесь, что вы используете Android Studio 3.5 или более поздней версии и плагин Android Gradle 3.5.0 или более поздней версии.

Как настроить новый модуль для доставки при установке

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

Чтобы добавить модуль функции в проект приложения с помощью Android Studio, выполните следующие действия:

  1. Если вы ещё этого не сделали, откройте проект приложения в IDE.
  2. В строке меню выберите File (Файл) > New (Создать) > New Module (Новый модуль).
  3. В диалоговом окне Create New Module (Создать модуль) выберите Dynamic Feature Module (Динамический модуль функции) и нажмите Next (Далее).
  4. В разделе Настройка нового модуля выполните следующие действия:
    1. В раскрывающемся меню выберите Базовый модуль приложения для проекта приложения.
    2. Укажите название модуля. Среда разработки использует это название, чтобы идентифицировать модуль как подпроект Gradle в файле настроек Gradle. При сборке набора App Bundle Gradle использует последний элемент названия подпроекта, чтобы добавить атрибут <manifest split> в манифест модуля функции.
    3. Укажите название пакета модуля. По умолчанию Android Studio предлагает название пакета, которое объединяет название корневого пакета базового модуля и название модуля, указанное на предыдущем шаге.
    4. Выберите минимальный уровень API, который должен поддерживать модуль. Это значение должно совпадать со значением базового модуля.
  5. Нажмите Далее.
  6. В разделе Module Download Options (Параметры скачивания модулей) выполните следующие действия:

    1. Укажите название модуля (не более 50 символов). Основной модуль приложения должен содержать название модуля в виде строкового ресурса, который можно перевести. При создании модуля в Android Studio интегрированная среда разработки автоматически добавляет строковый ресурс в базовый модуль и вставляет в манифест модуля функции следующую запись:

      <dist:module
          ...
          dist:title="@string/feature_title">
      </dist:module>
      

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

    2. В раскрывающемся меню Install-time inclusion (Включение при установке) выберите Include module at install-time (Включить модуль при установке). Android Studio добавляет в манифест модуля следующий код:

      <dist:module ... >
        <dist:delivery>
            <dist:install-time />
        </dist:delivery>
      </dist:module>
      

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

    3. Установите флажок Объединение, если хотите, чтобы этот модуль был доступен на устройствах с Android 4.4 (уровень API 20) и более ранних версий и входил в состав набора APK. Это значит, что вы можете не включать его в сборки для устройств, которые не поддерживают скачивание и установку раздельных APK. Android Studio добавит в манифест модуля следующий код:

      <dist:module ...>
          <dist:fusing dist:include="true | false" />
      </dist:module>
      
  7. Нажмите Готово.

После того как Android Studio создаст модуль, проверьте его содержимое на панели Project (Проект). Для этого в строке меню выберите View > Tool Windows > Project (Вид > Окна инструментов > Проект). Код, ресурсы и структура по умолчанию должны быть похожи на те, что используются в стандартном модуле приложения.

Как сделать модуль, устанавливаемый при скачивании, удаляемым

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

По умолчанию модули, устанавливаемые вместе с приложением, нельзя удалить. Чтобы пометить модуль как удаляемый и разрешить его удаление, добавьте тег removable и задайте для него значение true:

<dist:module ... >
  <dist:delivery>
      <dist:install-time>
          <dist:removable dist:value="true"/>
      </dist:install-time>
  </dist:delivery>
</dist:module>