Vérifier la disponibilité des fonctionnalités

Lorsque de nouvelles fonctionnalités sont ajoutées à Santé Connect, les utilisateurs ne mettent pas toujours à jour leur version de Santé Connect. L'API Feature Availability permet de vérifier si une fonctionnalité de Santé Connect est disponible sur l'appareil de votre utilisateur et de décider de la mesure à prendre.

Premiers pas

L'API de disponibilité des fonctionnalités partage la même dépendance que Santé Connect SDK. Pour commencer, vérifiez qu'au moins la version 1.1.0-alpha08 est installée sur votre Fichier build.gradle:

dependencies {
  implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}

Effectuer la vérification

La fonction principale permettant de vérifier la disponibilité des fonctionnalités est getFeatureStatus(). Cette commande renvoie des constantes entières, FEATURE_STATUS_AVAILABLE ou FEATURE_STATUS_UNAVAILABLE:

if (healthConnectClient
     .features
     .getFeatureStatus(
       HealthConnectFeatures.FEATURE_HEALTH_DATA_BACKGROUND_READ
     ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {

  // Feature is available
  ...
} else {
  // Feature is not available
  ...
}

Gérer l'indisponibilité de fonctionnalités

Si une fonctionnalité n'est pas disponible sur l'appareil d'un utilisateur, une mise à jour peut l'activer. Vous pouvez demander à l'utilisateur de mettre à jour Santé Connect s'il ne dispose pas de la dernière version compatible sur son appareil. Toutefois, les utilisateurs de l'APK (sur Android 13 et versions antérieures) ne peuvent pas utiliser les fonctionnalités du module système disponible sur les appareils équipés d'Android 14 ou version ultérieure.