Para desenvolver um app usando as APIs do Google Play Services, siga as instruções desta página e configure seu projeto com os SDKs relevantes, 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ão 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 4.4 (API de nível 19) ou versões mais recentes.
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 do módulo do seu app.Para cada SDK exigido pelo app, inclua a dependência desse SDK. 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 a seguir mostra um exemplo de arquivo build.gradle que usa a biblioteca de locais:
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 de lançamento. Se o app usa uma dependência que foi atualizada, mude para a versão mais recente nas dependências do app para aproveitar essas correções.
Verificar se o Google Play Services está instalado
Conforme descrito na Visão geral do Google Play Services, o Google Play Services recebe atualizações automáticas no Android 4.4 (API de nível 19) e versões mais recentes por meio do app Google Play Store. No entanto, os 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, verifique se ele está instalado antes de tentar usar as APIs do Google ou ative os recursos 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 saber como detectar se a versão do Google Play Services instalada é compatível com uma API específica, leia o guia sobre 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 seu 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 inserindo texto na caixa que aparece após os botões.
| Nome do caso de uso e da dependência | Dispositivos com suporte |
|---|---|
Anúncios para dispositivos móveis do Googlecom.google.android.gms:play-services-ads:22.1.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 ChromeOS |
Versão leve dos anúncios para dispositivos móveis do Googlecom.google.android.gms:play-services-ads-lite:22.1.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.2 |
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 e ChromeOS |
Login do Google para Androidcom.google.android.gms:play-services-auth:20.5.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, Android 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.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
CAF (framework de aplicativo do Google Cast)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.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Pilha de rede 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, Android Go |
Autenticação on-line do Fast IDentity (FIDO)com.google.android.gms:play-services-fido:20.0.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Compatível com dispositivos que executam o 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, ChromeOS |
SDK nativo 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 e ChromeOS Compatível com dispositivos que executam o Android 5.0 (API de nível 21) ou versões mais recentes. |
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 do código de barras do kit de MLcom.google.android.gms:play-services-mlkit-barcode-scanning:18.2.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 |
Rótulo personalizado de 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 do 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 por Kit de MLcom.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto em 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 em Kit de ML para Devanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto em 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 em Kit de ML para coreanocom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Conexão e descoberta de dispositivos por pertocom.google.android.gms:play-services-nearby:18.5.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, Android Auto, Android Go e ChromeOS Compatível com dispositivos que executam 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, Wear OS Compatível com dispositivos que executam o 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.1.0 |
Smartphone, tablet, Android Go, ChromeOS Compatível com dispositivos que executam 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, 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, 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 de aceleração para Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
Smartphone, tablet, Android Go, ChromeOS |
API Delegate da GPU do TensorFlow Lite 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 geral 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.0-beta01 |
Smartphone, tablet, Android Auto, Android Go, Chrome OS, 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. Observe que 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 Gradle | Dispositivos com suporte |
|---|---|
Mostrar licenças de código abertocom.google.android.gms:oss-licenses-plugin:0.10.6 |
Smartphone, tablet, ChromeOS |
Verificação de versão estritacom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |