Kiểm tra phạm vi cung cấp tính năng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Khi các tính năng mới được thêm vào Health Connect, người dùng có thể không phải lúc nào cũng cập nhật phiên bản Health Connect của họ. Feature Availability API là một cách để kiểm tra xem một tính năng trong Health Connect có 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
Feature Availability API có cùng một phần phụ thuộc như Health Connect SDK. Để 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 của bạn:
dependencies {
implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}
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ề các hằng 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
...
}
Để xem danh sách tất cả các cờ tính năng có sẵn, hãy xem trang tham chiếu HealthConnectFeatures.
Xử lý trường hợp thiếu 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ọ chưa có phiên bản được hỗ trợ mới nhất trên thiết bị của mình. Tuy nhiên, người dùng sử dụng APK (trên Android 13 trở xuống) không thể dùng các tính năng của mô-đun hệ thống chỉ có trên các thiết bị chạy Android 14 trở lên.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-08-23 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-23 UTC."],[],[],null,["# Check for feature availability\n\nWhen new features are added to Health Connect, users may not always update their\nversion of Health Connect. The Feature Availability API is a way to check if a\nfeature in Health Connect is available on your user's device and decide what\naction to take.\n\nGet started\n-----------\n\nThe Feature Availability API shares the same dependency as the Health Connect\nSDK. To get started, verify that at least version `1.1.0-alpha08` is in your\n`build.gradle` file: \n\n dependencies {\n implementation(\"androidx.health.connect:connect-client:1.1.0-alpha08\")\n }\n\nPerform the check\n-----------------\n\nThe main function to check for feature availability is `getFeatureStatus()`.\nThis returns integer constants `FEATURE_STATUS_AVAILABLE` or\n`FEATURE_STATUS_UNAVAILABLE`: \n\n if (healthConnectClient\n .features\n .getFeatureStatus(\n HealthConnectFeatures.FEATURE_READ_HEALTH_DATA_IN_BACKGROUND\n ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {\n\n // Feature is available\n ...\n } else {\n // Feature is not available\n ...\n }\n\nFor a list of all available feature flags, see the [`HealthConnectFeatures`](/reference/androidx/health/connect/client/HealthConnectFeatures)\nreference page.\n\nHandle lack of feature availability\n-----------------------------------\n\nIf a feature isn't available on a user's device, an update may enable it. You\nmay consider directing the user to update Health Connect if they don't have\nthe latest supported version on their device. However, users using the APK\n(on Android 13 and lower) can't use the system module features that are only\navailable on devices running Android 14 or higher."]]
