Para desenvolver um app usando Google Play services APIs, siga as instruções desta página para configurar seu projeto com os SDKs relevantes, que estão disponíveis no repositório do Google Maven.
Para testar seu app ao usar o Google Play Services, você precisa usar um dos seguintes:
- 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 das APIs do Google com base no Android 6.0 (nível 23 da API) ou mais recente.
Declarar dependências do Google Play Services
Para desenvolver recursos que dependem das APIs do Google Play Services no seu app, siga estas etapas:
Abra o arquivo
build.gradleno diretório do módulo do seu app.Para cada SDK que seu app exige, 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. Você também pode adicionar o Firebase ao seu projeto.
Salve as mudanças 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 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 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 é atualizado automaticamente no Android 6.0 (nível 23 da API) e mais recente pelo app Google Play Store. No entanto, os dispositivos 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, sempre verifique se ele está instalado antes de tentar usar as APIs do Google ou ativar recursos que exigem isso.
Para verificar a presença do Google Play Services no dispositivo, use o
isGooglePlayServicesAvailable()
método.
Para iniciar uma conexão com o Google Play Services 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 do Google Play Services que podem ser incluídas no seu app Android. Você pode 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.
| 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:25.1.0 |
Smartphone, tablet |
ID de publicidade do Android (AAID)com.google.android.gms:play-services-ads-identifier:18.3.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:24.8.0 |
Smartphone, tablet |
Anúncios personalizados de pesquisa do AdSense para pesquisa (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 |
Descontinuado. 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.5.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.3.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:20.0.0 |
Smartphone, tablet, Auto, Android Go, ChromeOS |
Classes de utilitárioscom.google.android.gms:play-services-base:18.10.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testar falsificações para classes de utilitárioscom.google.android.gms:play-services-base-testing:16.2.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Mais classes de utilitárioscom.google.android.gms:play-services-basement:18.10.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Melhoria de luz baixa da câmeracom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07 |
Smartphone, tablet |
Google Castcom.google.android.gms:play-services-cast:22.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
Estrutura de aplicativos do Google Cast (CAF)com.google.android.gms:play-services-cast-framework:22.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
Google Code Scannercom.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.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Interações de dispositivo para dispositivo (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
Smartphone, tablet, Android Go |
SDK do Verificador de Chavescom.google.android.gms:contactkeys:16.0.0 |
Smartphone, tablet |
Autenticação Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.2.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Com suporte em dispositivos que executam 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.3.0 |
Smartphone, tablet, Android Go, ChromeOS, Wear OS |
Serviços do Google Play Games v2 para Androidcom.google.android.gms:play-services-games-v2:21.0.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
SDK nativo do serviços do Google Play Games v2 C para Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
serviços do Google Play Games v1 para Androidcom.google.android.gms:play-services-games:24.0.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.2.0 |
Descontinuado. Consulte o Google Play Instant para mais informações. |
Serviços de localização para Androidcom.google.android.gms:play-services-location:21.3.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK do Maps para Androidcom.google.android.gms:play-services-maps:20.0.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK do Google Maps 3D para Androidcom.google.android.gms:play-services-maps3d:0.2.0 |
Smartphone, tablet |
Melhoria do efeito de mídiacom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta02 |
Smartphone, tablet |
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 |
Scanner de documentos do kit de MLcom.google.android.gms:play-services-mlkit-document-scanner:16.0.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 imagens do kit de MLcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Smartphone, tablet, Android Go, ChromeOS |
Rotulagem de imagens personalizada do kit de MLcom.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 assunto 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 ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
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.1 |
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.1 |
Smartphone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do ML Kit para 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, Auto, Android Go |
Mostrar licenças de código abertocom.google.android.gms:play-services-oss-licenses:17.4.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS Com suporte em dispositivos que executam o Android 5.0 (nível 21 da API) ou mais recente. |
Bibliotecas de acesso programático (PAL)com.google.android.gms:play-services-pal:23.0.0 |
Smartphone, tablet, Android TV Com suporte em 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 Com suporte em dispositivos que executam o Android 4.4 (nível 19 da API) ao Android 9 (nível 28 da API). |
Carteira do Google (antiga Google Pay para passes)com.google.android.gms:play-services-pay:16.5.0 |
Smartphone, tablet, Android Go, ChromeOS Com suporte em dispositivos que executam 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.1.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
APIs SafetyNet (inclui navegação segura e verificação de apps)com.google.android.gms:play-services-safetynet:18.1.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS |
Gerenciador de tags do Googlecom.google.android.gms:play-services-tagmanager:18.3.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Tasks no Androidcom.google.android.gms:play-services-tasks:18.4.1 |
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.4.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.4.0 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Java para o Google Play Servicescom.google.android.gms:play-services-tflite-java:16.4.0 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Support para o Google Play Servicescom.google.android.gms:play-services-tflite-support:16.4.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Smartphone, tablet |
API Trusted Timecom.google.android.gms:play-services-time:16.0.1 |
Smartphone, tablet, Auto, Android Go, Wear OS |
Mobile Visioncom.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.5.0 |
Smartphone, tablet, 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
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 mudam as informações que aparecem nesta tabela.
| 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.11.0 |
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 |