Premiers pas sur Android

Ce guide explique comment commencer à développer des applications avec Google Fit sur Android.

Configuration

Avant de commencer à créer votre application, suivez les étapes décrites dans les sections suivantes.

Pour utiliser les API Google Fit, vous devez disposer d'un compte Google. Vous pouvez créer un compte ou utiliser un compte existant. Vous pouvez créer un compte distinct pour tester votre application du point de vue d'un utilisateur.

Obtenez la dernière bibliothèque cliente pour les services Google Play sur votre hôte de développement:

  1. Ouvrez Android SDK Manager.
  2. Sous SDK Tools (Outils SDK), recherchez Google Play services (Services Google Play).
  3. Si l'état de ces packages n'est pas Installed (Installé), sélectionnez-les tous les deux, puis cliquez sur Install Packages (Installer les packages).

Pour activer l'API Fitness, obtenez un ID client OAuth 2.0.

Nous vous recommandons d'utiliser l'environnement de développement Android Studio pour créer une application avec l'API Fitness. Pour savoir comment créer un projet et le configurer dans Android Studio, consultez Créer un projet.

Dans Android Studio, ouvrez le fichier build.gradle de votre module et ajoutez la bibliothèque cliente des services Google Play en tant que dépendance:

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}
apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.3.0'
}

Cela permet de s'assurer que Gradle télécharge automatiquement le SDK Fitness lorsqu'il compile votre application.

Créer et tester votre application

Une fois que vous avez terminé les étapes de configuration, vous pouvez commencer à créer votre application. Pour commencer, découvrez les types de données que votre application peut stocker et lire. Découvrez comment utiliser les données dans Google Fit.

Pour lire et écrire certains types de données, votre application doit demander des autorisations Android.

Les types de données auxquels votre application est autorisée à accéder correspondent aux champs d'application de l'autorisation. Pour demander ces autorisations, vous devez ajouter les types de données auxquels votre application doit avoir accès dans une instance FitnessOptions. Lorsque votre application demande à utiliser l'un des types de données Google Fit, le SDK Android vérifie automatiquement à quels champs d'application ils appartiennent et demande à l'utilisateur l'autorisation d'utiliser ces champs.

Créez un client d'API et ajoutez les types de données auxquels votre application doit accéder pour écrire ou lire des données. Les points de terminaison suivants sont disponibles:

  • SensorsClient: permet d'accéder à différentes sources de données de santé et de bien-être à partir de capteurs matériels sur l'appareil local et les appareils associés.
  • RecordingClient: pour la collecte en arrière-plan, toujours activée, à faible consommation d'énergie des données des capteurs.
  • HistoryClient: insérer, supprimer et lire les données de l'historique dans Google Fit.
  • SessionsClient: créez et gérez les sessions d'activité des utilisateurs.
  • GoalsClient: lire les objectifs en termes de points de forme et de pas créés par les utilisateurs dans Google Fit.
  • ConfigClient: permet d'accéder aux types et paramètres de données personnalisés dans la plate-forme Google Fit.

Découvrez comment créer un client Fitness API.

Vous trouverez ci-dessous le flux d'autorisation qui s'affiche lorsque les utilisateurs sont invités à fournir des autorisations:

Figure 1 : Flux d'autorisation pour les utilisateurs
  1. Autorisations Android: les utilisateurs voient les autorisations Android que votre application a demandées avant de la télécharger. Une fois votre application téléchargée, elle demande toutes les autorisations d'exécution dont elle a besoin, et les utilisateurs les accordent ou les refusent.
  2. Vérifier et connecter: votre application vérifie si les autorisations ont été accordées avant de demander l'accès à d'autres types de données.
  3. Demande d'habilitations OAuth: Google invite l'utilisateur à accorder à votre application les habilitations OAuth nécessaires pour les types de données auxquels elle souhaite accéder.
  4. Accès appliqué: une fois que l'utilisateur a accordé des autorisations, votre application peut accéder aux types de données appartenant aux champs d'application pour lesquels l'utilisateur a accordé l'autorisation.

Faire une demande de validation

Après avoir créé et testé votre application, vous devez demander sa validation, en fournissant différents niveaux de justification pour les niveaux d'accès sensibles et restreints.