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 aplicativo usando o Google Play Services, você deve usar uma das seguintes opções:
- Um dispositivo Android compatível com o Android 7.0 (nível 24 da API) ou mais recente e com o app Google Play Store instalado.
- O Android Emulator com um AVD que executa a plataforma de APIs do Google com base no Android 7.0 (nível da API 24) 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, siga estas etapas:
Abra o arquivo
build.gradledentro do diretório do módulo do seu aplicativo.Para cada SDK que seu aplicativo requer, inclua a dependência correspondente. Esta página inclui uma seção que lista as dependências do Google Play Services comuns para apps Android. Você também pode querer 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.4.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 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.
Verifique se o Google Play Services está instalado.
Como descrito na Visão geral do Google Play Services, o Google Play Services é atualizado automaticamente no Android 7.0 (nível 24 da API) e versões mais recentes pelo app Google Play Store. No entanto, 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 o serviço.
Para verificar a presença do Google Play Services no dispositivo, use o método
isGooglePlayServicesAvailable().
Para então iniciar uma conexão com o Google Play Services ou aprender como detectar se a versão do Google Play Services instalada oferece suporte a uma API específica, leia o guia sobre Acessando 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 pode pesquisar um caso de uso específico ou o nome de uma dependência 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:25.4.0 |
Smartphone, tablet |
ID de publicidade do Android (AAID)com.google.android.gms:play-services-ads-identifier:18.3.0 |
Telefone, tablet, Android TV, ChromeOS |
Versão leve do Google Mobile Adscom.google.android.gms:play-services-ads-lite:25.0.0 |
Telefone, Tablet |
Anúncios personalizados de pesquisa (CSA) do AdSense para pesquisas (AFS)com.google.android.gms:play-services-afs-native:19.1.0 |
Telefone, 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 |
Telefone, tablet, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Telefone, tablet, Android TV |
ID do conjunto de apps Androidcom.google.android.gms:play-services-appset:16.1.0 |
Telefone, tablet, Android TV, ChromeOS |
Login do Google para Androidcom.google.android.gms:play-services-auth:22.0.0 |
Telefone, tablet, Android TV, carro, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.3.1 |
Telefone, 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áriocom.google.android.gms:play-services-base:18.10.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testando falsos para classes utilitáriascom.google.android.gms:play-services-base-testing:16.2.0 |
Telefone, tablet, Android TV, carro, Android Go, ChromeOS, Wear OS |
Mais classes de utilitárioscom.google.android.gms:play-services-basement:18.11.0 |
Telefone, tablet, Android TV, carro, Android Go, ChromeOS, Wear OS |
Melhoria da câmera em pouca luzcom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09 |
Telefone, Tablet |
Google Castcom.google.android.gms:play-services-cast:22.3.1 |
Telefone, tablet, Android Go, ChromeOS |
Framework de aplicativos Google Cast (CAF)com.google.android.gms:play-services-cast-framework:22.3.1 |
Telefone, tablet, Android Go, ChromeOS |
Leitor de código do Googlecom.google.android.gms:play-services-code-scanner:16.1.0 |
Telefone, tablet, Android Go, ChromeOS |
Pilha de rede Chromium (Cronet)com.google.android.gms:play-services-cronet:18.1.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-beta02 |
Smartphone, tablet, Android Go |
SDK Verificador de Chavescom.google.android.gms:contactkeys:16.0.0 |
Telefone, Tablet |
Autenticação FIDO (Fast IDentity Online)com.google.android.gms:play-services-fido:21.3.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Compatível com dispositivos que executam o Android 7.0 (nível da API 24) ou versões mais recentes. |
API Google Fit para Android e API de gravação 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 |
Proteção contra Fraudecom.google.android.gms:play-services-fraudprotect:16.0.1 |
Telefone, tablet, Android Go |
Serviços do Google Play Games v2 para Androidcom.google.android.gms:play-services-games-v2:22.1.0 |
Telefone, tablet, Android TV, Android Go, ChromeOS |
SDK nativo C dos Serviços 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 do Google Play Games v1 para Androidcom.google.android.gms:play-services-games:25.0.0 |
Obsoleto. Use os Serviços do Google Play Games v2. |
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 |
Obsoleto. Consulte Google Play Instant para obter mais informações. |
Serviços de localização para Androidcom.google.android.gms:play-services-location:21.4.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 |
Telefone, tablet, Android TV, carro, Android Go, ChromeOS, Wear OS |
SDK do Google Maps 3D para Androidcom.google.android.gms:play-services-maps3d:0.2.2 |
Smartphone, tablet |
Melhoria do efeito de mídiacom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08 |
Telefone, Tablet |
Leitura de código de barras do kit MLcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Telefone, 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 |
Kit de ML de detecção facial com.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Smartphone, tablet, Android Go, ChromeOS |
Kit de ML para rotulagem de imagenscom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefone, tablet, Android Go, ChromeOS |
Personalização da rotulagem de imagens 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 |
Telefone, tablet, Android Go, ChromeOS |
Resposta inteligente do Kit de MLcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefone, tablet, Android Go, ChromeOS |
Segmentação de assunto do Kit de ML com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Telefone, tablet, Android Go, ChromeOS |
Reconhecimento de texto do Kit de MLcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
Telefone, 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 |
Telefone, tablet, Android Go, ChromeOS |
Kit de reconhecimento de texto ML para Devanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
Smartphone, tablet, Android Go, ChromeOS |
Kit de reconhecimento de texto Kit de ML para japonêscom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
Telefone, 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 |
Telefone, tablet, Android Go, ChromeOS |
Detecção e conexão de dispositivos próximoscom.google.android.gms:play-services-nearby:19.5.0 |
Telefone, tablet, Android TV, carro, Android Go |
Mostrar licenças de código abertocom.google.android.gms:play-services-oss-licenses:17.5.2 |
Telefone, tablet, Android TV, carro, Android Go, ChromeOS Compatível com dispositivos que executam Android 5.0 (nível da API 21) ou superior. |
Bibliotecas de Acesso Programático (PAL)com.google.android.gms:play-services-pal:23.0.0 |
Telefone, tablet, Android TV Compatível com dispositivos que executam Android 5.0 (nível da API 21) ou superior. |
Verificação de qualidade do bloqueio de tela com.google.android.gms:play-services-password-complexity:18.1.0 |
Telefone, tablet, Android Go, ChromeOS, Wear OS Compatível com dispositivos que executam Android 4.4 (nível da API 19) até Android 9 (nível da API 28). |
Carteira do Google (antigo Google Pay para cartões)com.google.android.gms:play-services-pay:16.5.0 |
Telefone, tablet, Android Go, ChromeOS Compatível com dispositivos que executam Android 5.0 (nível da API 20) ou superior. |
reCAPTCHA Enterprise para instrumentação de aplicativoscom.google.android.gms:play-services-recaptcha:17.1.0 |
Telefone, tablet, Android TV, Android Go, ChromeOS |
API de gestos remotoscom.google.android.gms:play-services-remotegestures:16.0.0 |
Telefone, Tablet |
Navegação Segura v5com.google.android.gms:play-services-safebrowsing:16.0.0 |
Telefone, tablet, Android TV, carro, Android Go, ChromeOS |
APIs do SafetyNet (inclui navegação segura e aplicativos de verificação)com.google.android.gms:play-services-safetynet:18.1.0 |
Telefone, tablet, Android TV, carro, Android Go, ChromeOS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.3.0 |
Telefone, tablet, Android TV, Android Go, ChromeOS |
API Tasks no Androidcom.google.android.gms:play-services-tasks:18.4.1 |
Telefone, 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.5.0-beta02 |
Telefone, tablet, Android Go, ChromeOS |
API de delegado de GPU do TensorFlow Lite para o Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.5.0 |
Telefone, tablet, Android Go, ChromeOS |
API Java do TensorFlow Lite para o Google Play Servicescom.google.android.gms:play-services-tflite-java:16.5.0 |
Telefone, tablet, Android Go, ChromeOS |
API de suporte do TensorFlow Lite para o Google Play Servicescom.google.android.gms:play-services-tflite-support:16.5.0 |
Telefone, tablet, Android Go, ChromeOS |
API de Rede Thread com.google.android.gms:play-services-threadnetwork:16.3.0 |
Telefone, Tablet |
API de Tempo Confiávelcom.google.android.gms:play-services-time:16.0.1 |
Telefone, tablet, carro, Android Go, Wear OS |
Visão Móvelcom.google.android.gms:play-services-vision:20.1.3 |
Telefone, tablet, Android Go, ChromeOS |
Google Pay para pagamentos no Androidcom.google.android.gms:play-services-wallet:20.0.0 |
Telefone, tablet, carro, Android Go, ChromeOS, Wear OS |
API da Camada de Dados Vestíveiscom.google.android.gms:play-services-wearable:20.0.1 |
Telefone, tablet, Wear OS |
Plugins 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 nesta tabela.
| Caso de uso e nome do plugin Gradle | Dispositivos compatíveis |
|---|---|
Mostrar licenças de código abertocom.google.android.gms:oss-licenses-plugin:0.13.0 |
Telefone, 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 |