Configurer les services Google Play

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

Pour tester votre application lorsque vous utilisez les services Google Play, vous devez utiliser l'un des éléments suivants :

• Un appareil Android compatible exécutant Android 6.0 (niveau d'API 23) ou une version ultérieure et sur lequel l'application Google Play Store est installée.
• L'émulateur Android avec un AVD exécutant la plate-forme des API Google basée sur Android 6.0 (niveau d'API 23) ou une 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.

   Remarque : Les projets Android Studio contiennent un fichier build.gradle de premier niveau et un fichier build.gradle pour chaque module. Veillez à modifier le fichier du module de votre application. En savoir plus sur la création de votre projet avec Gradle.

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

3. Enregistrez les modifications et synchronisez votre projet.

L'extrait 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 corrections.

**Remarque** : Pour conserver les classes requises, les SDK des services Google Play incluent chacun des directives qui indiquent à R8 comment optimiser votre application.

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 sont automatiquement mis à jour sur Android 6.0 (niveau d'API 23) et versions ultérieures via l'application Google Play Store. Toutefois, les appareils sans Google Play Store n'ont pas les services Google Play installés. Si votre application s'exécute sur des appareils sans les services Google Play, vous devez toujours vérifier si les services Google Play sont installés avant d'essayer d'utiliser les API Google ou d'activer des fonctionnalités qui les nécessitent.

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

Pour commencer une connexion aux services Google Play ou découvrir comment détecter 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 répertorie 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. Vous pouvez également 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.

Téléphones et tablettes Android TV Auto Android Go ChromeOS Wear OS

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:25.1.0	Téléphone, tablette
Identifiant publicitaire Android (AAID) com.google.android.gms:play-services-ads-identifier:18.3.0	Téléphone, tablette, Android TV, ChromeOS
Version légère de Google Mobile Ads com.google.android.gms:play-services-ads-lite:24.8.0	Téléphone, tablette
Annonces personnalisées AdSense pour la recherche (AFS) 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.
Indexation 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 d'ensemble d'applications Android com.google.android.gms:play-services-appset:16.1.0	Téléphone, tablette, Android TV, ChromeOS
Connexion Google pour Android com.google.android.gms:play-services-auth:21.5.1	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever com.google.android.gms:play-services-auth-api-phone:18.3.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:20.0.0	Téléphone, tablette, Auto, Android Go, ChromeOS
Classes utilitaires com.google.android.gms:play-services-base:18.10.0	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Faux tests pour les classes utilitaires com.google.android.gms:play-services-base-testing:16.2.0	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Autres classes utilitaires com.google.android.gms:play-services-basement:18.10.0	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Amélioration de la faible luminosité de l'appareil photo com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07	Téléphone, tablette
Google Cast com.google.android.gms:play-services-cast:22.3.0	Téléphone, tablette, Android Go, ChromeOS
Framework d'application Google Cast (CAF) com.google.android.gms:play-services-cast-framework:22.3.0	Téléphone, tablette, Android Go, ChromeOS
Google Code Scanner 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.1	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interactions entre appareils (DTDI) com.google.android.gms:play-services-dtdi:16.0.0-beta02	Téléphone, tablette, Android Go
SDK Key Verifier com.google.android.gms:contactkeys:16.0.0	Téléphone, tablette
Authentification Fast IDentity Online (FIDO) com.google.android.gms:play-services-fido:21.2.0	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS Compatible avec les appareils exécutant Android 7.0 (niveau d'API 24) ou une version ultérieure.
API Google Fit pour Android et API d'enregistrement sur mobile (pour les données de remise en forme de l'utilisateur) com.google.android.gms:play-services-fitness:21.3.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:21.0.0	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:24.0.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.2.0	Obsolète. Pour en savoir plus, consultez Google Play Instant.
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:20.0.0	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK Google Maps 3D pour Android com.google.android.gms:play-services-maps3d:0.2.0	Téléphone, tablette
Amélioration des effets multimédias com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta02	Téléphone, tablette
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	Téléphone, tablette, Android Go, ChromeOS
Détection des visages ML Kit com.google.android.gms:play-services-mlkit-face-detection:17.1.0	Téléphone, tablette, Android Go, ChromeOS
Libellisation d'images ML Kit com.google.android.gms:play-services-mlkit-image-labeling:16.0.8	Téléphone, tablette, Android Go, ChromeOS
Libellisation d'images personnalisée ML Kit 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 ML Kit com.google.android.gms:play-services-mlkit-language-id:17.0.0	Téléphone, tablette, Android Go, ChromeOS
Réponse suggérée 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 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étection et connexion d'appareils à proximité com.google.android.gms:play-services-nearby:19.3.0	Téléphone, tablette, Android TV, Auto, Android Go
Afficher les licences Open Source com.google.android.gms:play-services-oss-licenses:17.4.0	Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS Compatible avec les appareils exécutant Android 5.0 (niveau d'API 21) ou une version ultérieure.
Bibliothèques d'accès programmatique (PAL) com.google.android.gms:play-services-pal:23.0.0	Téléphone, tablette, Android TV Compatible avec les appareils exécutant Android 5.0 (niveau d'API 21) ou une version ultérieure.
Vérification de la 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 exécutant Android 5.0 (niveau d'API 20) ou une version ultérieure.
reCAPTCHA Enterprise pour l'instrumentation des applications com.google.android.gms:play-services-recaptcha:17.1.0	Téléphone, tablette, Android TV, Android Go, ChromeOS
API SafetyNet (inclut la navigation sécurisée et la vérification 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.3.0	Téléphone, tablette, Android TV, Android Go, ChromeOS
API Tasks sur Android com.google.android.gms:play-services-tasks:18.4.1	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.4.0-beta01	Téléphone, tablette, Android Go, ChromeOS
API déléguée GPU TensorFlow Lite pour les services Google Play com.google.android.gms:play-services-tflite-gpu:16.4.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.4.0	Téléphone, tablette, Android Go, ChromeOS
API d'assistance TensorFlow Lite pour les services Google Play com.google.android.gms:play-services-tflite-support:16.4.0	Téléphone, tablette, Android Go, ChromeOS
API Thread Network com.google.android.gms:play-services-threadnetwork:16.3.0	Téléphone, tablette
API Trusted Time com.google.android.gms:play-services-time:16.0.1	Téléphone, tablette, Auto, Android Go, Wear OS
Vision mobile 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.5.0	Téléphone, tablette, Auto, Android Go, ChromeOS, Wear OS
API Wearable Data Layer com.google.android.gms:play-services-wearable:19.0.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 s'affichent avant le tableau précédent ne modifient pas les informations qui apparaissent dans ce tableau.

Tableau 2. Liste des plug-ins Gradle inclus dans les services Google Play services

Cas d'utilisation et nom du plug-in Gradle	Appareils compatibles
Afficher les licences Open Source com.google.android.gms:oss-licenses-plugin:0.11.0	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