Se usó la API de Cloud Translation para traducir esta página.

Compila y usa un SDK habilitado para el entorno de ejecución

Testing, and building for distribution

Cómo compilar y configurar una app de prueba

En esta sección, se explica cómo configurar y preparar una app para que consuma una versión habilitada para el entorno de ejecución. SDK para pruebas locales.

Prepara tu app

Primero, crea un proyecto o módulo independiente independiente.

En este caso, la app no contiene el código del SDK. lo declara como un la dependencia de Maven.

La compilación de una app que consume un SDK habilitado para el entorno de ejecución requiere Android Studio Ladybug Canary 1 o una versión posterior y el complemento de Android para Gradle (AGP) 8.7.0-alpha01 o una versión posterior.

Sigue los mismos pasos descritos anteriormente para configurar tu entorno de desarrollo y dispositivo o emulador para pruebas.

Habilita el entorno de ejecución de SDK con la marca descrita en Paso 3: Prepara la sección del SDK.

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

Agrega la URL de Maven de Privacy Sandbox al archivo build.gradle de nivel superior de tu proyecto .

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

Mantén la dependencia de Maven en el destino de Maven de la biblioteca de anuncios existente (tu SDK adaptado al entorno de ejecución).

Agrega un bloque privacySandbox al proyecto build.gradle con una dependencia en la biblioteca del SDK y configura 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>)
}

Ahora la app puede usar las APIs del SDK de la misma manera que en la sección Consumo de la API.

Compila tu app

Puedes compilar tus apps como un Android App Bundle (AAB) como lo harías normalmente.

Prueba tu SDK de manera local

Para ejecutar tu app de prueba, instala en la prueba el SDK y la app habilitados para el entorno de ejecución dispositivo o emulador con Android Studio.

Abre el proyecto de Android Studio de tu app de prueba.
Ve a Run > Edit Configurations. El comando "Run/Debug" Ventana de configuración . Puedes implementarlo como "APK predeterminado" o "APK from Bundle".
En Launch Options, establece Launch en Specified Activity.
Haz clic en el menú de tres puntos junto a Actividad y selecciona la pestaña Principal Actividad para tu cliente.
Haz clic en Apply y, luego, en OK.
Haz clic en Run para instalar la app cliente y el SDK en tu dispositivo de prueba.

Cómo compilar tu SDK para la distribución

Debes compilar tu SDK como un Paquete del SDK de Android (ASB) antes de publicarla en una tienda de aplicaciones. ASB es una publicación no firmada. equivalente a Android App Bundles.

El ASB o su derivado de Android SDK Archive (ASAR), juntos con el AAB de la app se convierten mediante Bundletool en un conjunto de APKs instalables. Aplicación los desarrolladores pueden usar BundleTool directamente en Android Studio (actualmente, Canary version) para obtener todas las variantes de APK.

Bundletool toma un AAB y un ASB, y puede generar un conjunto de variantes de APK:

Un APK compilado para ejecutarse en el modo retrocompatible del entorno de ejecución de SDK, por dispositivos que no son compatibles con el entorno de ejecución de SDK (Android 13 y versiones anteriores). Este APK contiene todo el código necesario para la app y el SDK.
Un APK compilado para ejecutar el modo de entorno de ejecución de SDK en dispositivos compatibles con la Entorno de ejecución de SDK (Android 14 y versiones posteriores). Este APK contiene solo las código de la app, con stubs de API para el SDK habilitado para el entorno de ejecución.
El APK del SDK con el código del SDK habilitado para el entorno de ejecución, que se debería instalar antes el APK de la app que se describe en el paso anterior.

Puedes compilar un ASB de dos maneras:

Android Studio
1. Compila tu proyecto. Para ello, se debe llamar a Build > Volver a compilar el proyecto.
2. El archivo ASB se encuentra en el módulo ASB habilitado para el entorno de ejecución, en build/outputs/asb/single/<your-asb-module-name>.asb
Línea de comandos de Bundletool estas instrucciones.

El SDK debe firmarse con una clave de carga antes de poder publicarlo. Usar esta para firmar tu ASB y subirla a SDK Console. Google usa el certificado de carga para verificar tu identidad.

Los siguientes pasos son una descripción general de lo que debes hacer para firmar tu ASB:

Genera un almacén de claves y una clave de carga. Esto es igual a generar un almacén de claves y una clave de carga para apps
Firma tu ASB con la clave de carga. Para ello, agrega un bloque signingConfig al archivo build.gradle que especifica la clave recién creada y el almacén de claves:

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

Las tiendas de aplicaciones pueden desarrollar diferentes estrategias para usar estos componentes Distribución de apps habilitadas para el entorno de ejecución. El entorno de ejecución de SDK funciona de forma continua con la app para extender la compatibilidad con los SDKs habilitados para el entorno de ejecución.

Paso 4: Consume el SDK habilitado para el entorno de ejecución