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, disponíveis no repositório do Maven do Google.
Para testar o app ao usar o Google Play Services, use uma das seguintes opções:
- Um dispositivo Android compatível que execute o Android 6.0 (nível 23 da API) ou mais recente e tenha o app Google Play Store instalado.
- O emulador do Android com um AVD que executa a plataforma de APIs do Google com base no Android 6.0 (nível 23 da API) ou mais recente.
Declarar dependências para o Google Play Services
Para desenvolver recursos que dependem das APIs do Google Play Services no seu app, conclua as seguintes etapas:
Abra o arquivo
build.gradleno diretório do módulo do app.Inclua a dependência de cada SDK necessário para o app. Esta página inclui uma seção que lista as dependências comuns dos serviços do Google Play para apps Android. Você também pode 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.3.0'
}
Novas versões dos SDKs dos serviços do Google Play 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 usar 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 6.0 (nível 23 da API) e versões mais recentes pelo 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 no dispositivo antes de tentar usar as APIs do Google ou ative os 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 os serviços do Google Play ou saber como detectar se a versão instalada do Google Play Services oferece 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 dos Serviços do Google Play que podem ser incluídas no seu app Android. Para filtrar a lista por tipo de dispositivo, selecione um dos botões. Para pesquisar um caso de uso ou nome de dependência específico, digite o texto na caixa que aparece após os botões.
| Caso de uso e nome da dependência | Dispositivos compatíveis |
|---|---|
Anúncios do Google para dispositivos móveiscom.google.android.gms:play-services-ads:23.5.0 |
Smartphone, tablet |
ID de publicidade do Android (AAID)com.google.android.gms:play-services-ads-identifier:18.1.0 |
Smartphone, tablet, Android TV, ChromeOS |
Versão leve dos anúncios para dispositivos móveis do Googlecom.google.android.gms:play-services-ads-lite:23.5.0 |
Smartphone, tablet |
Anúncios personalizados de pesquisa (CSA) do AdSense para pesquisas (AFS)com.google.android.gms:play-services-afs-native:19.1.0 |
Smartphone, tablet, ChromeOS |
SDK de serviços do Google Analytics para Androidcom.google.android.gms:play-services-analytics:18.1.1 |
Obsoleto. Use o Google Analytics para Firebase. |
Índice de appscom.google.android.gms:play-services-appindex:16.2.0 |
Smartphone, tablet, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Smartphone, tablet, Android TV |
ID do conjunto de apps Androidcom.google.android.gms:play-services-appset:16.1.0 |
Smartphone, tablet, Android TV, ChromeOS |
Login do Google para Androidcom.google.android.gms:play-services-auth:21.2.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.1.0 |
Smartphone, tablet, Android Go |
API Block Store (inclui armazenamento de credenciais do usuário)com.google.android.gms:play-services-auth-blockstore:16.4.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Google Awarenesscom.google.android.gms:play-services-awareness:19.1.0 |
Smartphone, tablet, Android Go, ChromeOS e Android Auto |
Classes utilitáriascom.google.android.gms:play-services-base:18.5.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Como testar fakes para classes utilitáriascom.google.android.gms:play-services-base-testing:16.1.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Mais classes de utilitárioscom.google.android.gms:play-services-basement:18.4.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:22.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Framework de aplicativo do Google Cast (CAF)com.google.android.gms:play-services-cast-framework:22.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Verificador 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.1.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Interações entre dispositivos (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
Smartphone, tablet, Android Go |
Autenticação Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.1.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS Compatível com dispositivos com o Android 7.0 (nível 24 da API) ou mais recente. |
API Google Fit para Android e API Recording em dispositivos móveis (para dados de condicionamento físico do usuário)com.google.android.gms:play-services-fitness:21.2.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:20.1.2 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
SDK C nativo do Google Play Games 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.2.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.1.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS Compatível com dispositivos que executam o Android 5.0 (nível 21 da API) ou versões mais recentes. |
Serviços de localização para Androidcom.google.android.gms:play-services-location:21.3.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
SDK do Google Maps para Androidcom.google.android.gms:play-services-maps:19.0.0 |
Smartphone, tablet, Android TV, Android 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.1 |
Smartphone, tablet, Android Go, ChromeOS |
Leitor de documentos do Kit de MLcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 |
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 imagens do Kit de MLcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Smartphone, tablet, Android Go, ChromeOS |
Rotulagem de imagens do Kit de ML personalizadacom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
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 |
Segmentação de sujeitos do Kit de MLcom.google.android.gms:play-services-mlkit-subject-segmentation: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.1 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de ML para o chinêscom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de ML para Devanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de ML para o japonêscom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
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.1 |
Smartphone, tablet, Android Go, ChromeOS |
Descoberta e conexão de dispositivos por pertocom.google.android.gms:play-services-nearby:19.3.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go |
Mostrar licenças de código abertocom.google.android.gms:play-services-oss-licenses:17.1.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS Compatível com dispositivos que executam o Android 5.0 (nível 21 da API) ou versões mais recentes. |
Bibliotecas de acesso programático (PAL)com.google.android.gms:play-services-pal:21.0.0 |
Smartphone, tablet, Android TV Compatível com dispositivos que executam o 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.1.0 |
Smartphone, tablet, Android Go, ChromeOS, Wear OS Compatível com dispositivos que executam o Android 4.4 (nível 19 da API) a Android 9 (nível 28 da API). |
Carteira do Google (antigo Google Pay para cartões)com.google.android.gms:play-services-pay:16.5.0 |
Smartphone, tablet, Android Go, ChromeOS Compatível com dispositivos que executam o Android 5.0 (nível 20 da API) ou versões mais recentes. |
reCAPTCHA Enterprise para instrumentação de appscom.google.android.gms:play-services-recaptcha:17.1.0 |
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.1.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS |
Gerenciador de tags do Googlecom.google.android.gms:play-services-tagmanager:18.1.1 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Tasks no Androidcom.google.android.gms:play-services-tasks:18.2.0 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |
Serviço de aceleração para Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01 |
Smartphone, tablet, Android Go, ChromeOS |
API Delegate de GPU do TensorFlow Lite para os Serviços do Google Playcom.google.android.gms:play-services-tflite-gpu:16.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Java para Google Play Servicescom.google.android.gms:play-services-tflite-java:16.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
API de suporte do TensorFlow Lite para os Serviços do Google Playcom.google.android.gms:play-services-tflite-support:16.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.2.1 |
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.4.0 |
Smartphone, tablet, Android Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:19.0.0 |
Smartphone, tablet, Wear OS |
Plug-ins do Gradle
Os Serviços do Google Play também incluem vários plug-ins do Gradle, conforme mostrado na tabela a seguir. Os botões que aparecem antes da tabela anterior não mudam as informações que aparecem nela.
| Caso de uso e nome do plug-in do 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 rígida de versãocom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Smartphone, tablet, Android TV, Android Auto, Android Go, ChromeOS, Wear OS |