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

1
Ключевые понятия
2
Настройте среду разработки
3
Создайте RE SDK
4
Используйте RE SDK
5
Тестирование и сборка для распространения
,
1
Ключевые понятия
2
Настройте среду разработки
3
Создайте RE SDK
4
Используйте RE SDK
5
Тестирование и сборка для распространения

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

В этом разделе объясняется, как настроить и подготовить приложение для использования 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 с поддержкой среды выполнения.

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

,
1
Ключевые понятия
2
Настройте среду разработки
3
Создайте RE SDK
4
Используйте RE SDK
5
Тестирование и сборка для распространения
,
1
Ключевые понятия
2
Настройте среду разработки
3
Создайте RE SDK
4
Используйте RE SDK
5
Тестирование и сборка для распространения

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

В этом разделе объясняется, как настроить и подготовить приложение для использования 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 с поддержкой среды выполнения.

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