检查功能可用性

当 Health Connect 中添加新功能时，用户可能不会始终更新其 Health Connect 版本。功能可用性 API 是一种方法，用于检查 Health Connect 中的功能在用户的设备上是否可用，并决定要采取的操作。

开始使用

功能可用性 API 与 Health Connect SDK 共享相同的依赖项。要开始使用，请验证您的 build.gradle 文件中至少包含版本 1.1.0-alpha08

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

执行检查

检查功能可用性的主要函数是 getFeatureStatus()。它返回整数常量 FEATURE_STATUS_AVAILABLE 或 FEATURE_STATUS_UNAVAILABLE

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

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

处理功能不可用

如果某个功能在用户的设备上不可用，则更新可能会启用它。如果用户在其设备上没有最新的受支持版本，您可以考虑引导他们更新 Health Connect。但是，使用 APK（在 Android 13 及更低版本上）的用户无法使用仅在运行 Android 14 或更高版本的设备上可用的系统模块功能。