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

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

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

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

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

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

Для создания приложения, использующего SDK с поддержкой среды выполнения, требуется Android Studio Ladybug Canary 1 или более поздняя версия, а также Android Gradle Plugin (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-адрес Maven для песочницы конфиденциальности в главный файл build.gradle вашего проекта.

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

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

5. Добавьте в файл build.gradle проекта блок privacySandbox с зависимостью от библиотеки SDK и установите параметр enable в значение 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 (AAB) так же, как и обычно .

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

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

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

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

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

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

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

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

Создать ASB можно двумя способами:

• Android Studio
  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 с поддержкой среды выполнения