Ce guide explique comment installer le SDK Maps pour Android version 3.1.0 BÊTA. Une fois la configuration effectuée, découvrez comment utiliser les nouvelles fonctionnalités.
Installer le SDK Maps pour Android v3.1.0 BÊTA
Procédez comme suit pour ajouter manuellement la bibliothèque cliente du SDK Maps pour Android version v3.1.0 bêta à votre projet Android Studio.
-
Téléchargez la bibliothèque statique Places (vous pouvez ignorer cette étape si vous n'utilisez pas Places) :
- places-maps-sdk-3.1.0-beta.aar (facultatif, uniquement pour Maps version 3.1.0 bêta)
- Copiez le fichier AAR dans le dossier
app/libs
de votre projet Android Studio. -
Dans la section
buildscript.repositories
de votre fichierbuild.gradle
racine, assurez-vous que le dépôt Maven de Google est répertorié comme suit :buildscript { repositories { google() // ... } }
-
Dans la section
dependencies
de votre fichierbuild.gradle
au niveau de l'application, ajoutez le SDK Maps pour Android, et éventuellement la bibliothèque statique Places et ses dépendances requises :dependencies { implementation 'com.google.android.libraries.maps:maps:3.1.0-beta' // If you are using Places, add all of the dependencies below implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar' implementation 'com.google.android.gms:play-services-gcm:17.0.0' implementation 'com.google.auto.value:auto-value-annotations:1.6.2' }
Dans la section
dependencies
du fichierbuild.gradle
au niveau de l'application, supprimez la ligne de mise en œuvre de la version précédente (qui se présente comme suit) :- Synchronisez votre projet Gradle.
Convertissez les configurations existantes.
- Si votre application existante utilise le SDK Maps pour Android via les services Google Play, remplacez toutes les références au package
com.google.android.gms.maps
par le packagecom.google.android.libraries.maps
(sélectionnez Edit > Replace in Path... dans Android Studio). - Si votre application existante utilise le forfait Premium Google Maps Platform, remplacez toutes les références au package
com.google.android.m4b.maps
par le packagecom.google.android.libraries.maps
. Supprimez également le préfixem4b_
de toutes les références aux attributs de mise en page XML. Par exemple,m4b_mapType
doit devenirmapType
etm4b_cameraZoom
doit devenircameraZoom
.
- Si votre application existante utilise le SDK Maps pour Android via les services Google Play, remplacez toutes les références au package
-
Mettez à jour vos règles ProGuard pour conserver les classes du SDK Maps pour Android lorsque la minification du code et l'obscurcissement sont activés dans les builds.
-keep,allowoptimization class com.google.android.libraries.maps.** { *; }
La bibliothèque du SDK Maps pour Android est disponible via le dépôt Maven de Google. Pour ajouter le SDK à votre application, procédez comme suit :
implementation 'com.google.android.gms:play-services-maps:17.0.0'
Si vous utilisez le forfait Premium Google Maps Platform, la ligne de mise en œuvre à supprimer ressemble à l'un ou l'autre de ces exemples :
implementation(name:'google-maps-sdk-m4b', ext:'aar') implementation project(':googlemapssdkm4b_lib')
Importer la bibliothèque d'utilitaires compatibles avec la version bêta
Si vous utilisez la bibliothèque d'utilitaires de l'API Google Maps pour Android, vous devez également mettre à jour les dépendances de votre projet afin de remplacer la version existante par celle compatible avec la version bêta. Pour ce faire, procédez comme suit :
- Importez la bibliothèque d'utilitaires compatibles avec la version bêta dans votre fichier
build.gradle
:implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
- Supprimez les éléments suivants de votre fichier
build.gradle
pour supprimer la bibliothèque d'utilitaires non compatible avec la version bêta :implementation 'com.google.maps.android:android-maps-utils:1.3.1'
Exécuter les exemples
Le dépôt Google Samples sur GitHub inclut des exemples d'applications qui illustrent l'utilisation du SDK Maps pour Android version v3.1.0 bêta.
- Exemples de SDK Maps pour Android
- Exemples de SDK Places pour Android (uniquement pour une utilisation avec Maps version 3.1.0 bêta)