Configurer les services Google Play

Pour développer une application à l'aide des API des services Google Play, suivez les instructions de cette page pour configurer votre projet avec les SDK appropriés, disponibles dans le dépôt Maven Google.

Pour tester votre application lors de l'utilisation des services Google Play, vous devez utiliser l'une des options suivantes:

  • Un appareil Android compatible équipé d'Android 6.0 (niveau d'API 23) ou version ultérieure et sur lequel l'application Google Play Store est installée.
  • L'émulateur Android avec un AVD qui exécute la plate-forme des API Google basée sur Android 6.0 (niveau d'API 23) ou version ultérieure.

Déclarer des dépendances pour les services Google Play

Pour développer des fonctionnalités qui dépendent des API des services Google Play dans votre application, procédez comme suit:

  1. Ouvrez le fichier build.gradle dans le répertoire du module de votre application.

  2. Pour chaque SDK requis par votre application, incluez la dépendance correspondante. Cette page inclut une section qui liste les dépendances courantes des services Google Play pour les applications Android. Vous pouvez également ajouter des dépendances Firebase à votre projet.

  3. Enregistrez les modifications et synchronisez votre projet.

L'extrait de code suivant montre un exemple de fichier build.gradle qui utilise la bibliothèque de localisation:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

De nouvelles versions des SDK des services Google Play avec des corrections de bugs et de nouvelles fonctionnalités sont publiées régulièrement. Ces mises à jour sont annoncées dans les notes de version. Si votre application utilise une dépendance qui a été mise à jour, passez à la dernière version dans les dépendances de votre application pour profiter de ces correctifs.

Vérifier si les services Google Play sont installés

Comme décrit dans la présentation des services Google Play, les services Google Play reçoivent des mises à jour automatiques sur Android 6.0 (niveau d'API 23) et versions ultérieures via l'application Google Play Store. Toutefois, les appareils Android sans Google Play Store ne disposent pas des services Google Play installés. Si votre application s'exécute sur des appareils sans services Google Play, vous pouvez vérifier si les services Google Play sont installés sur l'appareil avant d'essayer d'utiliser les API Google ou d'activer les fonctionnalités de votre application qui nécessitent les services Google Play pour fonctionner.

Pour vérifier la présence des services Google Play sur l'appareil, utilisez la méthode isGooglePlayServicesAvailable().

Pour commencer une connexion aux services Google Play ou découvrir comment déterminer si la version des services Google Play installée est compatible avec une API spécifique, consultez le guide Accéder aux API Google.

Dépendances des services Google Play

Le tableau suivant liste les dépendances des services Google Play que vous pouvez inclure dans votre application Android. Vous pouvez filtrer la liste par type d'appareil en sélectionnant l'un des boutons, et rechercher un cas d'utilisation ou un nom de dépendance spécifique en saisissant du texte dans la zone qui s'affiche après les boutons.

Tableau 1. Dépendances des services Google Play à inclure dans les applications Android
Cas d'utilisation et nom de la dépendance Appareils compatibles
Google Mobile Ads
com.google.android.gms:play-services-ads:23.5.0
Téléphone, tablette
Identifiant publicitaire Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
Téléphone, tablette, Android TV, ChromeOS
Version allégée des annonces Google pour mobile
com.google.android.gms:play-services-ads-lite:23.5.0
Téléphone, tablette
Annonces pour les recherches personnalisées AdSense pour les recherches
com.google.android.gms:play-services-afs-native:19.1.0
Téléphone, tablette, ChromeOS
SDK des services Google Analytics pour Android
com.google.android.gms:play-services-analytics:18.1.1
Obsolète. Utilisez plutôt Google Analytics pour Firebase.
Index des applications
com.google.android.gms:play-services-appindex:16.2.0
Téléphone, tablette, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
Téléphone, tablette, Android TV
ID de l'ensemble d'applications Android
com.google.android.gms:play-services-appset:16.1.0
Téléphone, tablette, Android TV, ChromeOS
Google Sign-In pour Android
com.google.android.gms:play-services-auth:21.2.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.1.0
Téléphone, tablette, Android Go
API Block Store (inclut le stockage des identifiants utilisateur)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Téléphone, tablette, Android Go, ChromeOS
API Google Awareness
com.google.android.gms:play-services-awareness:19.1.0
Téléphone, tablette, voiture, Android Go, ChromeOS
Classes utilitaires
com.google.android.gms:play-services-base:18.5.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Tester les faux pour les classes utilitaires
com.google.android.gms:play-services-base-testing:16.1.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Autres classes d'utilitaires
com.google.android.gms:play-services-basement:18.4.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:22.0.0
Téléphone, tablette, Android Go, ChromeOS
Framework d'application Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:22.0.0
Téléphone, tablette, Android Go, ChromeOS
Lecteur de code Google
com.google.android.gms:play-services-code-scanner:16.1.0
Téléphone, tablette, Android Go, ChromeOS
Pile réseau Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interactions d'appareil à appareil (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Téléphone, tablette, Android Go
Authentification rapide d'identité en ligne (FIDO)
com.google.android.gms:play-services-fido:21.1.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS

Compatible avec les appareils équipés d'Android 7.0 (niveau d'API 24) ou version ultérieure.
API Google Fit pour Android et API Recording sur mobile (pour les données de fitness de l'utilisateur)
com.google.android.gms:play-services-fitness:21.2.0
Téléphone, tablette, Android Go, ChromeOS, Wear OS
Services de jeux Google Play v2 pour Android
com.google.android.gms:play-services-games-v2:20.1.2
Téléphone, tablette, Android TV, Android Go, ChromeOS
SDK C natif des services de jeux Google Play v2 pour Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Téléphone, tablette, Android TV, Android Go, ChromeOS
Services de jeux Google Play v1 pour Android
com.google.android.gms:play-services-games:23.2.0
Téléphone, tablette, Android TV, Android Go, ChromeOS
API Matter
com.google.android.gms:play-services-home:16.0.0
Téléphone, tablette
Google Play Instant
com.google.android.gms:play-services-instantapps:18.1.0
Téléphone, tablette, Android TV, Android Go, ChromeOS

Compatible avec les appareils équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure.
Services de localisation pour Android
com.google.android.gms:play-services-location:21.3.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK Google Maps pour Android
com.google.android.gms:play-services-maps:19.0.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Lecture de codes-barres ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
Téléphone, tablette, Android Go, ChromeOS
Scanner de documents ML Kit
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
Téléphone, tablette, Android Go, ChromeOS
Détection de visages ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Téléphone, tablette, Android Go, ChromeOS
Libellé des images avec ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Téléphone, tablette, Android Go, ChromeOS
ML Kit : libellé d'image personnalisé
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Téléphone, tablette, Android Go, ChromeOS
Identification de la langue avec ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Téléphone, tablette, Android Go, ChromeOS
Réponses suggérées ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Téléphone, tablette, Android Go, ChromeOS
Segmentation des sujets ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Téléphone, tablette, Android Go, ChromeOS
Reconnaissance de texte ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
Téléphone, tablette, Android Go, ChromeOS
Reconnaissance de texte ML Kit pour le chinois
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
Téléphone, tablette, Android Go, ChromeOS
Reconnaissance de texte ML Kit pour le devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
Téléphone, tablette, Android Go, ChromeOS
Reconnaissance de texte ML Kit pour le japonais
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Téléphone, tablette, Android Go, ChromeOS
Reconnaissance de texte avec ML Kit pour le coréen
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
Téléphone, tablette, Android Go, ChromeOS
Découverte et connexion des appareils à proximité
com.google.android.gms:play-services-nearby:19.3.0
Téléphone, tablette, Android TV, voiture, Android Go
Afficher les licences Open Source
com.google.android.gms:play-services-oss-licenses:17.1.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS
Compatible avec les appareils équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure.
Bibliothèques d'accès programmatique (PAL)
com.google.android.gms:play-services-pal:21.0.0
Téléphone, tablette, Android TV
Compatible avec les appareils équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure.
Contrôle qualité du verrouillage de l'écran
com.google.android.gms:play-services-password-complexity:18.1.0
Téléphone, tablette, Android Go, ChromeOS, Wear OS

Compatible avec les appareils exécutant Android 4.4 (niveau d'API 19) à Android 9 (niveau d'API 28).
Google Wallet (anciennement Google Pay pour les cartes)
com.google.android.gms:play-services-pay:16.5.0
Téléphone, tablette, Android Go, ChromeOS

Compatible avec les appareils équipés d'Android 5.0 (niveau d'API 20) ou version ultérieure.
reCAPTCHA Enterprise pour l'instrumentation d'applications
com.google.android.gms:play-services-recaptcha:17.1.0
Téléphone, tablette, Android TV, Android Go, ChromeOS
API SafetyNet (inclut l'attestation d'appareil, la navigation sécurisée, reCAPTCHA et la validation des applications)
com.google.android.gms:play-services-safetynet:18.1.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.1.1
Téléphone, tablette, Android TV, Android Go, ChromeOS
API Tasks sur Android
com.google.android.gms:play-services-tasks:18.2.0
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Service d'accélération pour Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Téléphone, tablette, Android Go, ChromeOS
API TensorFlow Lite GPU Delegate pour les services Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.0
Téléphone, tablette, Android Go, ChromeOS
API Java TensorFlow Lite pour les services Google Play
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
Téléphone, tablette, Android Go, ChromeOS
API de compatibilité TensorFlow Lite pour les services Google Play
com.google.android.gms:play-services-tflite-support:16.1.0
Téléphone, tablette, Android Go, ChromeOS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.2.1
Téléphone, tablette
Mobile Vision
com.google.android.gms:play-services-vision:20.1.3
Téléphone, tablette, Android Go, ChromeOS
Google Pay pour les paiements sur Android
com.google.android.gms:play-services-wallet:19.4.0
Téléphone, tablette, voiture, Android Go, ChromeOS, Wear OS
API Wearable Data Layer
com.google.android.gms:play-services-wearable:18.2.0
Téléphone, tablette, Wear OS

Plug-ins Gradle

Les services Google Play incluent également plusieurs plug-ins Gradle, comme indiqué dans le tableau suivant. Notez que les boutons qui apparaissent avant le tableau précédent ne modifient pas les informations qui s'affichent dans ce tableau.

Tableau 2. Liste des plug-ins Gradle inclus dans les services Google Play
Cas d'utilisation et nom du plug-in Gradle Appareils compatibles
Afficher les licences Open Source
com.google.android.gms:oss-licenses-plugin:0.10.6
Téléphone, tablette, ChromeOS
Vérification stricte des versions
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS