A equipe da Plataforma Google Maps atualiza regularmente os SDKs com novos recursos, correções de bugs e melhorias na performance. Nesta página, mostramos como gerenciar suas dependências em SDKs para dispositivos móveis.
A qual versão vincular?
- No caso de apps essenciais, faça o vínculo à atualização mais recente da versão principal que você está usando (X.*). Nesse método, é preciso atualizar o app pelo menos uma vez por ano, quando uma nova versão principal é lançada.
- No caso de apps não essenciais, vincule a qualquer versão fixa. Após receber um aviso de descontinuação da versão fixa, você vai ter 12 meses para disponibilizar o código atualizado do app aos usuários. Esse método exige manutenção com menor frequência, mas pode envolver uma quantidade maior de recursos para adaptar, reescrever e testar conteúdo do que atualizações anuais. Esse trabalho precisaria ser concluído antes da descontinuação.
Os proprietários de projetos com endereços de e-mail monitorados recebem notificações proativas sobre mudanças que afetam os projetos deles. Fique sabendo de atualizações importantes, descontinuações e outras mudanças.
Instalação
No arquivo build.gradle no nível do app, sempre especifique uma versão em vez de um intervalo de prefixos (+) ou latest, já que isso pode gerar builds imprevisíveis e únicas. O SDK do Maps para Android segue o controle de versões semânticas, e novas versões principais podem incluir alterações interruptivas. O nível mínimo compatível da API é 19.
Especifique a dependência do Maps no Google Play Services usando a sintaxe do Gradle.
dependencies {
implementation 'com.google.android.gms:play-services-maps:18.0.2'
// ...
}
Veja mais orientações sobre o controle de versões do Google Play Services.
Manutenção e upgrade
O Android Studio verifica automaticamente se há versões mais recentes das dependências e avisa quando há uma nova disponível. Para minimizar o impacto técnico, atualize para a versão mais recente disponível o quanto antes. Se você estiver atualizando para uma nova versão principal, leia as notas e confira se há mudanças incompatíveis com versões anteriores e como atualizar seu código.
Os proprietários de projetos recebem notificações sobre as versões mais recentes e e-mails do Google Cloud informando sobre mudanças incompatíveis com versões anteriores que podem afetar os projetos. Para receber essas notificações, atribua a função de proprietário com um endereço de e-mail monitorado em cada um dos seus projetos.