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 :
Ouvrez le fichier
build.gradledans le répertoire du module de votre application.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.
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.
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.
| Cas d'utilisation et nom de la dépendance | Appareils compatibles |
|---|---|
Google Mobile Adscom.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 Adscom.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 Androidcom.google.android.gms:play-services-analytics:18.1.1 |
Obsolète. Utilisez plutôt Google Analytics pour Firebase. |
Indexation des applicationscom.google.android.gms:play-services-appindex:16.2.0 |
Téléphone, tablette, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Téléphone, tablette, Android TV |
ID d'ensemble d'applications Androidcom.google.android.gms:play-services-appset:16.1.0 |
Téléphone, tablette, Android TV, ChromeOS |
Connexion Google pour Androidcom.google.android.gms:play-services-auth:21.5.1 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.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 Awarenesscom.google.android.gms:play-services-awareness:20.0.0 |
Téléphone, tablette, Auto, Android Go, ChromeOS |
Classes utilitairescom.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 utilitairescom.google.android.gms:play-services-base-testing:16.2.0 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Autres classes utilitairescom.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 photocom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07 |
Téléphone, tablette |
Google Castcom.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 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.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 Verifiercom.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 Androidcom.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 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:24.0.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.2.0 |
Obsolète. Pour en savoir plus, consultez Google Play Instant. |
Services de localisation pour Androidcom.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 Androidcom.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 Androidcom.google.android.gms:play-services-maps3d:0.2.0 |
Téléphone, tablette |
Amélioration des effets multimédiascom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta02 |
Téléphone, tablette |
Lecture de codes-barres ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Téléphone, tablette, Android Go, ChromeOS |
Scanner de documents ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Détection des visages ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Téléphone, tablette, Android Go, ChromeOS |
Libellisation d'images ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Téléphone, tablette, Android Go, ChromeOS |
Libellisation d'images personnalisée ML Kitcom.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 Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Téléphone, tablette, Android Go, ChromeOS |
Réponse suggérée ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Téléphone, tablette, Android Go, ChromeOS |
Segmentation des sujets ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Téléphone, tablette, Android Go, ChromeOS |
Reconnaissance de texte ML Kitcom.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 chinoiscom.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 devanagaricom.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 japonaiscom.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éencom.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 Sourcecom.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 applicationscom.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 Managercom.google.android.gms:play-services-tagmanager:18.3.0 |
Téléphone, tablette, Android TV, Android Go, ChromeOS |
API Tasks sur Androidcom.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 Androidcom.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 Playcom.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 Playcom.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 Playcom.google.android.gms:play-services-tflite-support:16.4.0 |
Téléphone, tablette, Android Go, ChromeOS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Téléphone, tablette |
API Trusted Timecom.google.android.gms:play-services-time:16.0.1 |
Téléphone, tablette, Auto, Android Go, Wear OS |
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.5.0 |
Téléphone, tablette, Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.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.
| Cas d'utilisation et nom du plug-in Gradle | Appareils compatibles |
|---|---|
Afficher les licences Open Sourcecom.google.android.gms:oss-licenses-plugin:0.11.0 |
Téléphone, tablette, ChromeOS |
Vérification stricte des versionscom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Téléphone, tablette, Android TV, Auto, Android Go, ChromeOS, Wear OS |