Installer le SDK Maps pour Android version 3.1.0 BÊTA

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.

  1. Téléchargez la bibliothèque statique Places (vous pouvez ignorer cette étape si vous n'utilisez pas Places) :

  2. Copiez le fichier AAR dans le dossier app/libs de votre projet Android Studio.

    3. 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 :

  3. Dans la section buildscript.repositories de votre fichier build.gradle racine, assurez-vous que le dépôt Maven de Google est répertorié comme suit :

    buildscript {
    repositories {
        google()
        // ...
    }
}

  4. Dans la section dependencies de votre fichier build.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'
}

  5. Dans la section dependencies du fichier build.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) :

    6. 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')
  6. Synchronisez votre projet Gradle.

  7. 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 package com.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 package com.google.android.libraries.maps. Supprimez également le préfixe m4b_ de toutes les références aux attributs de mise en page XML. Par exemple, m4b_mapType doit devenir mapType et m4b_cameraZoom doit devenir cameraZoom.

  8. 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.** { *; }

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 :

  1. 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'
  2. 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.