檢查功能適用的國家/地區

當 Health Connect 新增功能時，使用者不一定會更新 Health Connect 版本。您可以使用「Feature Availability API」檢查使用者的裝置是否支援 Health Connect 中的某項功能，並決定要採取哪些動作。

開始使用

Feature Availability 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 以上版本的裝置的系統模組功能。