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

Compila y configura una app de prueba

En esta sección, se explica cómo configurar y preparar una app para que consuma un SDK habilitado para el tiempo de ejecución para realizar pruebas locales.

Prepara tu app

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

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

Para compilar una app que consuma un SDK habilitado para el entorno de ejecución, se 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.

1. Sigue los mismos pasos que se describieron anteriormente para configurar tu entorno de desarrollo y tu dispositivo o emulador para realizar pruebas.

2. Habilita el entorno de ejecución del SDK con la marca que se describe en la sección del paso 3: Prepara tu SDK.

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

3. 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"
                   }
               }
           }
   

4. Mantén la dependencia de Maven en el destino de Maven de la biblioteca de anuncios existente (tu SDK compatible con el tiempo de ejecución).

5. Agrega un bloque privacySandbox al archivo build.gradle del proyecto con una dependencia en la biblioteca del SDK y establece enable como verdadero.

   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. Ahora la app puede usar las APIs del SDK de la misma manera que se explica en la sección sobre el consumo de APIs.

Compila tu app

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

Prueba tu SDK de forma local

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

1. Abre el proyecto de Android Studio de tu app de prueba.
2. Ve a Run > Edit Configurations. Aparecerá la ventana de configuración "Run/Debug". Puedes realizar la implementación como "APK predeterminado" o "APK desde el paquete".
3. En Launch Options, establece Launch en Specified Activity.
4. Haz clic en el menú de tres puntos junto a Activity y selecciona la actividad principal de tu cliente.
5. Haz clic en Apply y, luego, en OK.
6. Haz clic en Run para instalar la app cliente y el SDK en tu dispositivo de prueba.

Compila tu SDK para la distribución

Debes compilar tu SDK como un paquete del SDK de Android (ASB) antes de publicarlo en una tienda de aplicaciones. El ASB es un paquete de publicación sin firma equivalente a los Android App Bundles.

Bundletool convierte el ASB, o su derivado, el archivo del SDK de Android (ASAR), junto con el AAB de la app, en un conjunto de APKs instalables. Los desarrolladores de apps pueden usar BundleTool directamente en Android Studio (actualmente, en la versión Canary) para generar todas las variantes de APK.

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

1. Es un APK compilado para ejecutarse en el modo de retrocompatibilidad del entorno de ejecución de SDK para 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.
2. Es un APK compilado para ejecutar el modo de entorno de ejecución de SDK en dispositivos compatibles con el entorno de ejecución de SDK (Android 14 y versiones posteriores). Este APK solo contiene el código de la app, con stubs de API para el SDK habilitado para el tiempo de ejecución.
3. APK del SDK con el código del SDK habilitado para el entorno de ejecución, que se instalará antes del APK de la app que se describió en el paso anterior.

Puedes crear un ASB de dos maneras:

• Android Studio
  1. Compila tu proyecto. Para ello, llama a Build > Rebuild project.
  2. El archivo ASB se encuentra en tu módulo ASB habilitado para el tiempo de ejecución en build/outputs/asb/single/<your-asb-module-name>.asb.
• Línea de comandos de Bundletool: Sigue estas instrucciones.

El SDK debe firmarse con una clave de carga antes de que puedas publicarlo. Usa esta clave de carga para firmar tu ASB y subirlo 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:

1. Genera un almacén de claves y una clave de carga. Este proceso es idéntico al de generar un almacén de claves y una clave de carga para las apps.
2. Firma tu ASB con la clave de carga. Para ello, agrega un bloque signingConfig a tu archivo build.gradle que especifique la clave y el almacén de claves recién creados:

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 y admitir la distribución de apps habilitadas para el tiempo de ejecución. El entorno de ejecución de SDK trabaja continuamente con las tiendas de aplicaciones para ampliar la compatibilidad con los SDKs habilitados para el entorno de ejecución.

arrow_back_iosPaso 4: Consume el SDK habilitado para el tiempo de ejecución