Como instalar o SDK do Maps para Android v.3.1.0 Beta

Este guia mostra como instalar o SDK do Maps para Android v.3.1.0 Beta. Depois da instalação, veja como usar os novos recursos.

Instalar o SDK do Maps para Android v3.1.0 Beta

Siga estas etapas para adicionar manualmente a biblioteca de cliente do SDK do Maps para Android v3.1.0 Beta ao seu projeto do Android Studio.

  1. Faça o download da biblioteca estática do Places. Pule esta etapa se não estiver usando o Places:

  2. Copie o arquivo AAR na pasta app/libs do seu projeto do Android Studio.
  3. A biblioteca do SDK do Maps para Android está disponível no repositório Maven do Google. Para adicionar o SDK ao app, faça o seguinte:

  4. Verifique se o repositório Maven do Google aparece na seção buildscript.repositories do seu arquivo build.gradle no nível superior:

    buildscript {
        repositories {
            google()
            // ...
        }
    }
  5. Na seção dependencies do arquivo build.gradle do app, adicione o SDK do Maps para Android e, opcionalmente, a biblioteca estática do Places e as dependências necessárias:

    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. Na seção dependencies do arquivo build.gradle no nível do app, remova a linha de implementação da versão anterior, que é semelhante a esta:

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

    Se você estiver usando o plano premium da Plataforma Google Maps, a linha de implementação a ser removida será como esta:

    implementation(name:'google-maps-sdk-m4b', ext:'aar')
    implementation project(':googlemapssdkm4b_lib')
    
  8. Sincronize seu projeto do Gradle.
  9. Converta as configurações atuais.

    • Se o app atual usar o SDK do Maps para Android pelo Google Play Services, substitua todas as referências ao pacote com.google.android.gms.maps pelo pacote com.google.android.libraries.maps. Selecione Edit > Replace in Path... no Android Studio.
    • Se o app atual usa o plano premium da Plataforma Google Maps, substitua todas as referências ao pacote com.google.android.m4b.maps pelo pacote com.google.android.libraries.maps. Além disso, remova o prefixo m4b_ de todas as referências aos atributos de layout XML. Por exemplo: m4b_mapType precisa ser mapType, e m4b_cameraZoom precisa ser cameraZoom.
  10. Atualize suas regras do ProGuard para manter as classes do SDK do Maps para Android quando a redução e a ofuscação de código estiverem ativadas nos builds de lançamento.

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

Importar a biblioteca de utilitários compatível com a versão Beta

Se você estiver usando a biblioteca de utilitários da API Google Maps Android, será necessário atualizar as dependências do projeto para substituir a versão atual por aquela que é compatível com a versão Beta. Para isso, faça o seguinte:

  1. Importe a biblioteca util compatível com a versão Beta no seu arquivo build.gradle:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
    
  2. Remova o seguinte do seu build.gradle para excluir a biblioteca de utilitários não compatíveis com a versão Beta:
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'
    

Executar as amostras

O repositório de amostras do Google no GitHub inclui apps de amostra que demonstram o uso do SDK do Maps para Android v3.1.0 Beta.