Este guia é destinado a editores que integram um build de acesso antecipado do SDK dos anúncios para dispositivos móveis do Google para Android ao app Android. Os builds de acesso antecipado oferecem a oportunidade de aproveitar os novos recursos do SDK dos anúncios para dispositivos móveis do Google sem esperar pela próxima versão do Google Play Services e oferecer os seguintes benefícios:
Eles começam a usar automaticamente a implementação mais recente do SDK dos anúncios para dispositivos móveis do Google no APK do Google Play Services assim que o recurso de acesso antecipado é lançado no APK.
Eles foram totalmente testados e atendem aos mesmos critérios de lançamento que os builds públicos disponíveis no repositório Maven do Google ou no SDK Manager.
Elas são versões completas do SDK dos anúncios para dispositivos móveis do Google, maiores do que o SDK do Lite, mas não estão sujeitas às limitações do SDK do Lite.
Eles podem ser usados globalmente, e não apenas em apps distribuídos pelo Google Play.
Siga as etapas desta página para configurar um repositório Maven local com o SDK dos anúncios para dispositivos móveis do Google com acesso antecipado e referenciá-lo como uma dependência no seu app Android.
Pré-requisitos
- Usar o Android Studio 3.0 ou uma versão mais recente.
- Segmentar o nível 16 ou mais recente da API do Android
- Arquivo ZIP com acesso antecipado do SDK dos anúncios para dispositivos móveis do Google fornecido pelo gerente de contas
Configurar repositório Maven personalizado
Faça o download do arquivo ZIP do SDK dos anúncios para dispositivos móveis do Google para acesso antecipado. Crie uma
pasta gma_sdk_repo
no diretório de nível superior do projeto e coloque
todo o conteúdo do ZIP nessa pasta. A estrutura de diretórios precisa ser semelhante
a <project_root_dir>/gma_sdk_repo/com/google/...
.
Abra o arquivo build.gradle
no nível do projeto do app.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
Adicione a linha em negrito à seção allprojects/repositories
. Isso instrui o
Gradle a procurar um repositório Maven na pasta gma_sdk_repo
que você acabou
de criar ao resolver dependências.
Adicionar dependência de build
Para usar o build de acesso antecipado do SDK dos anúncios para dispositivos móveis do Google no seu projeto, você
também precisa referenciá-lo como uma dependência no arquivo build.gradle
no nível do app:
abra o arquivo build.gradle
no nível do app e adicione a linha em negrito no snippet à
seção dependencies
.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
A versão de dependência, mostrada por x.y.z no snippet anterior, pode
ser determinada localizando a versão mais recente presente no diretório
com/google/android/gms/play-services-ads/
no conteúdo desarquivado
do arquivo ZIP com acesso antecipado do SDK dos anúncios para dispositivos móveis do Google para Android.
Resolver conflitos do Firebase
Se você estiver usando uma biblioteca do Firebase com o SDK dos anúncios para dispositivos móveis, poderá ter
as dependências com.google.android.gms:play-services-measurement-api
e
com.google.android.gms:play-services-measurement-sdk-api
incluídas
no projeto. As versões dessas duas dependências precisam ser correspondentes, mas você
pode descobrir que a versão de acesso antecipado do SDK dos anúncios para dispositivos móveis e a versão atual
do Firebase extraíram versões diferentes para essas duas dependências.
Como solução alternativa, você pode forçar a resolução da dependência para uma versão específica
da biblioteca play-services-measurement-sdk-api
no arquivo build.gradle
do app da seguinte maneira:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
A versão x.y.z
depende da sua versão do Firebase. Veja a seguir as versões corretas
para lançamentos recentes do Firebase:
Versão do firebase-core
|
Versão do play-services-measurement-sdk-api
|
---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
Para procurar a versão correta de outras versões do Firebase, execute
gradle androidDependencies
no app e use a versão impressa para
a dependência com.google.android.gms:play-services-measurement-api
.
Seu app Android agora está pronto para uso com uma versão de acesso antecipado do SDK dos anúncios para dispositivos móveis do Google para Android.