Premiers pas sur Android

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

Remarque : Google Fit fait partie des services Google Play. Découvrez les avantages que votre application peut tirer de l'utilisation des services Google Play Services.

Configuration

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

Obtenir un compte Google

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

Installer les services Google Play

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

1. Ouvrez le 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 et cliquez sur Install Packages (Installer les packages).

Obtenir un ID client OAuth 2.0

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

Créer et configurer votre projet

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.

Ajouter la bibliothèque cliente des services Google Play

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 :

DSL Kotlin

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

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.5.1")
}

DSL Groovy

apply plugin: 'com.android.application'

...

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

Gradle télécharge automatiquement le SDK Fitness lorsqu'il compile votre application.

Créer et tester votre application

Une fois les étapes de configuration terminées, vous pouvez commencer à créer votre application. Pour commencer, découvrez les types de données que votre application peut stocker et lire. En savoir plus sur l'utilisation des données dans Google Fit.

Obtenir les autorisations Android nécessaires

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

Obtenir les autorisations OAuth

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

Créer un client API

Créez un client 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 de l'appareil local et des appareils associés.
• RecordingClient: permet de collecter en arrière-plan des données de capteur en continu et à faible consommation d'énergie.
• HistoryClient : permet d'insérer, de supprimer et de lire des données historiques dans Google Fit.
• SessionsClient : permet de créer et de gérer des sessions d'activité utilisateur.
• GoalsClient: permet de lire les objectifs de points cardio et de pas créés par les utilisateurs dans Google Fit.
• ConfigClient: permet d'accéder aux types de données et aux paramètres personnalisés de la plate-forme Google Fit.

Découvrez un exemple de création d'un client API Fitness.

Flux d'autorisation utilisateur résultant

Voici le flux d'autorisation résultant que les utilisateurs rencontrent lorsqu'ils sont invités à accorder des autorisations :

Figure 1 : Flux d'autorisation pour les utilisateurs

1. Autorisations Android : les utilisateurs voient les autorisations Android demandées par votre application avant de la télécharger. Une fois votre application téléchargée, elle demande les autorisations d'exécution dont elle a besoin, et les utilisateurs les accordent ou les refusent ces autorisations.
2. Vérification et connexion : 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 de niveaux d'accès OAuth : Google invite l'utilisateur à accorder à votre application les niveaux d'accès 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é les autorisations, votre application peut accéder aux types de données appartenant aux niveaux d'accès pour lesquels l'utilisateur a accordé l'autorisation.

Demander une validation

Une fois que vous avez créé et testé votre application, vous devez demander une validation avec différents niveaux de justification nécessaires pour les niveaux d'accès sensibles et restreints.