Health Connect
Bản cập nhật mới nhất | Bản phát hành ổn định | Bản phát hành dùng thử | Bản phát hành beta | Bản phát hành alpha |
---|---|---|---|---|
Ngày 10 tháng 1 năm 2024 | - | - | - | 1.1.0-alpha07 |
Yêu cầu quyền đối với loại dữ liệu
Để giúp chúng tôi tăng cường mức độ bảo mật và quyền riêng tư của người dùng, nhà phát triển tích hợp với Health Connect phải yêu cầu quyền đọc và/hoặc ghi loại dữ liệu bằng cách hoàn thành biểu mẫu khai báo dưới đây dành cho nhà phát triển. Trong yêu cầu, hãy đưa ra (các) trường hợp sử dụng hợp lệ cho loại dữ liệu bạn cần dựa trên mục đích của ứng dụng. Để biết thêm thông tin, hãy truy cập vào phần Câu hỏi thường gặp liên quan đến yêu cầu của Chính sách Health Connect và Quyền truy cập Health Connect của Android.
Khai báo phần phụ thuộc
Để thêm một phần phụ thuộc trên Health, bạn phải thêm kho lưu trữ Google Maven vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.
Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle
cho ứng dụng hoặc mô-đun:
Groovy
dependencies { // Use to implement health connects implementation "androidx.health.connect:connect-client:1.1.0-alpha07" }
Kotlin
dependencies { // Use to implement health connects implementation("androidx.health.connect:connect-client:1.1.0-alpha07") }
Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.
Ý kiến phản hồi
Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.
Xem tài liệu về Công cụ theo dõi lỗi để biết thêm thông tin.
Phiên bản 1.1
Phiên bản 1.1.0-alpha07
Ngày 10 tháng 1 năm 2024
Phát hành androidx.health.connect:connect-client:1.1.0-alpha07
. Phiên bản 1.1.0-alpha07 bao gồm các thay đổi sau.
Các thay đổi về API
- Trả về
SDK_UNAVAILABLE
khi#getSdkStatus
được gọi từ ngữ cảnh người dùng hồ sơ. (I91df3) - Xoá
SleepStageRecord
. (/If6ada)
Sửa lỗi
- Gửi
RemoteException
thay vìIllegalStateException
khi có lỗi liên kết. (Id2233)
Phiên bản 1.1.0-alpha06
Ngày 18 tháng 10 năm 2023
Phát hành androidx.health.connect:connect-client:1.1.0-alpha06
. Phiên bản 1.1.0-alpha06 bao gồm các thay đổi sau.
Các thay đổi về API
- Đặt định nghĩa
recordingMethod
ở chế độ công khai. (I401fb)
Sửa lỗi
- Thêm tài liệu vào tuyến đường tập thể dục để chỉ định rằng vị trí đó phải trước thời gian kết thúc phiên. (0e51e6)
Phiên bản 1.1.0-alpha05
Ngày 4 tháng 10 năm 2023
Phát hành androidx.health.connect:connect-client:1.1.0-alpha05
. Phiên bản 1.1.0-alpha05 bao gồm các thay đổi sau.
Các thay đổi về API
- Thêm ý định chuyển đến màn hình quản lý dữ liệu Health Connect. (Ibf591)
- Xoá các phương thức không dùng nữa trong
AggregationResult
. (Idbda9) - Thêm API thuận tiện để tạo
ReadRecordsRequest
, cũng như xoá và đọc bản ghi với loại bản ghi được sửa đổi. (If58a5)
Sửa lỗi
- Khắc phục lỗi trong Android 14 khiến các trường dinh dưỡng rỗng được trả về là
Double.MIN_VALUE
. (1aa1d1) - Sửa lỗi trong Android 14, trong đó việc tổng hợp theo khoảng thời gian Hằng tháng/Hằng năm đã gửi một ngoại lệ trong phản hồi do các bộ chứa có cùng thời gian bắt đầu/kết thúc. (281313)
Phiên bản 1.1.0-alpha04
Ngày 6 tháng 9 năm 2023
Phát hành androidx.health.connect:connect-client:1.1.0-alpha04
. Phiên bản 1.1.0-alpha04 bao gồm các thay đổi sau.
Các thay đổi về API
- Chỉ Java: đổi tên trường
getHasMore()
trênChangesResponse
thànhhasMore()
. (I80695) - Căn chỉnh
HealthPermissionsRequestContract#createIntent
kiểm tra trên các phiên bản Android. Hợp đồng này kiểm tra để đảm bảo tất cả các quyền đều là quyền liên quan đến sức khoẻ. (I143fc)
Sửa lỗi
- Khắc phục trường hợp ngoại lệ được gửi khi tạo
ExerciseSessionRecord
bằngExerciseRoute
có chứa danh sách vị trí trống. (I45c16) - Cập nhật tài liệu và mã mẫu về
SleepSessionRecord
để đọc phiên giấc ngủ. (Idf0de)
Phiên bản 1.1.0-alpha03
Ngày 26 tháng 7 năm 2023
Phát hành androidx.health.connect:connect-client:1.1.0-alpha03
. Phiên bản 1.1.0-alpha03 bao gồm các thay đổi sau.
Tính năng mới
- API để đọc và ghi tuyến đường Bài tập thể dục:
- Đã thêm
ExerciseRouteResult
vàoExerciseSessionRecord
- Đã thêm
ExerciseRouteRequestContract
- Đã thêm
Các thay đổi về API
- Thêm
ExerciseRouteResult
và các lớp con:Data
,NoData
vàConsentRequiredStates
. - Thêm
ExerciseRoute
dưới dạng một lớp độc lập, lớp này lưu giữ dữ liệu vị trí cho tuyến đường. (Người dùng) - Thêm
PERMISSION_WRITE_EXERCISE_ROUTE
. (I92fc4) - Đã thêm
ExerciseRouteRequestContract
vàHealthPermissionsRequestContract
đã thêm. (Ief0e5)
Sửa lỗi
- Sửa lỗi tạo Năng lượng tính theo kilojun (Ie8791)
Phiên bản 1.1.0-alpha02
Ngày 21 tháng 6 năm 2023
Phát hành androidx.health.connect:connect-client:1.1.0-alpha02
. Phiên bản 1.1.0-alpha02 bao gồm các thay đổi sau.
Sửa lỗi
- Khắc phục sự cố rò rỉ
HealthDataSdkService
(Ia3ba5) - Luôn chuyển hướng đến Ứng dụng
HealthConnect
phù hợp khi yêu cầu quyền trên Android U.(I6415a)
Phiên bản 1.1.0-alpha01
Ngày 7 tháng 6 năm 2023
Phát hành androidx.health.connect:connect-client:1.1.0-alpha01
. Phiên bản này được phát triển trong một nhánh nội bộ.
Tính năng mới
- Hỗ trợ phiên bản khung Android 14 của Health Connect. SDK này là điều kiện tiên quyết để chạy Android 14. Nếu không có, các ứng dụng sẽ không thể tích hợp với Health Connect trên Android 14.
- Thêm phương thức ghi để ghi siêu dữ liệu.
Các thay đổi về API
- Các thay đổi về API phiên:
- Thêm nhiều giai đoạn ngủ vào
SleepSessionRecord
và xoáSleepStageRecord
. - Thêm
ExerciseLap
vàExerciseSegment
vàoExerciseSessionRecord
.
- Thêm nhiều giai đoạn ngủ vào
- Giới hạn tốc độ định kỳ và hằng ngày (bao gồm cả giới hạn bộ nhớ) cho các thao tác đọc, thay đổi, chèn và xoá.
- Thêm tính năng xác thực cho tất cả các trường
NutritionRecord
. - Thêm tính năng xác thực cho
HeartRateVariabilityRmssdRecord
. - Xoá 2 API không dùng nữa:
HealthConnectClient#isProviderAvailable
vàHealthConnectClient#isApiSupported
.
Sửa lỗi
- Cố định đẳng thức đơn vị cho tất cả các loại đơn vị, đẳng thức không còn phụ thuộc vào loại dùng để khởi tạo đơn vị. Ví dụ: Khối lượng.gam(1000) bây giờ bằng Khối lượng.kilogam(1).
Phiên bản 1.0
Phiên bản 1.0.0-alpha11
Ngày 22 tháng 2 năm 2023
Phát hành androidx.health.connect:connect-client:1.0.0-alpha11
. Phiên bản 1.0.0-alpha11 bao gồm các thay đổi sau.
Các thay đổi về API
- Thêm ý định dùng để mở Health Connect. (Ic8055)
- Xoá một số loại bài tập thể dục. Hãy sử dụng
EXERCISE_TYPE_STRENGTH_TRAINING
,EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
hoặcEXERCISE_TYPE_CALISTHENICS
thay cho các loại đã xoá. (I7291c) - Thêm API
sdkStatus()
mới kết hợp 2 APIisSdkSupported()
vàisProviderAvailable()
hiện không còn được dùng nữa. (Iac89d) - Thay đổi các API dùng
providerPackageName
để chấp nhận một chuỗi thay vì danh sách. (I67e0f)
Phiên bản 1.0.0-alpha10
Ngày 25 tháng 1 năm 2023
Phát hành androidx.health.connect:connect-client:1.0.0-alpha10
. Phiên bản 1.0.0-alpha10 bao gồm các thay đổi sau.
Các thay đổi về API
ExerciseEventRecord
,ExerciseLapRecord
,ExerciseRepititionRecord
vàSwimmingStrokesRecord
không còn được hỗ trợ dưới dạngRecordTypes
. Chúng không thể được ghi hoặc đọc từHealthConnect
nữa. Hãy xoá mọi tham chiếu đến các loại dữ liệu này khỏi quá trình tích hợpHealthConnect
. (If7ca2)- Các thay đổi trong các API quyền để chấp nhận quyền ở định dạng mới dựa trên chuỗi. Sự thay đổi này cũng yêu cầu thay đổi khai báo quyền sang định dạng quyền Android tiêu chuẩn. (Ib0a2f)
Phiên bản 1.0.0-alpha09
Ngày 11 tháng 1 năm 2023
Phát hành androidx.health.connect:connect-client:1.0.0-alpha09
. Phiên bản 1.0.0-alpha09 bao gồm các thay đổi sau.
Tính năng mới
- Thêm 2 loại dữ liệu mới về sức khoẻ nữ giới cho Health Connect:
IntermenstrualBleedingRecord
vàMenstruationPeriodRecord
.MenstruationFlow.ENUMs
có các thuộc tính là Ít, Trung bình, Nhiều và Không xác định.
Các thay đổi về API
Phiên bản 1.0.0-alpha08
Ngày 7 tháng 12 năm 2022
Phát hành androidx.health.connect:connect-client:1.0.0-alpha08
. Phiên bản 1.0.0-alpha08 bao gồm các thay đổi sau.
Các thay đổi về API
- Thêm
BodyWaterMass
,HeartRateVariabilityRmssdRecord
ở dạng Loại bản ghi mới được hỗ trợ. (Ifd58f) - Xoá
HipCircumferenceRecord
,WaistCircumferenceRecord
ở dạngRecordTypes
được hỗ trợ. (I62fb9) - Thay đổi
MenstruationFlowRecord.flow
từstringdef
thànhintdefs
. (I0369f) - Thay đổi các trường Ghi giống enum với
Strings
thànhIntegers
để cải thiện hiệu suất. (I3b295) - Thay đổi kiểu của các trường giống enum là
ExerciseSession
,ExerciseRepetitions
,SleepStage
từ chuỗi thành số nguyên. (Id32a9) - Đổi tên
ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL
. (I5d7bd) - Thêm "Unusual" (Bất thường) vào enum
CervicalMucus
. Đổi tên "Clear" (Xoá sạch) thành "Eggwhite" để tăng tính rõ ràng. Thay đổiCervicalMucus#appearance
và #sensation từStringDefs
thành IntDefs. (I3ac51) StringDef
của enumDeviceTypes
giờ được chuyển vàoIntDefs
trong phần Thiết bị. (I3abf3)- Thêm
HealthConnectClient.isApiSupported()
, có tác dụng trả về giá trị false trên các phiên bản SDK không có cách triển khai tương thích. Đổi tênHealthConnectClient.isAvailable->isProviderAvailable
. (I3674e)
Sửa lỗi
- Không cho phép các giá trị
HeartRate beatsPerMinute
nhỏ hơn 1 (I6052f) - Thêm chú thích
@JvmDefaultWithCompatibility
(I8f206)
Phiên bản 1.0.0-alpha07
Ngày 24 tháng 10 năm 2022
Phát hành androidx.health.connect:connect-client:1.0.0-alpha07
. Phiên bản 1.0.0-alpha07 bao gồm các thay đổi sau.
Các thay đổi về API
- Các đối số ghi không có giá trị mặc định được đặt trước các đối số có giá trị mặc định. Để đảm bảo tính nhất quán, các đối số
Instant
vàZoneOffset
luôn được đặt ngay từ đầu. (Id618c) - Đổi tên
HealthConnectClient.getOrCreate#packageNames
thànhproviderPackageNames
. (Id81e4)
Sửa lỗi
- Thêm xác thực giá trị trường Record (Ghi). Các giá trị cực kỳ sai sẽ gửi
IllegalArgumentExceptions
khi giá trị được cung cấp nằm ngoài giới hạn hợp lý. (Ie171d) - Xác thực thời gian bắt đầu ghi trước thời gian kết thúc khi phù hợp. (I02460)
Phiên bản 1.0.0-alpha06
Ngày 5 tháng 10 năm 2022
Phát hành androidx.health.connect:connect-client:1.0.0-alpha06
. Phiên bản 1.0.0-alpha06 bao gồm các thay đổi sau.
Sửa lỗi
- Cải thiện vòng đời của kết nối của dịch vụ. (If2bd5)
- Khắc phục lỗi NPE khi ngoại lệ tăng lên trong kết nối dịch vụ. (I13546)
Phiên bản 1.0.0-alpha05
Ngày 21 tháng 9 năm 2022
Phát hành androidx.health.connect:connect-client:1.0.0-alpha05
. Phiên bản 1.0.0-alpha05 bao gồm các thay đổi sau.
Các thay đổi về API
- Đổi tên
Metadata.uid
->Metadata.id
và sử dụng thuật ngữrecordId
một cách nhất quán trong các API CRUD có liên quan. (I3d1d2) - Đặt
PermissionController.createRequestPermissionActivityContract
làm phương thức tĩnh thay vì phương thức thực thể. Đổi tên thànhPermissionController.createRequestPermissionResultContract
. (Icd2fe) - Thêm loại đơn vị
BloodGlucose
choBloodGlucoseRecord
(I97678) - Đổi tên
MenstruationRecord
->MenstruationFlowRecord
. (I3b88e)
Sửa lỗi
- Khắc phục hành vi ngoài mong muốn không lan truyền số liệu thống kê ở nền trước theo quy trình của ứng dụng khách. (Ifb44c)
Phiên bản 1.0.0-alpha04
Ngày 24 tháng 8 năm 2022 phát hành
androidx.health.connect:connect-client:1.0.0-alpha04
. Phiên bản 1.0.0-alpha04 bao gồm các thay đổi sau.
Di chuyển sang `androidx.health.connect
Kể từ phiên bản 1.0.0-alpha04, androidx.health:health-connect-client
đã được chuyển sang androidx.health.connect:connect-client
. Để xem các phiên bản Health Connect trước, vui lòng truy cập trang androidx.health.
Để di chuyển, thay vì nhập phần phụ thuộc từ androidx.health:health-connect-client:1.0.0-alpha03
, bạn chỉ cần chuyển thành androidx.health.connect:connect-client:1.0.0-alpha04
.
Tính năng mới
- Cung cấp nhật ký gỡ lỗi (không bắt buộc) có sẵn cho lệnh gọi API (đường liên kết)
Các thay đổi về API
- Đổi tên Metadata.
clientId
thànhclientRecordId
, Metadata.clientVersion
thànhclientRecordVersion
. (đường liên kết) - Cải tiến để Metadata.uid thân thiện hơn với trình đọc và không còn giá trị rỗng. (đường liên kết)
- Thêm pound vào đơn vị Khối lượng (đường liên kết)
- Đổi tên
DeletionChange.deleteUid
thành uid (đường liên kết) - Đổi tên Permission thành HealthPermission. Điều này giúp tránh tình trạng không rõ ràng về các quyền của Khung Android. (đường liên kết)
Sửa lỗi
- Sửa lỗi hồi quy ở đơn vị calo không chính xác của Năng lượng (đường liên kết)
- Sửa lỗi hồi quy ở quá trình tổng hợp cho một số loại bản ghi (đường liên kết)