Ce guide est destiné aux éditeurs qui intègrent une version en accès anticipé du SDK Google Mobile Ads pour Android dans leur application Android. Ces versions permettent de profiter des nouvelles fonctionnalités du SDK Google Mobile Ads sans attendre la prochaine version des services Google Play. Elles offrent les avantages suivants:
Dès que la fonctionnalité en accès anticipé est lancée dans l'APK, ils commencent automatiquement à utiliser la nouvelle implémentation du SDK Google Mobile Ads à partir de l'APK des services Google Play.
Elles sont entièrement testées et répondent aux mêmes critères de publication que les builds publics disponibles dans le dépôt Maven de Google ou dans SDK Manager.
Il s'agit de versions complètes du SDK Google Mobile Ads, dont la taille est supérieure au SDK Lite, mais ne sont pas soumises aux limites du SDK Lite.
Elles peuvent être utilisées dans le monde entier, et pas seulement dans les applications distribuées via Google Play.
Suivez les étapes de cette page pour configurer un dépôt Maven local avec le SDK Google Mobile Ads en accès anticipé et le référencer en tant que dépendance dans votre application Android.
Conditions préalables
- utiliser Android Studio 3.0 ou version ultérieure ;
- Cibler le niveau d'API Android 16 ou supérieur
- Fichier ZIP du SDK Google Mobile Ads en accès anticipé fourni par le responsable de compte
Configurer un dépôt Maven personnalisé
Téléchargez le fichier ZIP du SDK Google Mobile Ads en accès anticipé. Créez un dossier gma_sdk_repo dans le répertoire de premier niveau de votre projet et placez l'intégralité du contenu du fichier ZIP dans ce dossier. Votre structure de répertoire doit se présenter comme suit : <project_root_dir>/gma_sdk_repo/com/google/....
Ouvrez le fichier build.gradle au niveau du projet de votre application.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
Ajoutez la ligne en gras dans la section allprojects/repositories. Cela indique à Gradle de rechercher un dépôt Maven dans le dossier gma_sdk_repo que vous venez de créer lors de la résolution des dépendances.
Ajouter une dépendance de compilation
Pour utiliser la version en accès anticipé du SDK Google Mobile Ads dans votre projet, vous devez également la référencer en tant que dépendance dans votre fichier build.gradle au niveau de l'application : ouvrez le fichier build.gradle au niveau de l'application et ajoutez la ligne en gras de l'extrait à la section dependencies.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
La version de la dépendance, indiquée par x.y.z dans l'extrait précédent, peut être déterminée en recherchant la dernière version présente dans le répertoire com/google/android/gms/play-services-ads/ dans le contenu désarchivé du fichier ZIP du SDK Google Mobile Ads pour Android en accès anticipé.
Résoudre les conflits Firebase
Si vous utilisez une bibliothèque Firebase avec le SDK Mobile Ads, vous pouvez inclure les dépendances com.google.android.gms:play-services-measurement-api et com.google.android.gms:play-services-measurement-sdk-api dans votre projet. Les versions de ces deux dépendances doivent correspondre, mais vous constaterez peut-être que votre version en accès anticipé du SDK Mobile Ads et votre version actuelle de Firebase ont extrait des versions différentes pour ces deux dépendances.
Pour contourner ce problème, vous pouvez forcer la résolution de la dépendance sur une version spécifique de la bibliothèque play-services-measurement-sdk-api dans le fichier build.gradle de votre application, comme suit:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
La version x.y.z dépend de votre version de Firebase. Voici les versions correctes pour les versions récentes de Firebase:
Version de l'application firebase-core
|
Version de l'application 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
|
Pour rechercher la version correcte des autres versions de Firebase, exécutez gradle androidDependencies pour votre application et utilisez la version affichée pour la dépendance com.google.android.gms:play-services-measurement-api.
Vous pouvez désormais utiliser votre application Android avec une version en accès anticipé du SDK Google Mobile Ads pour Android.