Создайте и используйте SDK с поддержкой среды выполнения.

Создайте и настройте тестовое приложение.

В этом разделе объясняется, как настроить и подготовить приложение для использования SDK с поддержкой среды выполнения для локального тестирования.

Подготовьте свое приложение

Сначала создайте отдельный автономный проект или модуль.

В этом случае приложение не содержит кода SDK; вместо этого он объявляет это как зависимость Maven.

Для создания приложения, использующего пакет SDK с поддержкой среды выполнения, требуется Android Studio Ladybug Canary 1 или новее и подключаемый модуль Android Gradle (AGP) 8.7.0-alpha01 или новее.

1. Выполните те же действия, что описаны ранее, чтобы настроить среду разработки и устройство/эмулятор для тестирования .

2. Включите среду выполнения SDK, используя флаг, описанный в разделе «Шаг 3. Подготовка SDK» .

   # This enables the Privacy Sandbox for your project on Android Studio.
   android.experimental.privacysandboxsdk.enable=true
   android.experimental.privacysandboxsdk.requireServices=false
   

3. Добавьте URL-адрес Privacy Sandbox Maven в файл build.gradle верхнего уровня вашего проекта.

       allprojects {
           repositories {
               google()
               maven {
                   url "https://maven.privacysandbox.com/v1/repository"
                   }
               }
           }
   

4. Сохраняйте зависимость Maven от существующей целевой библиотеки объявлений (вашего SDK с поддержкой среды выполнения).

5. Добавьте блок PrivacySandbox в проект build.gradle с зависимостью от библиотеки SDK и установите для него значение true.

   plugins {
       id 'com.android.application'
       id 'org.jetbrains.kotlin.android'
   }
   
   android {
       //...
       privacySandbox {
           enable true
       }
       //...
   }
   
   dependencies {
       // SDK library dependency
       implementation(<maven coordinates to SDK library>)
   }
   

6. Теперь приложение может использовать API SDK так же, как описано в разделе «Использование API».

Создайте свое приложение

Вы можете создавать свои приложения в виде пакета Android App Bundle (AAB) , как обычно .

Проверьте свой SDK локально

Чтобы запустить тестовое приложение, установите SDK и приложение с поддержкой среды выполнения на тестовое устройство или эмулятор с помощью Android Studio.

1. Откройте проект Android Studio для вашего тестового приложения.
2. Перейдите в «Выполнить» > «Изменить конфигурации» . Появится окно конфигурации «Запуск/Отладка». Вы можете развернуть как «APK по умолчанию» или «APK из пакета».
3. В разделе «Параметры запуска» установите для параметра «Запуск» значение «Заданное действие» .
4. Нажмите трехточечное меню рядом с пунктом «Действие» и выберите «Основное действие» для вашего клиента.
5. Нажмите «Применить» , а затем «ОК» .
6. Нажмите «Выполнить» , чтобы установить клиентское приложение и SDK на тестовое устройство.

Создайте свой SDK для распространения

Вам необходимо собрать свой SDK как пакет Android SDK (ASB), прежде чем вы сможете опубликовать его в магазине приложений. ASB — это неподписанный пакет публикаций, эквивалентный пакетам приложений Android.

ASB или его производная версия Android SDK Archive ( ASAR ) вместе с AAB приложения превращаются Bundletool в набор устанавливаемых APK. Разработчики приложений могут использовать BundleTool непосредственно в Android Studio (в настоящее время версия Canary) для вывода всех вариантов APK.

Bundletool принимает AAB и ASB и может выводить набор вариантов APK:

1. APK-файл, созданный для работы в режиме обратной совместимости с средой выполнения SDK для устройств, несовместимых со средой выполнения SDK (Android 13 и более ранних версий). Этот APK содержит весь код, необходимый как для приложения, так и для SDK.
2. APK-файл, созданный для запуска режима SDK Runtime для устройств, совместимых с SDK Runtime (Android 14 и более поздних версий). Этот APK-файл содержит только код приложения и заглушки API для SDK с поддержкой среды выполнения.
3. APK-файл SDK с кодом SDK с поддержкой среды выполнения, который необходимо установить перед APK-файлом приложения, описанным на предыдущем шаге.

Построить АСБ можно двумя способами:

• Android-студия
  1. Создайте свой проект. Это можно сделать, вызвав Build > Rebuild project.
  2. Файл ASB находится в вашем модуле ASB с поддержкой среды выполнения в папке build/outputs/asb/single/<your-asb-module-name>.asb
• Командная строка Bundletool — следуйте этим инструкциям .

Прежде чем опубликовать SDK, его необходимо подписать ключом загрузки. Используйте этот ключ загрузки, чтобы подписать свой ASB для загрузки в консоль SDK. Google использует сертификат загрузки для подтверждения вашей личности.

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

1. Создайте хранилище ключей и загрузите ключ. Это идентично созданию хранилища ключей и ключа загрузки для приложений .
2. Подпишите свой ASB с помощью ключа загрузки. Для этого добавьте блок SigningConfig в файл build.gradle, указав вновь созданный ключ и хранилище ключей:

android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

Магазины приложений могут разрабатывать различные стратегии использования этих компонентов для поддержки распространения приложений с поддержкой среды выполнения. SDK Runtime постоянно работает с магазинами приложений, чтобы расширить поддержку SDK с поддержкой среды выполнения.

arrow_back_ios Шаг 4. Используйте SDK с поддержкой среды выполнения.