Santé Connect

  
Permet aux développeurs de lire ou d'écrire les informations de santé et de remise en forme d'un utilisateur.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
15 janvier 2025 - - - 1.1.0-alpha11

Demander l'accès aux types de données

Pour nous aider à renforcer la confidentialité et la sécurité des utilisateurs, les développeurs qui intègrent Santé Connect doivent déclarer un accès en lecture et/ou en écriture pour les types de données que leurs applications utilisent. Les développeurs doivent inclure des cas d'utilisation valides pour les types de données qu'ils utilisent en fonction de l'objectif de l'application. Pour en savoir plus, consultez les pages Fournir des informations dans le formulaire de déclaration des applications de santé et Autorisations de Santé Connect par Android.

Déclarer des dépendances

Pour ajouter une dépendance sur Health, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.1.0-alpha08"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Santé Connect version de test 1.0

Version 1.0.0-alpha01

4 septembre 2024

Publication d'androidx.health.connect:connect-testing:1.0.0-alpha01. La version 1.0.0-alpha01 contient ces commits.

Nouvelles fonctionnalités

La bibliothèque de test Santé Connect simplifie la création de tests automatisés. Vous pouvez utiliser cette bibliothèque pour vérifier le comportement de votre application et vérifier qu'elle répond correctement aux cas inhabituels, qui sont difficiles à tester manuellement.

Vous pouvez utiliser la bibliothèque pour créer des tests unitaires locaux, qui vérifient généralement le comportement des classes de votre application qui interagissent avec le client Health Connect.

Le point d'entrée de la bibliothèque est la classe FakeHealthConnectClient, que vous utilisez dans les tests pour remplacer HealthConnectClient. Il présente les caractéristiques suivantes:

  • Représentation en mémoire des enregistrements, afin de pouvoir les insérer, les supprimer, les supprimer et les lire
  • Génération de jetons de modification et suivi des modifications
  • Pagination pour les enregistrements et les modifications
  • Les réponses d'agrégation sont compatibles avec les bouchons
  • Autorise toute fonction à générer des exceptions
  • Un FakePermissionController pouvant être utilisé pour émuler les vérifications d'autorisations

Modifications apportées à l'API

  • Ajouter FakeHealthConnectClient e8469
  • Ajout de forçages de bouchon pour FakeHealthConnectClient e8469

Version 1.1

Version 1.1.0-alpha11

15 janvier 2025

Publication d'androidx.health.connect:connect-client:1.1.0-alpha11, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha11 et androidx.health.connect:connect-client-proto:1.1.0-alpha11. La version 1.1.0-alpha11 contient ces commits.

Nouvelles fonctionnalités

  • Mise à jour des autorisations de lecture en arrière-plan et de l'historique pour prendre en charge Android 13 et versions antérieures.

Modifications apportées à l'API

  • Ajout de surcharges réifiées intégrées pour HealthPermission.getReadPermission et HealthPermission.getWritePermission. (I59a2e)

Correction de bugs

  • Suppression des anciennes méthodes d'autorisation (Ifd080)
  • Cette bibliothèque utilise désormais les annotations de nullité JSpecify, qui sont des annotations de type d'utilisation. Les développeurs Kotlin doivent utiliser les arguments de compilation suivants pour appliquer une utilisation correcte: -Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode (Iaf73a, b/326456246)
  • Correction de la documentation pour HealthPermission.READ_HEALTH_DATA_HISTORY, en particulier en indiquant que les lectures sans cette autorisation ne échouent que lorsque vous essayez de lire un seul point de données. (Id5b5a)

Version 1.1.0-alpha10

16 octobre 2024

Publication d'androidx.health.connect:connect-client:1.1.0-alpha10, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha10 et androidx.health.connect:connect-client-proto:1.1.0-alpha10. La version 1.1.0-alpha10 contient ces commits.

Nouvelles fonctionnalités

  • Ajout de types d'agrégation SkinTemperature. (Ibe123)
  • Ajout de la constante FEATURE_PLANNED_EXERCISE (Ie02a3)
  • Ajout des autorisations de lecture de l'historique. (I5cf41)
  • Ajout de l'API Training plans (If5be1)
  • Ajout de l'API SkinTemperatureRecord. (I5605d)

Correctifs de sécurité

  • Depuis cette modification, androidx compile avec protobuf 4.28.2 afin de corriger CVE-2024-7254. Mettez à niveau votre dépendance sur androidx.health:connect:connect-client-proto et androidx.health:connect:connect-client-external-protobuf vers la dernière version 1.1.0-alpha10 pour réduire le risque de faille.

Version 1.1.0-alpha09

18 septembre 2024

Publication d'androidx.health.connect:connect-client:1.1.0-alpha09, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha09 et androidx.health.connect:connect-client-proto:1.1.0-alpha09. La version 1.1.0-alpha09 contient ces commits.

Nouvelles fonctionnalités

  • Ajoutez l'autorisation de lecture en arrière-plan, protégée par la disponibilité de la fonctionnalité. (I01036, I44db9)

Version 1.1.0-alpha08

4 septembre 2024

Publication d'androidx.health.connect:connect-client:1.1.0-alpha08, androidx.health.connect:connect-client-external-protobuf:1.1.0-alpha08 et androidx.health.connect:connect-client-proto:1.1.0-alpha08. La version 1.1.0-alpha08 contient ces commits.

Modifications apportées à l'API

  • Définissez la valeur par défaut de la variable "features" dans HealthConnectClient. (I788dc)
  • Ajoutez une API pour vérifier la disponibilité des fonctionnalités. (Iedd43)

Correction de bugs

  • Renvoie SDK_UNAVAILABLE dans HealthConnectClient.getSdkStatus() lorsque HealthConnectManager est nul en U+ 5802f
  • Ajout de forçages toString à RecordClasses aa5dc
  • Suppression de la description manuelle de l'accès aux nouvelles API de la plate-forme, car cela se produit automatiquement via la modélisation des API lorsque vous utilisez R8 avec AGP 7.3 ou version ultérieure (par exemple, R8 3.3) et pour tous les builds lorsque vous utilisez AGP 8.1 ou version ultérieure (par exemple, D8 8.1). Nous recommandons aux clients qui n'utilisent pas AGP de passer à la version 8.1 ou ultérieure de D8. Consultez cet article pour en savoir plus. (If6b4c, b/345472586)

Version 1.1.0-alpha07

10 janvier 2024

Publication d'androidx.health.connect:connect-client:1.1.0-alpha07. Liste des commits de la version 1.1.0-alpha07

Modifications apportées à l'API

  • Renvoyez SDK_UNAVAILABLE lorsque #getSdkStatus est appelé à partir d'un contexte utilisateur de profil. (I91df3)
  • Supprimez SleepStageRecord. (/If6ada)

Correction de bugs

  • Exception RemoteException au lieu de IllegalStateException en cas d'échec de liaison. (Id2233)

Version 1.1.0-alpha06

18 octobre 2023

Publication d'androidx.health.connect:connect-client:1.1.0-alpha06. Liste des commits de la version 1.1.0-alpha06

Modifications apportées à l'API

  • Rend les définitions recordingMethod publiques. (I401fb)

Correction de bugs

  • Ajoutez une documentation au parcours d'exercice indiquant que l'emplacement doit être antérieur à l'heure de fin de la session. (0e51e6)

Version 1.1.0-alpha05

4 octobre 2023

Publication d'androidx.health.connect:connect-client:1.1.0-alpha05. Liste des commits de la version 1.1.0-alpha05

Modifications apportées à l'API

  • Ajout d'un intent qui accède à l'écran de gestion des données de Santé Connect. (Ibf591)
  • Suppression des méthodes obsolètes dans AggregationResult. (Idbda9)
  • Ajout d'une API pratique pour créer des ReadRecordsRequest, ainsi que pour supprimer et lire des enregistrements, avec un type d'enregistrement réifié. (If58a5)

Correction de bugs

  • Correction d'un bug dans Android 14 qui renvoyait les champs nutritionnels nuls en tant que Double.MIN_VALUE. (1aa1d1)
  • Correction d'un bug dans Android 14, qui entraînait une exception dans la réponse lorsque l'agrégation par période mensuelle/annuelle avait lieu, car les buckets avaient la même heure de début/fin. (281313)

Version 1.1.0-alpha04

6 septembre 2023

Publication d'androidx.health.connect:connect-client:1.1.0-alpha04. Liste des commits de la version 1.1.0-alpha04

Modifications apportées à l'API

Correction de bugs

Version 1.1.0-alpha03

26 juillet 2023

Publication d'androidx.health.connect:connect-client:1.1.0-alpha03. Liste des commits de la version 1.1.0-alpha03

Nouvelles fonctionnalités

  • API permettant de lire et d'écrire des parcours d'exercice :
    • L'élément "ExerciseRouteResult" a été ajouté à la collection "ExerciseSessionRecord"
    • ExerciseRouteRequestContract ajouté

Modifications apportées à l'API

  • Ajout de ExerciseRouteResult et de ses sous-classes: Data, NoData et ConsentRequiredStates.
  • Ajout de ExerciseRoute en tant que classe autonome, qui contient les données de localisation de l'itinéraire. (I22eed)
  • Ajout de PERMISSION_WRITE_EXERCISE_ROUTE (I92fc4)
  • ExerciseRouteRequestContract ajouté, HealthPermissionsRequestContract ajouté. (Ief0e5)

Correction de bugs

  • Correction de la construction de l'énergie en kilojoules (Ie8791)

Version 1.1.0-alpha02

21 juin 2023

Publication d'androidx.health.connect:connect-client:1.1.0-alpha02. Liste des commits de la version 1.1.0-alpha02

Correction de bugs

  • Correction de la fuite HealthDataSdkService (Ia3ba5)
  • Redirigez toujours vers le bon client HealthConnect lorsque vous demandez des autorisations sur Android U.(I6415a)

Version 1.1.0-alpha01

7 juin 2023

Publication d'androidx.health.connect:connect-client:1.1.0-alpha01. Cette version est développée dans une branche interne.

Nouvelles fonctionnalités

  • Compatibilité avec la version du framework Android 14 de Santé Connect. Ce SDK est un prérequis pour Android 14. Sans elle, les applications ne pourront pas s'intégrer à Santé Connect sur Android 14.
  • Ajout d'une méthode d'enregistrement pour enregistrer les métadonnées.

Modifications apportées à l'API

  • Modifications apportées à l'API Session :
    • Ajout de différentes phases de sommeil dans SleepSessionRecord et suppression de SleepStageRecord.
    • Ajout de ExerciseLap et ExerciseSegment dans ExerciseSessionRecord.
  • Limites périodiques et quotidiennes (y compris les limites de mémoire) pour les opérations de lecture, de journal des modifications, d'insertion et de suppression.
  • Ajout d'une validation pour tous les champs NutritionRecord.
  • Ajout de la validation pour HeartRateVariabilityRmssdRecord.
  • Suppression de deux API obsolètes: HealthConnectClient#isProviderAvailable et HealthConnectClient#isApiSupported.

Correction de bugs

  • Egalité des unités fixe pour tous les types d'unités. L'égalité ne dépend plus du type utilisé pour l'initialisation des unités. Par exemple, Mass.grams(1 000) est désormais égal à Mass.kilograms(1).

Version 1.0

Version 1.0.0-alpha11

22 février 2023

Publication d'androidx.health.connect:connect-client:1.0.0-alpha11. Liste des commits de la version 1.0.0-alpha11

Modifications apportées à l'API

  • Ajout d'un intent à utiliser pour ouvrir Santé Connect. (Ic8055)
  • Suppression de certains types d'exercices. Utilisez EXERCISE_TYPE_STRENGTH_TRAINING, EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING ou EXERCISE_TYPE_CALISTHENICS au lieu des types supprimés. (I7291c)
  • Ajout de l'API sdkStatus() qui combine les deux API isSdkSupported() et isProviderAvailable(), désormais obsolètes. (Iac89d)
  • Modification des API qui acceptent providerPackageName pour qu'elles n'acceptent qu'une seule chaîne plutôt qu'une liste. (I67e0f)

Version 1.0.0-alpha10

25 janvier 2023

Publication d'androidx.health.connect:connect-client:1.0.0-alpha10. Liste des commits de la version 1.0.0-alpha10

Modifications apportées à l'API

  • ExerciseEventRecord, ExerciseLapRecord,ExerciseRepititionRecord et SwimmingStrokesRecord ne sont plus compatibles en tant que RecordTypes. Vous ne pouvez plus les écrire ni les lire à partir de HealthConnect. Supprimez toute référence à ces types de données de l'intégration HealthConnect. (If7ca2)
  • Modification des API d'autorisations pour accepter les autorisations dans un nouveau format basé sur des chaînes. Ce changement requiert également le remplacement de la déclaration d'autorisation par le format d'autorisation Android standard. (Ib0a2f)

Version 1.0.0-alpha09

11 janvier 2023

Publication d'androidx.health.connect:connect-client:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09

Nouvelles fonctionnalités

  • Nous avons ajouté deux types de données sur la santé féminine pour Santé Connect : IntermenstrualBleedingRecord et MenstruationPeriodRecord. MenstruationFlow.ENUMs : Light ("Léger"), Medium ("Moyen"), Heavy ("Abondant") et Unknown ("Inconnu").

Modifications apportées à l'API

  • Ajout de IntermenstrualBleedingRecord (Idc470)
  • Ajout du type d'enregistrement MenstruationPeriodRecord (Iea545)

Version 1.0.0-alpha08

7 décembre 2022

Publication d'androidx.health.connect:connect-client:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08

Modifications apportées à l'API

  • Prise en charge des types d'enregistrements BodyWaterMass et HeartRateVariabilityRmssdRecord. (Ifd58f)
  • Suppression de HipCircumferenceRecord et WaistCircumferenceRecord comme RecordTypes acceptés. (I62fb9)
  • Changement de la valeur de MenstruationFlowRecord.flow de stringdef à intdefs. (I0369f)
  • Valeur Strings des champs d'enregistrement de type énumération remplacée par Integers, pour de meilleures performances. (I3b295)
  • Modification du type des champs ExerciseSession, ExerciseRepetitions et SleepStage de type énumération de "chaîne" à "entier". (Id32a9)
  • Changement de nom : ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL. (I5d7bd)
  • Ajout de la valeur "Unusual" (Inhabituel) aux énumérations CervicalMucus. La valeur "Clear" (Clair) a été renommée "Eggwhite" (Blanc d'œuf) pour plus de précision. Valeur StringDefs de CervicalMucus#appearance et #sensation remplacée par IntDefs. (I3ac51)
  • Déplacement de l'énumération DeviceTypes de StringDef vers IntDefs sous "Device" (Appareil). (I3abf3)
  • Ajout de HealthConnectClient.isApiSupported(), qui renvoie la valeur "false" sur les versions du SDK sans implémentation compatible. Changement de nom : HealthConnectClient.isAvailable->isProviderAvailable. (I3674e)

Corrections de bugs

  • Valeurs HeartRate beatsPerMinute inférieures à 1 interdites. (I6052f)
  • Ajout de l'annotation @JvmDefaultWithCompatibility. (I8f206)

Version 1.0.0-alpha07

24 octobre 2022

Publication d'androidx.health.connect:connect-client:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

Modifications apportées à l'API

  • Les arguments d'enregistrement sans valeur par défaut sont placés avant les arguments avec valeurs par défaut. Par souci de cohérence, les arguments Instant et ZoneOffset sont toujours placés au tout début. (Id618c)
  • HealthConnectClient.getOrCreate#packageNames a été renommé en providerPackageNames. (Id81e4)

Corrections de bugs

  • Ajout de validations pour la valeur du champ d'enregistrement. Les valeurs particulièrement fausses génèrent des IllegalArgumentExceptions si la valeur fournie dépasse les limites raisonnables. (Ie171d)
  • Validation de l'heure de début de l'enregistrement avant l'heure de fin, le cas échéant. (I02460)

Version 1.0.0-alpha06

5 octobre 2022

Publication d'androidx.health.connect:connect-client:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Corrections de bugs

  • Amélioration du cycle de vie de la connexion du service. (If2bd5)
  • Correction d'un bug entraînant un plantage NPE lorsqu'une exception était générée dans la connexion du service. (I13546)

Version 1.0.0-alpha05

21 septembre 2022

Publication d'androidx.health.connect:connect-client:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05

Modifications apportées à l'API

  • Metadata.uid s'appelle désormais Metadata.id. La terminologie recordId est utilisée de manière cohérente dans les API CRUD associées. (I3d1d2)
  • Définition de PermissionController.createRequestPermissionActivityContract comme méthode statique plutôt que comme méthode d'instance. Nom remplacé par PermissionController.createRequestPermissionResultContract. (Icd2fe)
  • Type d'unité BloodGlucose ajouté pour BloodGlucoseRecord. (I97678)
  • Remplacement du nom MenstruationRecord par MenstruationFlowRecord. (I3b88e)

Corrections de bugs

  • Correction d'un comportement inattendu. Les statistiques de premier plan n'étaient pas propagées depuis le processus client. (Ifb44c)

Version 1.0.0-alpha04

24 août 2022 Publication d'androidx.health.connect:connect-client:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04.

Migration vers "androidx.health.connect"

Depuis la version 1.0.0-alpha04, androidx.health:health-connect-client a été migré vers androidx.health.connect:connect-client. Pour les versions précédentes de Santé Connect, veuillez consulter la page androidx.health.

Pour effectuer la migration, remplacez simplement l'importation des dépendances androidx.health:health-connect-client:1.0.0-alpha03 par androidx.health.connect:connect-client:1.0.0-alpha04.

Nouvelles fonctionnalités

  • Intégration de journaux de débogage facultatifs pour les appels d'API (lien).

Modifications apportées à l'API

  • Métadonnées clientId renommées en clientRecordId, clientVersion en clientRecordVersion. (lien)
  • Nous avons rendu les métadonnées plus conviviales pour les lecteurs. Elles ne peuvent plus avoir une valeur nulle. (lien)
  • Ajout des livres (pounds) au type d'unité Mass. (lien)
  • DeletionChange.deleteUid renommé en uid. (lien)
  • Renommage de "Permission" en "HealthPermission. Cela évite toute ambiguïté avec les autorisations du framework Android. (lien)

Corrections de bugs

  • Résolution des problèmes de régression liés à une unité calorique incorrecte avec l'unité Energy (lien)
  • Correction d'un problème de régression avec l'agrégation pour quelques types d'enregistrements. (lien)