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.
-
Faça o download da biblioteca estática do Places. Pule esta etapa se não estiver usando o Places:
- places-maps-sdk-3.1.0-beta.aar (opcional, somente para uso com o Maps v 3.1.0 Beta)
- Copie o arquivo AAR na pasta
app/libs
do seu projeto do Android Studio. -
Verifique se o repositório Maven do Google aparece na seção
buildscript.repositories
do seu arquivobuild.gradle
no nível superior:buildscript { repositories { google() // ... } }
-
Na seção
dependencies
do arquivobuild.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' }
Na seção
dependencies
do arquivobuild.gradle
no nível do app, remova a linha de implementação da versão anterior, que é semelhante a esta:- Sincronize seu projeto do Gradle.
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 pacotecom.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 pacotecom.google.android.libraries.maps
. Além disso, remova o prefixom4b_
de todas as referências aos atributos de layout XML. Por exemplo:m4b_mapType
precisa sermapType
, em4b_cameraZoom
precisa sercameraZoom
.
- Se o app atual usar o SDK do Maps para Android pelo Google Play Services, substitua todas as referências ao pacote
-
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.** { *; }
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:
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')
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:
- 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'
- 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.
- Amostras do SDK do Maps para Android
- Amostras do SDK do Places para Android (apenas para uso com o Maps v3.1.0 Beta)