Cómo instalar el SDK de Maps para Android versión 3.1.0 beta

En esta guía, se muestra cómo instalar el SDK de Maps para Android versión 3.1.0 BETA. Una vez que lo instales, obtén información para usar las nuevas funciones.

Cómo instalar el SDK de Maps para Android versión 3.1.0 beta

Sigue estos pasos para agregar manualmente la biblioteca cliente del SDK de Maps para Android versión 3.1.0 beta a tu proyecto de Android Studio.

  1. Descarga la biblioteca estática de Places (puedes omitir este paso si no usas Places):

  2. Copia el archivo AAR en la carpeta app/libs de tu proyecto de Android Studio.
  3. La biblioteca del SDK de Maps para Android está disponible a través del repositorio Maven de Google. Para agregar el SDK a tu app, haz lo siguiente:

  4. En la sección buildscript.repositories de tu archivo build.gradle de nivel superior, asegúrate de que se incluya el repositorio Maven de Google:

    buildscript {
        repositories {
            google()
            // ...
        }
    }
  5. En la sección dependencies de tu archivo build.gradle a nivel de la app, agrega el SDK de Maps para Android y, opcionalmente, la biblioteca estática de Places y sus dependencias requeridas:

    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'
    }
  6. En la sección dependencies del archivo build.gradle a nivel de la app, quita la línea de implementación de la versión anterior (será similar a la siguiente):

  7. implementation 'com.google.android.gms:play-services-maps:17.0.0'

    Si usas el plan premium de Google Maps Platform, la línea de implementación que se debe quitar será como alguna de estas dos opciones:

    implementation(name:'google-maps-sdk-m4b', ext:'aar')
    implementation project(':googlemapssdkm4b_lib')
    
  8. Sincroniza tu proyecto de Gradle.
  9. Convierte las configuraciones existentes.

    • Si tu app existente usa el SDK de Maps para Android a través de los Servicios de Google Play, reemplaza todas las referencias al paquete com.google.android.gms.maps con el paquete com.google.android.libraries.maps (usa Edit > Replace in Path... en Android Studio).
    • Si tu app existente usa el plan premium de Google Maps Platform, reemplaza todas las referencias al paquete com.google.android.m4b.maps con el paquete com.google.android.libraries.maps. Además, quita el prefijo m4b_ de todas las referencias a los atributos de diseño XML. Por ejemplo: m4b_mapType debe convertirse en mapType, y m4b_cameraZoom debe convertirse en cameraZoom.
  10. Actualiza tus reglas ProGuard para mantener las clases del SDK de Maps para Android cuando se habiliten la reducción y ofuscación de código en las compilaciones de lanzamiento.

    -keep,allowoptimization class com.google.android.libraries.maps.** { *; }
    

Cómo importar la biblioteca de utilidades compatible con la versión beta

Si usas la biblioteca de utilidades de la API de Google Maps para Android, también deberás actualizar las dependencias de tu proyecto para reemplazar la versión existente por una compatible con la versión beta. Para ello, haz lo siguiente:

  1. Importa la biblioteca de utilidades compatible con la versión beta en tu archivo build.gradle:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
    
  2. Quita lo siguiente de build.gradle para quitar la biblioteca de utilidades no compatible con la versión beta:
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'
    

Cómo ejecutar las muestras

En el repositorio de muestras de código de Google en GitHub se incluyen apps de ejemplo que muestran el uso del SDK de Maps para Android versión 3.1.0.