Criar e consumir um SDK ativado pelo ambiente de execução

Criar e configurar um app de teste

Esta seção explica como configurar e preparar um app para consumir um ambiente de execução SDK para testes locais.

Preparar seu app

Primeiro, crie um projeto ou módulo independente.

Nesse cenário, o app não contém o código do SDK, mas o declara como uma dependência do Maven.

Criar um app que consome um SDK ativado pelo ambiente de execução exige o Android Studio Ladybug Canary 1 ou mais recente e o Plug-in do Android para Gradle (AGP) 8.7.0-alpha01 ou mais recente.

1. Siga as mesmas etapas descritas anteriormente para configurar seu ambiente de desenvolvimento e dispositivo/emulador para testes.

2. Ative o SDK Runtime usando a flag descrita em Etapa 3:preparar a seção do SDK.

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

3. Adicione o URL do Maven do Sandbox de privacidade ao arquivo build.gradle de nível superior do projeto.

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

4. Mantenha a dependência do Maven no destino do Maven da biblioteca de anúncios existente (SDK com reconhecimento de ambiente de execução).

5. Adicionar um bloco privacySandbox ao build.gradle do projeto com uma dependência na biblioteca do SDK e definir "enable" como verdadeiro

   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. Agora, o aplicativo pode usar as APIs do SDK da mesma forma que explicado na seção sobre consumo da API.

Criar seu app

É possível criar seus apps como um Android App Bundle (AAB) como você faria normalmente.

Testar o SDK localmente

Para executar o app de teste, instale o SDK e o app ativados pelo ambiente de execução dispositivo ou emulador usando o Android Studio.

1. Abra o projeto do app de teste no Android Studio.
2. Acesse Run > Edit Configurations. A janela de configuração "Run/Debug" vai aparecer. É possível implantar como "APK padrão" ou "APK do pacote".
3. Em Launch Options, defina Launch como Specified Activity.
4. Clique no menu de três pontos ao lado de Atividade e selecione o menu Atividade para o cliente.
5. Clique em Apply e em OK.
6. Clique em Run para instalar o app cliente e o SDK no dispositivo de teste.

Criar seu SDK para distribuição

Você precisa criar seu SDK como um Android SDK Bundle (ASB) antes de publicá-lo em uma app store. O ASB é um pacote de publicação não assinado equivalente aos Android App Bundles.

O ASB ou derivado dele, o Android SDK Archive (ASAR), em conjunto. com o AAB do app são transformados pelo Bundletool em um conjunto de APKs instaláveis. Os desenvolvedores de apps podem usar o BundleTool diretamente no Android Studio (atualmente na versão Canary) para gerar todas as variantes de APK.

O Bundletool usa um AAB e um ASB e pode gerar um conjunto de variantes de APK:

1. Um APK criado para execução no modo compatível com versões anteriores do SDK Runtime, para dispositivos que não são compatíveis com o SDK Runtime (Android 13 e versões anteriores). Esse APK contém todo o código necessário para o app e o SDK.
2. Um APK criado para executar o modo SDK Runtime em dispositivos compatíveis com o SDK Runtime (Android 14 e mais recentes). Esse APK contém apenas o código do app, com stubs de API para o SDK ativado pelo ambiente de execução.
3. O APK do SDK com o código do SDK ativado pelo ambiente de execução, precisa ser instalado antes o APK do app descrito na etapa anterior.

É possível criar um ASB de duas maneiras:

• Android Studio
  1. Crie o projeto. Para fazer isso, chame Build > Rebuild.
  2. O arquivo ASB fica no módulo ASB ativado pelo ambiente de execução em build/outputs/asb/single/<your-asb-module-name>.asb
• Linha de comando do Bundletool - seguir estas instruções.

O SDK precisa ser assinado com uma chave de upload antes de ser publicado. Use essa chave de upload para assinar o ASB e fazer o upload dele no SDK Console. O Google usa o certificado de upload para verificar sua identidade.

As etapas a seguir são uma visão geral do que você precisa fazer para assinar o ASB:

1. Gere um keystore e uma chave de upload. É idêntico a como gerar um keystore e uma chave de upload para aplicativos.
2. Assine seu ASB com a chave de upload. Para fazer isso, adicione um bloco "signingConfig" ao arquivo build.gradle especificando a chave recém-criada e o keystore:

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

As app stores podem desenvolver estratégias diferentes para usar esses componentes e oferecer suporte à distribuição de apps ativada no momento de execução. O SDK Runtime está funcionando continuamente com o app para ampliar o suporte a SDKs ativados pelo ambiente de execução.

arrow_back_iosEtapa 4: consumir o SDK ativado pelo ambiente de execução