Questa guida è rivolta ai publisher che integrano una build con accesso in anteprima dell'SDK Google Mobile Ads per Android nella loro app per Android. Le build con accesso in anteprima offrono l'opportunità di sfruttare le nuove funzionalità dell'SDK Google Mobile Ads senza attendere la prossima release di Google Play Services e offrono i seguenti vantaggi:
Iniziano automaticamente a utilizzare la più recente implementazione dell'SDK Google Mobile Ads dall'APK di Google Play Services non appena viene lanciata la funzionalità di accesso in anteprima nell'APK.
Sono testati completamente e soddisfano gli stessi criteri di rilascio delle build pubbliche disponibili nel Repository Maven di Google o in SDK Manager.
Sono versioni complete dell'SDK Google Mobile Ads, che sono più grandi dell'SDK Lite, ma non sono soggette alle limitazioni dell'SDK Lite.
Possono essere utilizzati in tutto il mondo e non solo nelle app distribuite tramite Google Play.
Segui i passaggi riportati in questa pagina per configurare un Repository Maven locale con accesso in anteprima all'SDK Google Mobile Ads e utilizzarlo come dipendenza nella tua app per Android.
Prerequisiti
- Utilizzare Android Studio 3.0 o versioni successive
- Scegli come target il livello API Android 16 o successivo
- File ZIP dell'SDK Google Mobile Ads con accesso in anteprima fornito dall'account manager
Configura un Repository Maven personalizzato
Scarica il file ZIP dell'SDK Google Mobile Ads con accesso in anteprima. Crea una cartella gma_sdk_repo nella directory di primo livello del progetto e posiziona l'intero contenuto dello zip in questa cartella. La struttura della directory dovrebbe essere
simile a <project_root_dir>/gma_sdk_repo/com/google/....
Apri il file build.gradle a livello di progetto dell'app.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
Aggiungi la riga in grassetto alla sezione allprojects/repositories. Questo indica
di cercare un Repository Maven nella cartella gma_sdk_repo appena
creata durante la risoluzione delle dipendenze.
Aggiungi dipendenza dalla build
Per utilizzare la build con accesso in anteprima dell'SDK Google Mobile Ads nel tuo progetto, devi anche farvi riferimento come dipendenza nel file build.gradle a livello di app:
apri il file build.gradle a livello di app e aggiungi la riga in grassetto nello snippet alla
sezione dependencies.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
La versione della dipendenza, mostrata da x.y.z nello snippet precedente, può essere determinata individuando l'ultima versione presente nella directory com/google/android/gms/play-services-ads/ nei contenuti non archiviati del file ZIP dell'SDK Google Mobile Ads con accesso in anteprima.
Risolvi i conflitti di Firebase
Se utilizzi una libreria Firebase insieme all'SDK Mobile Ads, potresti includere entrambe le dipendenze com.google.android.gms:play-services-measurement-api e com.google.android.gms:play-services-measurement-sdk-api nel progetto. Le versioni di queste due dipendenze devono corrispondere, ma potresti scoprire che la build con accesso in anteprima all'SDK Mobile Ads e la tua versione attuale di Firebase hanno eseguito il pull in versioni diverse per queste due dipendenze.
Come soluzione alternativa, puoi forzare la risoluzione della dipendenza da una versione specifica della libreria play-services-measurement-sdk-api nel file build.gradle dell'app nel seguente modo:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
La versione x.y.z dipende dalla versione di Firebase che utilizzi. Ecco le versioni corrette delle recenti release di Firebase:
firebase-core versione
|
play-services-measurement-sdk-api versione
|
|---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
Per cercare la versione corretta per altre versioni di Firebase, esegui gradle androidDependencies per la tua app e utilizza la versione stampata per la dipendenza com.google.android.gms:play-services-measurement-api.
La tua app Android è ora pronta per essere utilizzata con una build con accesso in anteprima dell'SDK Android Google Mobile Ads.