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 5.0 (API de nível 21) ou mais recente 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 5.0 (API de nível 21) ou versão mais recente.
Declarar dependências para o Google Play Services
Para desenvolver recursos que dependem das APIs do Google Play Services no seu app, siga estas etapas:
Abra o arquivo
build.gradledentro do diretório de módulos do seu app.Para cada SDK que seu app exigir, inclua a dependência dele. Esta página inclui uma seção que lista as dependências comuns do Google Play Services para apps Android. Também é possível adicionar dependências do Firebase ao seu projeto.
Salve as alterações e sincronize seu projeto.
O snippet abaixo 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çados periodicamente. Essas atualizações são anunciadas nas notas da versão. Se o app usar uma dependência que foi atualizada, mude para a versão mais recente nas dependências do app para aproveitar essas correções.
Conferir 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 5.0 (nível 21 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. Caso seu app seja executado em dispositivos sem o Google Play Services, confira se ele está instalado no dispositivo antes de tentar usar as APIs do Google ou ative recursos no app que exigem o 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 instalada tem suporte a uma API específica, leia o guia sobre Como acessar as 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íficos inserindo texto na caixa exibida após os botões.
| Caso de uso e nome da dependência | Dispositivos compatíveis |
|---|---|
Anúncios para dispositivos móveis do Googlecom.google.android.gms:play-services-ads:22.4.0 |
Smartphone, tablet |
ID de publicidade do Android (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 |
Smartphone, tablet, Android TV, ChromeOS |
Versão simples dos anúncios para dispositivos móveis do Googlecom.google.android.gms:play-services-ads-lite:22.4.0 |
Smartphone, tablet |
Anúncios personalizados de pesquisa (CSA) do AdSense para pesquisas (AFS)com.google.android.gms:play-services-afs-native:19.0.3 |
Smartphone, tablet, ChromeOS |
SDK de serviços do Google Analytics para Androidcom.google.android.gms:play-services-analytics:18.0.3 |
Obsoleto. Use o Google Analytics para Firebase. |
Índice do appcom.google.android.gms:play-services-appindex:16.1.0 |
Smartphone, tablet, Android TV |
ID do conjunto de apps Androidcom.google.android.gms:play-services-appset:16.0.2 |
Smartphone, tablet, Android TV, ChromeOS |
Login do Google para Androidcom.google.android.gms:play-services-auth:20.7.0 |
Smartphone, Tablet, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.0.1 |
Smartphone, tablet, 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 utilitárioscom.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.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
Framework de aplicativo Google Cast (CAF)com.google.android.gms:play-services-cast-framework:21.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
Receptores do Android TVcom.google.android.gms:play-services-cast-tv:21.0.0 |
Android TV |
Leitor de código do Googlecom.google.android.gms:play-services-code-scanner:16.1.0 |
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)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
Smartphone, tablet, Android Go |
Autenticação Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:20.1.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Compatível com dispositivos com Android 7.0 (nível 24 da API) ou mais recente. |
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:19.0.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
SDK nativo C dos serviços relacionados a jogos do Google Play v2 para Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Smartphone, tablet, Android TV, Android Go, 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, 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, ChromeOS Compatível com dispositivos com o Android 5.0 (nível 21 da API) ou mais recente. |
Provedor de localização combinada para Android (inclui 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.3.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 |
Rotulação de imagens do Kit de MLcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Smartphone, tablet, Android Go, ChromeOS |
Rotulação de imagens personalizada 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 linguagem 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:19.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de ML para chinêscom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de ML para devanágaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de ML para japonêscom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de ML para coreanocom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Descoberta e conexão de dispositivos por pertocom.google.android.gms:play-services-nearby:19.0.0 |
Smartphone, Tablet, Android TV, Auto, Android Go |
Mostrar licenças de código abertocom.google.android.gms:play-services-oss-licenses:17.0.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS Compatível com dispositivos com Android 5.0 (nível 21 da API) ou mais recente. |
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 (nível 19 da API) ao Android 9 (nível 28 da API). |
Google Pay for Passescom.google.android.gms:play-services-pay:16.3.0 |
Smartphone, tablet, Android Go e ChromeOS Compatível com dispositivos com o Android 5.0 (nível 20 da API) ou mais recente. |
reCAPTCHA Enterprise para instrumentação de appscom.google.android.gms:play-services-recaptcha:17.0.1 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
APIs SafetyNet (inclui atestados de dispositivos, Navegação segura, reCAPTCHA e verificação de apps)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.3 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Tasks no Androidcom.google.android.gms:play-services-tasks:18.0.2 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Serviço Acceleration para Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite GPU Delegate para o Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.2.0 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Java para Google Play Servicescom.google.android.gms:play-services-tflite-java:16.1.0 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Support para Google Play Servicescom.google.android.gms:play-services-tflite-support:16.1.0 |
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.2.1 |
Smartphone, Tablet, Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:18.1.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 compatíveis |
|---|---|
Mostrar licenças de código abertocom.google.android.gms:oss-licenses-plugin:0.10.6 |
Smartphone, tablet, ChromeOS |
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 |