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 pertinents, disponibles dans le dépôt Maven de Google.
Pour tester votre application lorsque vous utilisez les services Google Play, vous devez utiliser l'une des méthodes suivantes:
- Un appareil Android compatible exécutant Android 4.4 (niveau d'API 19) 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 4.4 (niveau d'API 19) 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 de services Google Play dans votre application, procédez comme suit:
Ouvrez le fichier
build.gradle
dans le répertoire du module de votre application.Pour chaque SDK requis par votre application, incluez la dépendance pour ce SDK. Cette page inclut une section répertoriant les dépendances courantes des services Google Play pour les applications Android. Vous pouvez également ajouter des dépendances Firebase à votre projet.
Enregistrez les modifications et synchronisez votre projet.
L'extrait suivant présente un exemple de fichier build.gradle
qui utilise la bibliothèque d'emplacements:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.0.1'
}
De nouvelles versions des SDK des services Google Play comportant des corrections de bugs et de nouvelles fonctionnalités sont régulièrement publiées. 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 bénéficier 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 4.4 (niveau d'API 19) ou version ultérieure via l'application Google Play Store. Toutefois, les services Google Play ne sont pas installés sur les appareils Android sans Google Play Store. Si votre application s'exécute sur des appareils n'utilisant pas les services Google Play, vous pouvez vérifier si les services Google Play sont installés sur l'appareil avant d'essayer d'utiliser des API Google ou d'activer des fonctionnalités de votre application qui nécessitent des services Google Play.
Pour vérifier la présence de services Google Play sur l'appareil, utilisez la méthode isGooglePlayServicesAvailable()
.
Pour établir une connexion aux services Google Play ou pour déterminer si la version de ces services 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 pour les 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 le champ qui apparaît après les boutons.
Cas d'utilisation et nom de la dépendance | Appareils compatibles |
---|---|
Annonces pour mobile Googlecom.google.android.gms:play-services-ads:21.5.0 |
Téléphone, tablette |
Identifiant publicitaire Android (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 |
Téléphone, tablette, Android TV, Chrome OS |
Version simplifiée des annonces Google pour mobilecom.google.android.gms:play-services-ads-lite:21.5.0 |
Téléphone, tablette |
Annonces AdSense pour les recherches personnalisées (AdSense pour les recherches)com.google.android.gms:play-services-afs-native:19.0.3 |
Téléphone, tablette, Chrome OS |
SDK Services Google Analytics pour Androidcom.google.android.gms:play-services-analytics:18.0.2 |
Obsolète. Utilisez Google Analytics pour Firebase à la place. |
Index des applicationscom.google.android.gms:play-services-appindex:16.1.0 |
Téléphone, tablette, Android TV |
ID de l'ensemble d'applications Androidcom.google.android.gms:play-services-appset:16.0.2 |
Téléphone, tablette, Android TV, Chrome OS |
Google Sign-In pour Androidcom.google.android.gms:play-services-auth:20.4.1 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.0.1 |
Téléphone, tablette, Android Go |
API Block Store (inclut le stockage des identifiants utilisateur)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
Téléphone, tablette, Android Go, Chrome OS |
API Google Awarenesscom.google.android.gms:play-services-awareness:19.0.1 |
Téléphone, tablette, auto, Android Go, Chrome OS |
Classes utilitairescom.google.android.gms:play-services-base:18.2.0 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |
Tester les contrefaçons pour les classes de services collectifscom.google.android.gms:play-services-base-testing:16.0.0 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |
Plus de classes d'utilitairescom.google.android.gms:play-services-basement:18.2.0 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.2.0 |
Téléphone, tablette, Android Go, Chrome OS |
Framework d'application Google Cast (CAF)com.google.android.gms:play-services-cast-framework:21.2.0 |
Téléphone, tablette, Android Go, Chrome OS |
Récepteurs Android TVcom.google.android.gms:play-services-cast-tv:20.0.0 |
Android TV |
Google Code Scannercom.google.android.gms:play-services-code-scanner:16.0.0-beta3 |
Téléphone, tablette, Android Go, Chrome OS |
Pile réseau Chromium (Cronet)com.google.android.gms:play-services-cronet:18.0.1 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |
Interactions entre appareils (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
Téléphone, tablette, Android Go |
Authentification rapide FIDO (IDentity Online)com.google.android.gms:play-services-fido:19.0.1 |
Téléphone, tablette, Android TV, auto, Android Go, Chrome OS, Wear OS Compatible avec les appareils équipés d'Android 7.0 (niveau d'API 24) ou version ultérieure |
API Google Fit pour Androidcom.google.android.gms:play-services-fitness:21.1.0 |
Téléphone, tablette, Android Go, Chrome OS, Wear OS |
Services Google Play Jeux v2 pour Androidcom.google.android.gms:play-services-games-v2:17.0.0 |
Téléphone, tablette, Android TV, Android Go, Chrome OS |
SDK Google Play Jeux v2 Native C pour Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Téléphone, tablette, Android TV, Android Go, Chrome OS |
Services Google Play Jeux v1 pour Androidcom.google.android.gms:play-services-games:23.1.0 |
Téléphone, tablette, Android TV, Android Go, Chrome OS |
API Mattercom.google.android.gms:play-services-home:16.0.0 |
Téléphone, tablette |
Applis instantanées Google Playcom.google.android.gms:play-services-instantapps:18.0.1 |
Téléphone, tablette, Android TV, Android Go, Chrome OS Compatible avec les appareils équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure |
Fused Location Provider for Android (inclut la reconnaissance d'activité et le géorepérage)com.google.android.gms:play-services-location:21.0.1
| Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |
SDK Google Maps pour Androidcom.google.android.gms:play-services-maps:18.1.0 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |
Lecture du code-barres du ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0 |
Téléphone, tablette, Android Go, Chrome OS |
Détection des visages dans ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Téléphone, tablette, Android Go, Chrome OS |
Ajout d'étiquettes aux images dans ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Téléphone, tablette, Android Go, Chrome OS |
Étiquette d'image personnalisée ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4 |
Téléphone, tablette, Android Go, Chrome OS |
Identification du langage du kit MLcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Téléphone, tablette, Android Go, Chrome OS |
Réponse suggérée de ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Téléphone, tablette, Android Go, Chrome OS |
Reconnaissance de texte dans ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:18.0.2 |
Téléphone, tablette, Android Go, Chrome OS |
Détection et connexion des appareils à proximitécom.google.android.gms:play-services-nearby:18.4.0 |
Téléphone, tablette, Android TV, Android Auto, Android Go |
Afficher les licences Open Sourcecom.google.android.gms:play-services-oss-licenses:17.0.0 |
Téléphone, tablette, Android TV, Auto, Android Go, Chrome OS Compatible avec les appareils équipés d'Android 5.0 (niveau d'API 21) ou version ultérieure |
Contrôle qualité de l'écran com.google.android.gms:play-services-password-complexity:18.0.1 |
Téléphone, tablette, Android Go, ChromeOS, Wear OS Compatible avec les appareils équipés d'Android 4.4 (niveau d'API 19) à Android 9 (niveau d'API 28) |
Google Pay for Passescom.google.android.gms:play-services-pay:16.1.0 |
Téléphone, tablette, Android Go, Chrome OS Compatible avec les appareils équipés d'Android 5.0 (niveau d'API 20) ou version ultérieure |
reCAPTCHA Enterprise pour l'instrumentation d'applicationscom.google.android.gms:play-services-recaptcha:17.0.1 |
Téléphone, tablette, Android TV, Android Go, Chrome OS |
API SafetyNet (inclut l'attestation de l'appareil, la navigation sécurisée, reCAPTCHA et la validation des applications)com.google.android.gms:play-services-safetynet:18.0.1 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.0.2 |
Téléphone, tablette, Android TV, Android Go, Chrome OS |
API Tasks sur Androidcom.google.android.gms:play-services-tasks:18.0.2 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |
API Tensorflow GPU Delegate pour les services Google Playcom.google.android.gms:play-services-tflite-gpu:16.1.0 |
Téléphone, tablette, Android Go, Chrome OS |
API Java TensorFlow Lite pour les services Google Playcom.google.android.gms:play-services-tflite-java:16.0.1 |
Téléphone, tablette, Android Go, Chrome OS |
API d'assistance TensorFlow Lite pour les services Google Playcom.google.android.gms:play-services-tflite-support:16.0.1 |
Téléphone, tablette, Android Go, Chrome OS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.0.0 |
Téléphone, tablette |
Vision mobilecom.google.android.gms:play-services-vision:20.1.3 |
Téléphone, tablette, Android Go, Chrome OS |
Google Pay pour les paiements sur Androidcom.google.android.gms:play-services-wallet:19.1.0 |
Téléphone, tablette, auto, Android Go, Chrome OS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:18.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 apparaissent avant le tableau précédent ne modifient pas les informations affichées dans ce tableau.
Cas d'utilisation et nom du plug-in Gradle | Appareils compatibles |
---|---|
Afficher les licences Open Sourcecom.google.android.gms:oss-licenses-plugin:0.10.6 |
Téléphone, tablette, Chrome OS |
Vérification stricte des versionscom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Téléphone, tablette, Android TV, Android Auto, Android Go, Chrome OS, Wear OS |