Ключевые понятия | Настройте среду разработки | Создайте RE SDK | Используйте RE SDK | Тестирование и сборка для распространения |
Ключевые понятия | Настройте среду разработки | Создайте RE SDK | Используйте RE SDK | Тестирование и сборка для распространения |
Создайте и настройте тестовое приложение.
В этом разделе объясняется, как настроить и подготовить приложение для использования SDK с поддержкой среды выполнения для локального тестирования.
Подготовьте свое приложение
Сначала создайте отдельный автономный проект или модуль.
В этом случае приложение не содержит кода SDK; вместо этого он объявляет это как зависимость Maven.
Для создания приложения, использующего пакет SDK с поддержкой среды выполнения, требуется Android Studio Ladybug Canary 1 или новее и подключаемый модуль Android Gradle (AGP) 8.7.0-alpha01 или новее.
- Выполните те же действия, что описаны ранее, чтобы настроить среду разработки и устройство/эмулятор для тестирования .
Включите среду выполнения SDK, используя флаг, описанный в разделе «Шаг 3. Подготовка SDK» .
# This enables the Privacy Sandbox for your project on Android Studio. android.experimental.privacysandboxsdk.enable=true android.experimental.privacysandboxsdk.requireServices=false
Добавьте URL-адрес Privacy Sandbox Maven в файл build.gradle верхнего уровня вашего проекта.
allprojects { repositories { google() maven { url "https://maven.privacysandbox.com/v1/repository" } } }
Сохраняйте зависимость Maven от существующей целевой библиотеки объявлений (вашего SDK с поддержкой среды выполнения).
Добавьте блок 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>) }
Теперь приложение может использовать API SDK так же, как описано в разделе «Использование API».
Создайте свое приложение
Вы можете создавать свои приложения в виде пакета Android App Bundle (AAB) , как обычно .
Проверьте свой SDK локально
Чтобы запустить тестовое приложение, установите SDK и приложение с поддержкой среды выполнения на тестовое устройство или эмулятор с помощью Android Studio.
- Откройте проект Android Studio для вашего тестового приложения.
- Перейдите в «Выполнить» > «Изменить конфигурации» . Появится окно конфигурации «Запуск/Отладка». Вы можете развернуть как «APK по умолчанию» или «APK из пакета».
- В разделе «Параметры запуска» установите для параметра «Запуск» значение «Указанное действие» .
- Нажмите трехточечное меню рядом с пунктом «Действие» и выберите «Основное действие» для вашего клиента.
- Нажмите «Применить» , а затем «ОК» .
- Нажмите «Выполнить» , чтобы установить клиентское приложение и 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:
- APK-файл, созданный для работы в режиме обратной совместимости с средой выполнения SDK для устройств, несовместимых со средой выполнения SDK (Android 13 и более ранних версий). Этот APK содержит весь код, необходимый как для приложения, так и для SDK.
- APK-файл, созданный для запуска режима SDK Runtime для устройств, совместимых с SDK Runtime (Android 14 и более поздних версий). Этот APK-файл содержит только код приложения и заглушки API для SDK с поддержкой среды выполнения.
- APK-файл SDK с кодом SDK с поддержкой среды выполнения, который необходимо установить перед APK-файлом приложения, описанным на предыдущем шаге.
Построить АСБ можно двумя способами:
- Android-студия
- Создайте свой проект. Это можно сделать, вызвав Build > Rebuild project.
- Файл ASB находится в вашем модуле ASB с поддержкой среды выполнения в папке
build/outputs/asb/single/<your-asb-module-name>.asb
- Командная строка Bundletool — следуйте этим инструкциям .
Прежде чем опубликовать SDK, его необходимо подписать ключом загрузки. Используйте этот ключ загрузки, чтобы подписать свой ASB для загрузки в консоль SDK. Google использует сертификат загрузки для подтверждения вашей личности.
Следующие шаги представляют собой обзор того, что вам нужно сделать, чтобы подписать ASB:
- Создайте хранилище ключей и загрузите ключ. Это идентично созданию хранилища ключей и ключа загрузки для приложений .
- Подпишите свой ASB с помощью ключа загрузки. Для этого добавьте блок SigningConfig в файл build.gradle, указав вновь созданный ключ и хранилище ключей:
android {
signingConfig {
storeFile file(path-to-keystore.jks)
storePassword "keystorePassword"
keyAlias "UploadKey"
keyPassword "keyPassword"
}
}
Магазины приложений могут разрабатывать различные стратегии использования этих компонентов для поддержки распространения приложений с поддержкой среды выполнения. SDK Runtime постоянно работает с магазинами приложений, чтобы расширить поддержку SDK с поддержкой среды выполнения.
Шаг 4. Используйте SDK с поддержкой среды выполнения.
,Ключевые понятия | Настройте среду разработки | Создайте RE SDK | Используйте RE SDK | Тестирование и сборка для распространения |
Ключевые понятия | Настройте среду разработки | Создайте RE SDK | Используйте RE SDK | Тестирование и сборка для распространения |
Создайте и настройте тестовое приложение.
В этом разделе объясняется, как настроить и подготовить приложение для использования SDK с поддержкой среды выполнения для локального тестирования.
Подготовьте свое приложение
Сначала создайте отдельный автономный проект или модуль.
В этом случае приложение не содержит кода SDK; вместо этого он объявляет это как зависимость Maven.
Для создания приложения, использующего пакет SDK с поддержкой среды выполнения, требуется Android Studio Ladybug Canary 1 или новее и подключаемый модуль Android Gradle (AGP) 8.7.0-alpha01 или новее.
- Выполните те же действия, что описаны ранее, чтобы настроить среду разработки и устройство/эмулятор для тестирования .
Включите среду выполнения SDK, используя флаг, описанный в разделе «Шаг 3. Подготовка SDK» .
# This enables the Privacy Sandbox for your project on Android Studio. android.experimental.privacysandboxsdk.enable=true android.experimental.privacysandboxsdk.requireServices=false
Добавьте URL-адрес Privacy Sandbox Maven в файл build.gradle верхнего уровня вашего проекта.
allprojects { repositories { google() maven { url "https://maven.privacysandbox.com/v1/repository" } } }
Сохраняйте зависимость Maven от существующей целевой библиотеки объявлений (вашего SDK с поддержкой среды выполнения).
Добавьте блок 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>) }
Теперь приложение может использовать API SDK так же, как описано в разделе «Использование API».
Создайте свое приложение
Вы можете создавать свои приложения в виде пакета Android App Bundle (AAB) , как обычно .
Проверьте свой SDK локально
Чтобы запустить тестовое приложение, установите SDK и приложение с поддержкой среды выполнения на тестовое устройство или эмулятор с помощью Android Studio.
- Откройте проект Android Studio для вашего тестового приложения.
- Перейдите в «Выполнить» > «Изменить конфигурации» . Появится окно конфигурации «Запуск/Отладка». Вы можете развернуть как «APK по умолчанию» или «APK из пакета».
- В разделе «Параметры запуска» установите для параметра «Запуск» значение «Указанное действие» .
- Нажмите трехточечное меню рядом с пунктом «Действие» и выберите «Основное действие» для вашего клиента.
- Нажмите «Применить» , а затем «ОК» .
- Нажмите «Выполнить» , чтобы установить клиентское приложение и 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:
- APK-файл, созданный для работы в режиме обратной совместимости с средой выполнения SDK для устройств, несовместимых со средой выполнения SDK (Android 13 и более ранних версий). Этот APK содержит весь код, необходимый как для приложения, так и для SDK.
- APK-файл, созданный для запуска режима SDK Runtime для устройств, совместимых с SDK Runtime (Android 14 и более поздних версий). Этот APK-файл содержит только код приложения и заглушки API для SDK с поддержкой среды выполнения.
- APK-файл SDK с кодом SDK с поддержкой среды выполнения, который необходимо установить перед APK-файлом приложения, описанным на предыдущем шаге.
Построить АСБ можно двумя способами:
- Android-студия
- Создайте свой проект. Это можно сделать, вызвав Build > Rebuild project.
- Файл ASB находится в вашем модуле ASB с поддержкой среды выполнения в папке
build/outputs/asb/single/<your-asb-module-name>.asb
- Командная строка Bundletool — следуйте этим инструкциям .
Прежде чем опубликовать SDK, его необходимо подписать ключом загрузки. Используйте этот ключ загрузки, чтобы подписать свой ASB для загрузки в консоль SDK. Google использует сертификат загрузки для подтверждения вашей личности.
Следующие шаги представляют собой обзор того, что вам нужно сделать, чтобы подписать ASB:
- Создайте хранилище ключей и загрузите ключ. Это идентично созданию хранилища ключей и ключа загрузки для приложений .
- Подпишите свой ASB с помощью ключа загрузки. Для этого добавьте блок SigningConfig в файл build.gradle, указав вновь созданный ключ и хранилище ключей:
android {
signingConfig {
storeFile file(path-to-keystore.jks)
storePassword "keystorePassword"
keyAlias "UploadKey"
keyPassword "keyPassword"
}
}
Магазины приложений могут разрабатывать различные стратегии использования этих компонентов для поддержки распространения приложений с поддержкой среды выполнения. SDK Runtime постоянно работает с магазинами приложений, чтобы расширить поддержку SDK с поддержкой среды выполнения.