Kiểm tra phạm vi cung cấp tính năng

Khi các tính năng mới được thêm vào Health Connect, người dùng không phải lúc nào cũng cập nhật phiên bản Health Connect. API Phạm vi cung cấp tính năng là một cách để kiểm tra xem một tính năng trong Health Connect có hoạt động trên thiết bị của người dùng hay không và quyết định hành động cần thực hiện.

Bắt đầu

API Phạm vi cung cấp tính năng có cùng phần phụ thuộc với SDK Health Connect. Để bắt đầu, hãy xác minh rằng ít nhất phiên bản 1.1.0-alpha08 có trong tệp build.gradle:

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

Thực hiện kiểm tra

Hàm chính để kiểm tra phạm vi cung cấp của tính năng là getFeatureStatus(). Thao tác này trả về hằng số số nguyên FEATURE_STATUS_AVAILABLE hoặc 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
  ...
}

Xử lý tình trạng không có tính năng

Nếu một tính năng không có trên thiết bị của người dùng, thì bản cập nhật có thể bật tính năng đó. Bạn có thể cân nhắc hướng dẫn người dùng cập nhật Health Connect nếu họ không có phiên bản được hỗ trợ mới nhất trên thiết bị. Tuy nhiên, người dùng sử dụng tệp APK (trên Android 13 trở xuống) không thể sử dụng các tính năng mô-đun hệ thống chỉ có trên các thiết bị chạy Android 14 trở lên.