Pour développer une application à l'aide des API des services Google Play, suivez les instructions de cette page afin de configurer votre projet avec les SDK appropriés, disponibles dans le dépôt Maven 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 équipé d'Android 5.0 (niveau d'API 21) 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 sous Android 5.0 (niveau d'API 21) 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:
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 correspondante. Cette page inclut une section qui liste les dépendances des services Google Play courantes pour les applications Android. Vous pouvez également ajouter des dépendances Firebase à votre projet.
Enregistrez les modifications et synchronisez votre projet.
L'extrait de code suivant montre 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 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 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 5.0 (niveau d'API 21) 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 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 des 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 établir ensuite une connexion aux services Google Play ou savoir 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 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, 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.
Cas d'utilisation et nom de la dépendance | Appareils compatibles |
---|---|
Annonces pour mobile Googlecom.google.android.gms:play-services-ads:22.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, ChromeOS |
Version allégée des annonces Google pour mobilecom.google.android.gms:play-services-ads-lite:22.5.0 |
Téléphone, tablette |
Annonces pour les recherches personnalisées AdSense pour les recherches (AFS)com.google.android.gms:play-services-afs-native:19.0.3 |
Téléphone, tablette, ChromeOS |
SDK des services Google Analytics pour Androidcom.google.android.gms:play-services-analytics:18.0.4 |
Obsolète. Utilisez plutôt Google Analytics pour Firebase. |
Index des applicationscom.google.android.gms:play-services-appindex:16.1.0 |
Téléphone, tablette, Android TV |
ID du groupe d'applications Androidcom.google.android.gms:play-services-appset:16.0.2 |
Téléphone, tablette, Android TV, ChromeOS |
Google Sign-In pour Androidcom.google.android.gms:play-services-auth:20.7.0 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS |
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, ChromeOS |
API Google Awarenesscom.google.android.gms:play-services-awareness:19.0.1 |
Téléphone, tablette, Auto, Android Go, ChromeOS |
Classes utilitairescom.google.android.gms:play-services-base:18.2.0 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Tester des données fictives pour les classes utilitairescom.google.android.gms:play-services-base-testing:16.0.0 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Autres classes d'utilitairescom.google.android.gms:play-services-basement:18.2.0 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.3.0 |
Téléphone, tablette, Android Go, ChromeOS |
Framework d'application Google Castcom.google.android.gms:play-services-cast-framework:21.3.0 |
Téléphone, tablette, Android Go, ChromeOS |
Récepteurs Android TVcom.google.android.gms:play-services-cast-tv:21.0.0 |
Android TV |
Google Code Scannercom.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.0.1 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Interactions entre les appareilscom.google.android.gms:play-services-dtdi:16.0.0-beta01 |
Téléphone, tablette, Android Go |
Authentification FIDO (Fast IDentity Online)com.google.android.gms:play-services-fido:20.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 Androidcom.google.android.gms:play-services-fitness:21.1.0 |
Téléphone, tablette, Android Go, ChromeOS, Wear OS |
Services de jeux Google Play v2 pour Androidcom.google.android.gms:play-services-games-v2:19.0.0 |
Téléphone, tablette, Android TV, Android Go, ChromeOS |
SDK des services de jeux Google Play v2 natif C pour Androidcom.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 Androidcom.google.android.gms:play-services-games:23.1.0 |
Téléphone, tablette, Android TV, Android Go, ChromeOS |
API Mattercom.google.android.gms:play-services-home:16.0.0 |
Téléphone, tablette |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.0.1 |
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. |
Fused Location Provider pour Android (inclut la reconnaissance de l'activité et le géorepérage)com.google.android.gms:play-services-location:21.0.1
| Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK Google Maps pour Androidcom.google.android.gms:play-services-maps:18.2.0 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Lecture de codes-barres ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0 |
Téléphone, tablette, Android Go, ChromeOS |
Détection de visages avec ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Téléphone, tablette, Android Go, ChromeOS |
Étiquetage d'images ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Téléphone, tablette, Android Go, ChromeOS |
Étiquetage personnalisé d'images dans ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Téléphone, tablette, Android Go, ChromeOS |
Identification du langage avec ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Réponse suggérée dans ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Téléphone, tablette, Android Go, ChromeOS |
Segmentation par sujet du ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Téléphone, tablette, Android Go, ChromeOS |
Reconnaissance de texte dans ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Reconnaissance de texte dans ML Kit pour le chinoiscom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Reconnaissance de texte dans ML Kit pour Devanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Reconnaissance de texte avec ML Kit pour le japonaiscom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Reconnaissance de texte dans ML Kit pour le coréencom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Détection des appareils à proximité et connexioncom.google.android.gms:play-services-nearby:19.0.0 |
Téléphone, tablette, Android TV, Auto, Android Go |
Afficher les licences Open Sourcecom.google.android.gms:play-services-oss-licenses:17.0.1 |
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. |
Contrôle qualité du verrouillage 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.4.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 des applicationscom.google.android.gms:play-services-recaptcha:17.0.1 |
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.0.1 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.0.4 |
Téléphone, tablette, Android TV, Android Go, ChromeOS |
API Tasks sur Androidcom.google.android.gms:play-services-tasks:18.0.2 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Service d'accélération pour Androidcom.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 Playcom.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 Playcom.google.android.gms:play-services-tflite-java:16.1.0 |
Téléphone, tablette, Android Go, ChromeOS |
API TensorFlow Lite Support pour les services Google Playcom.google.android.gms:play-services-tflite-support:16.1.0 |
Téléphone, tablette, Android Go, ChromeOS |
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, ChromeOS |
Google Pay pour les paiements sur Androidcom.google.android.gms:play-services-wallet:19.2.1 |
Téléphone, tablette, Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:18.1.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 apparaissent 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, ChromeOS |
Vérification stricte de la versioncom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |