Para desenvolver um app usando as APIs do Google Play Services, siga as instruções desta página para configurar seu projeto com os SDKs relevantes, que estão disponíveis no repositório maven do Google.
Para testar seu app ao usar o Google Play Services, use uma das seguintes opções:
- Um dispositivo Android compatível que execute o Android 4.4 (API de nível 19) ou versões mais recentes e tenha o app Google Play Store instalado.
- O Android Emulator com um AVD que executa a plataforma de APIs do Google com base no Android 4.4 (API de nível 19) ou versão mais recente.
Declarar dependências no Google Play Services
Para desenvolver recursos que dependem das APIs do Google Play Services no seu app, siga estas etapas:
Abra o arquivo
build.gradle
no diretório do módulo do seu app.Inclua a dependência de cada SDK exigido pelo app. Esta página inclui uma seção que lista dependências comuns do Google Play Services para apps Android. Talvez você também queira adicionar dependências do Firebase ao seu projeto.
Salve as alterações e sincronize seu projeto.
O snippet a seguir mostra um exemplo de arquivo build.gradle
que usa a
biblioteca de localização:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.0.1'
}
Novas versões dos SDKs do Google Play Services com correções de bugs e novos recursos são lançadas periodicamente. Essas atualizações são anunciadas nas notas da versão. Caso o app use uma dependência atualizada, mude para a versão mais recente nas dependências para aproveitar essas correções.
Verificar se o Google Play Services está instalado
Conforme descrito na Visão geral do Google Play Services, ele recebe atualizações automáticas no Android 4.4 (nível 19 da API) e versões mais recentes pelo app Google Play Store. No entanto, dispositivos Android sem a Google Play Store não têm o Google Play Services instalado. Se o app for executado em dispositivos sem o Google Play Services, confira se ele está instalado antes de tentar usar APIs do Google ou ative os recursos que precisam do Google Play Services para funcionar.
Para verificar a presença do Google Play Services no dispositivo, use o
método
isGooglePlayServicesAvailable()
.
Para iniciar uma conexão com o Google Play Services ou aprender a detectar se a versão do Google Play Services instalada é compatível com uma API específica, leia o guia em Como acessar APIs do Google.
Dependências do Google Play Services
A tabela a seguir lista as dependências do Google Play Services que podem ser incluídas no app Android. É possível filtrar a lista por tipo de dispositivo selecionando um dos botões e pesquisar um caso de uso ou nome de dependência específico digitando o texto na caixa que aparece após os botões.
Nome do caso de uso e dependência | Dispositivos com suporte |
---|---|
Anúncios para dispositivos móveis do Googlecom.google.android.gms:play-services-ads:21.5.0 |
Smartphone, tablet |
ID de publicidade do Android (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 |
Smartphone, tablet, Android TV e Chrome OS |
Versão leve dos anúncios para dispositivos móveis do Googlecom.google.android.gms:play-services-ads-lite:21.5.0 |
Smartphone, tablet |
Anúncios personalizados de pesquisa (CSAs) do AdSense para pesquisas (AFS)com.google.android.gms:play-services-afs-native:19.0.3 |
Smartphone, tablet e Chrome OS |
SDK de serviços do Google Analytics para Androidcom.google.android.gms:play-services-analytics:18.0.2 |
Obsoleto. Use o Google Analytics para Firebase. |
Índice do appcom.google.android.gms:play-services-appindex:16.1.0 |
Smartphone, tablet e Android TV |
ID do conjunto de apps Androidcom.google.android.gms:play-services-appset:16.0.2 |
Smartphone, tablet, Android TV e Chrome OS |
Login do Google para Androidcom.google.android.gms:play-services-auth:20.4.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.0.1 |
Smartphone, tablet e Android Go |
API Block Store (inclui armazenamento de credenciais do usuário)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Google Awarenesscom.google.android.gms:play-services-awareness:19.0.1 |
Smartphone, tablet, Auto, Android Go, ChromeOS |
Classes de serviços públicoscom.google.android.gms:play-services-base:18.2.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Como testar falsificações para classes de utilitárioscom.google.android.gms:play-services-base-testing:16.0.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Mais classes de utilitárioscom.google.android.gms:play-services-basement:18.2.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.2.0 |
Smartphone, tablet, Android Go, ChromeOS |
CAF Application Framework (CAF) do Google Castcom.google.android.gms:play-services-cast-framework:21.2.0 |
Smartphone, tablet, Android Go, ChromeOS |
Receptores do Android TVcom.google.android.gms:play-services-cast-tv:20.0.0 |
Android TV |
Leitor de código do Googlecom.google.android.gms:play-services-code-scanner:16.0.0-beta3 |
Smartphone, tablet, Android Go, ChromeOS |
Pilha de rede do Chromium (Cronet)com.google.android.gms:play-services-cronet:18.0.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Interações entre dispositivos (DTDI, na sigla em inglês)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
Smartphone, tablet e Android Go |
Autenticação on-line de Entidade rápida (FIDO, na sigla em inglês)com.google.android.gms:play-services-fido:19.0.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Compatível com dispositivos com Android 7.0 (API de nível 24) ou versões mais recentes. |
API Google Fit para Androidcom.google.android.gms:play-services-fitness:21.1.0 |
Smartphone, tablet, Android Go, ChromeOS, Wear OS |
Serviços relacionados a jogos do Google Play v2 para Androidcom.google.android.gms:play-services-games-v2:17.0.0 |
Smartphone, tablet, Android TV, Android Go e ChromeOS |
SDK dos serviços relacionados a jogos do Google Play v2 C para Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Smartphone, tablet, Android TV, Android Go e ChromeOS |
Serviços relacionados a jogos do Google Play v1 para Androidcom.google.android.gms:play-services-games:23.1.0 |
Smartphone, tablet, Android TV, Android Go e ChromeOS |
API Mattercom.google.android.gms:play-services-home:16.0.0 |
Smartphone, tablet |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.0.1 |
Smartphone, tablet, Android TV, Android Go e ChromeOS Compatível com dispositivos com o Android 5.0 (API de nível 21) ou versões mais recentes. |
Provedor de localização combinada para Android (reconhecimento de atividade e fronteira geográfica virtual)com.google.android.gms:play-services-location:21.0.1
| Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK do Google Maps para Androidcom.google.android.gms:play-services-maps:18.1.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Leitura de código de barras do Kit de MLcom.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0 |
Smartphone, tablet, Android Go, ChromeOS |
Detecção facial do Kit de MLcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Smartphone, tablet, Android Go, ChromeOS |
Rotulagem de imagem do Kit de MLcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Smartphone, tablet, Android Go, ChromeOS |
Rótulo personalizado da imagem do kit de MLcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4 |
Smartphone, tablet, Android Go, ChromeOS |
Identificação de idioma do kit de MLcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Resposta inteligente do Kit de MLcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de MLcom.google.android.gms:play-services-mlkit-text-recognition:18.0.2 |
Smartphone, tablet, Android Go, ChromeOS |
Conexão e descoberta de dispositivos por pertocom.google.android.gms:play-services-nearby:18.4.0 |
Smartphone, tablet, Android TV, Auto e Android Go |
Mostrar licenças de código abertocom.google.android.gms:play-services-oss-licenses:17.0.0 |
Smartphone, tablet, Android TV, Auto, Android Go e Chrome OS Compatível com dispositivos com o Android 5.0 (API de nível 21) ou versões mais recentes. |
Verificação de qualidade do bloqueio de tela com.google.android.gms:play-services-password-complexity:18.0.1 |
Smartphone, tablet, Android Go, ChromeOS e Wear OS Compatível com dispositivos com Android 4.4 (API de nível 19) a Android 9 (API de nível 28). |
Google Pay for Passescom.google.android.gms:play-services-pay:16.1.0 |
Smartphone, tablet, Android Go e ChromeOS Compatível com dispositivos com o Android 5.0 (API de nível 20) ou versões mais recentes. |
reCAPTCHA Enterprise para instrumentação do appcom.google.android.gms:play-services-recaptcha:17.0.1 |
Smartphone, tablet, Android TV, Android Go e ChromeOS |
APIs SafetyNet (inclui atestado de dispositivo, navegação segura, reCAPTCHA e verificação de app)com.google.android.gms:play-services-safetynet:18.0.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS |
Gerenciador de tags do Googlecom.google.android.gms:play-services-tagmanager:18.0.2 |
Smartphone, tablet, Android TV, Android Go e ChromeOS |
API Tasks no Androidcom.google.android.gms:play-services-tasks:18.0.2 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
API TensorFlow Lite Delegate API para o Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.1.0 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Java para Google Play Servicescom.google.android.gms:play-services-tflite-java:16.0.1 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Support para Google Play Servicescom.google.android.gms:play-services-tflite-support:16.0.1 |
Smartphone, tablet, Android Go, ChromeOS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.0.0 |
Smartphone, tablet |
Visão para dispositivos móveiscom.google.android.gms:play-services-vision:20.1.3 |
Smartphone, tablet, Android Go, ChromeOS |
Google Pay para pagamentos no Androidcom.google.android.gms:play-services-wallet:19.1.0 |
Smartphone, tablet, Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:18.0.0 |
Smartphone, tablet, Wear OS |
Plug-ins do Gradle
O Google Play Services também inclui vários plug-ins do Gradle, conforme mostrado na tabela a seguir. Os botões que aparecem antes da tabela anterior não alteram as informações que aparecem nela.
Caso de uso e nome do plug-in para Gradle | Dispositivos com suporte |
---|---|
Mostrar licenças de código abertocom.google.android.gms:oss-licenses-plugin:0.10.6 |
Smartphone, tablet e Chrome OS |
Verificação de versão rigorosacom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |