Para desenvolver um app usando o Google Play Services APIs, siga as instruções nesta página para definir seu projeto com os SDKs relevantes, que estão disponíveis na Repositório Maven do Google.
Para testar seu aplicativo usando o Google Play Services, você deve usar um dos seguintes:
- Um dispositivo Android compatível que executa o Android 6.0 (API) nível 23) ou superior e com o app Google Play Store instalado.
- O Android Emulator com uma AVD que executa as APIs do Google. plataforma baseada 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 em seu aplicativo, siga estas etapas:
Abra o arquivo
build.gradledentro do diretório do módulo do app.Inclua a dependência de cada SDK que o app exige. A página inclui uma seção que lista os serviços comuns do Google Play Services dependências de apps Android. Você também pode adicionar dependências do Firebase à sua projeto.
Salve as alterações e sincronize o projeto.
O snippet a seguir mostra um exemplo de arquivo build.gradle que usa as
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 no lançamento . Caso seu aplicativo use uma dependência que foi atualizado, 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 mais recentes no app Google Play Store. No entanto, os dispositivos Android sem o Google Play A loja não tem o Google Play Services instalado. Se o app for executado em dispositivos sem o Google Play Services, confira se o Google Play serviços for instalado no dispositivo antes de você tentar usar as APIs do Google; ou ativar recursos no app que exigem o funcionamento do Google Play Services.
Para verificar a presença do Google Play Services no dispositivo, use o
isGooglePlayServicesAvailable()
.
Para, em seguida, iniciar uma conexão com o Google Play Services ou aprender a detectar se a versão do Google Play Services instalada 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 você pode incluir em seu app Android. Você pode filtrar a lista por tipo de dispositivo selecionando um dos botões, e é possível pesquisar uma dependência ou um caso de uso específico digitando o 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:23.3.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.3.0 |
Smartphone, tablet |
Anúncios personalizados de pesquisa (CSA, na sigla em inglês) 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.0 |
Obsoleto. Use o Google Analytics para Firebase. |
Índice do appcom.google.android.gms:play-services-appindex:16.2.0 |
Smartphone, tablet, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.0 |
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, 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, Auto, Android Go, ChromeOS |
Classes de utilitárioscom.google.android.gms:play-services-base:18.5.0 |
Smartphone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Como testar falsificações em classes de utilitárioscom.google.android.gms:play-services-base-testing:16.1.0 |
Smartphone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Mais classes de utilitárioscom.google.android.gms:play-services-basement:18.4.0 |
Smartphone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.5.0 |
Smartphone, tablet, Android Go, ChromeOS |
Framework de aplicativos do Google Cast (CAF, na sigla em inglês)com.google.android.gms:play-services-cast-framework:21.5.0 |
Smartphone, tablet, Android Go, ChromeOS |
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.1.0 |
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 rápida de entidade on-line (FIDO, na sigla em inglês)com.google.android.gms:play-services-fido:21.1.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Compatível com dispositivos que executam o Android 7.0 (nível 24 da API) ou versões mais recentes. |
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 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.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, 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, 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 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 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 em 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 kit de ML em 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 em 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.1.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS Compatível com dispositivos que executam o Android 5.0 (nível 21 da API) ou versões mais recentes. |
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) ao Android 9 (nível 28 da API). |
Carteira do Google (antigo Google Pay for Passes)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 atestados de dispositivos, Navegação segura, reCAPTCHA 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.1.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Tasks no Androidcom.google.android.gms:play-services-tasks:18.2.0 |
Smartphone, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Acceleration Service 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.2.0-beta02 |
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.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, Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:18.2.0 |
Smartphone, tablet, Wear OS |
Plug-ins do Gradle
O Google Play Services também inclui vários plug-ins do Gradle, como mostrado no tabela a seguir. Os botões que aparecem antes da tabela anterior não altere as informações que aparecem nessa 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.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 |