이 페이지는 Cloud Translation API를 통해 번역되었습니다.

헬스 커넥트

개발자가 사용자의 건강/피트니스 기록을 읽거나 쓸 수 있습니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2024년 1월 10일	-	-	-	1.1.0-alpha07

데이터 유형에 대한 액세스 요청

헬스 커넥트와 통합하는 개발자는 사용자 개인 정보 보호와 보안 강화를 위해 다음 개발자 선언 양식을 작성하여 데이터 유형에 대한 읽기 또는 쓰기 액세스 권한을 요청해야 합니다. 요청에는 앱의 목적에 따라 필요한 데이터 유형에 대한 유효한 사용 사례를 포함합니다. 자세한 내용은 헬스 커넥트 정책 요구사항 FAQ 및 Android용 헬스 커넥트 권한을 참고하세요.

종속 항목 선언

헬스의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

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")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.1

버전 1.1.0-alpha07

2024년 1월 10일

androidx.health.connect:connect-client:1.1.0-alpha07가 출시되었습니다. 버전 1.1.0-alpha07에 포함된 커밋을 확인하세요.

API 변경사항

#getSdkStatus가 프로필 사용자 컨텍스트에서 호출되면 SDK_UNAVAILABLE를 반환합니다. 추가했습니다. (I91df3)
SleepStageRecord를 삭제했습니다. 추가합니다. (/If6ada)

버그 수정

결합 실패 시 IllegalStateException 대신 RemoteException이 발생합니다. 추가했습니다. (Id2233)

버전 1.1.0-alpha06

2023년 10월 18일

androidx.health.connect:connect-client:1.1.0-alpha06가 출시되었습니다. 버전 1.1.0-alpha06에 포함된 커밋을 확인하세요.

API 변경사항

recordingMethod 정의를 공개로 설정합니다. 추가했습니다. (I401fb)

버그 수정

위치가 세션 종료 시간 이전이어야 함을 명시하는 운동 경로에 문서를 추가합니다. 추가했습니다. (0e51e6)

버전 1.1.0-alpha05

2023년 10월 4일

androidx.health.connect:connect-client:1.1.0-alpha05가 출시되었습니다. 버전 1.1.0-alpha05에 포함된 커밋을 확인하세요.

API 변경사항

헬스 커넥트 데이터 관리 화면으로 이동하는 인텐트를 추가했습니다. 추가했습니다. (Ibf591)
AggregationResult에서 지원 중단된 메서드가 삭제되었습니다. 추가했습니다. (Idbda9)
구체화된 레코드 유형으로 레코드를 삭제하고 읽을 수 있을 뿐만 아니라 ReadRecordsRequest를 만드는 편의 API를 추가했습니다. 추가했습니다. (If58a5)

버그 수정

null 영양 필드가 Double.MIN_VALUE로 반환되는 Android 14의 버그를 수정했습니다. 추가했습니다. (1aa1d1)
버킷의 시작/종료 시간이 동일하여 월별/연간 기간별 집계에서 예외가 발생하는 Android 14의 버그를 수정했습니다. 추가했습니다. (281313)

버전 1.1.0-alpha04

2023년 9월 6일

androidx.health.connect:connect-client:1.1.0-alpha04가 출시되었습니다. 버전 1.1.0-alpha04에 포함된 커밋을 확인하세요.

API 변경사항

자바만 해당: ChangesResponse의 getHasMore() 필드 이름을 hasMore()로 바꿉니다. 추가했습니다. (I80695)
여러 Android 버전에서 HealthPermissionsRequestContract#createIntent 검사를 정렬합니다. 이 계약은 모든 권한이 상태 관련 권한인지 확인합니다. 추가했습니다. (I143fc)

버그 수정

빈 위치 목록이 포함된 ExerciseRoute로 ExerciseSessionRecord를 만들 때 발생하는 예외를 수정합니다. 추가했습니다. (I45c16)
수면 세션 읽기를 위한 SleepSessionRecord 문서 및 샘플 코드를 업데이트했습니다. 추가했습니다. (Idf0de)

버전 1.1.0-alpha03

2023년 7월 26일

androidx.health.connect:connect-client:1.1.0-alpha03가 출시되었습니다. 버전 1.1.0-alpha03에 포함된 커밋을 확인하세요.

새로운 기능

운동 경로를 읽고 쓰는 API:
- ExerciseSessionRecord에 ExerciseRouteResult 추가됨
- ExerciseRouteRequestContract 추가됨

API 변경사항

ExerciseRouteResult 및 서브클래스(Data, NoData, ConsentRequiredStates)를 추가했습니다.
경로의 위치 데이터를 보유하는 독립형 클래스로 ExerciseRoute를 추가했습니다. 추가했습니다. (I22eed)
PERMISSION_WRITE_EXERCISE_ROUTE을 추가했습니다. 추가했습니다. (I92fc4)
ExerciseRouteRequestContract 및 HealthPermissionsRequestContract를 추가했습니다. 추가했습니다. (Ief0e5)

버그 수정

에너지 구성을 킬로줄 단위로 고정했습니다. (Ie8791)

버전 1.1.0-alpha02

2023년 6월 21일

androidx.health.connect:connect-client:1.1.0-alpha02가 출시되었습니다. 버전 1.1.0-alpha02에 포함된 커밋을 확인하세요.

버그 수정

HealthDataSdkService 누수 문제를 수정했습니다. (Ia3ba5)
Android U에서 권한을 요청할 때 항상 올바른 HealthConnect 클라이언트로 리디렉션합니다.(I6415a)

버전 1.1.0-alpha01

2023년 6월 7일

androidx.health.connect:connect-client:1.1.0-alpha01가 출시되었습니다. 이 버전은 내부 브랜치에서 개발되었습니다.

새로운 기능

헬스 커넥트의 Android 14 프레임워크 버전을 지원합니다. 이 SDK는 Android 14의 기본 요건입니다. 헬스 커넥트가 없으면 앱을 Android 14에서 헬스 커넥트와 통합할 수 없습니다.
메타데이터를 녹화하는 녹화 방법을 추가했습니다.

API 변경사항

Session API 변경사항:
- 다양한 수면 단계를 SleepSessionRecord에 추가하고 SleepStageRecord를 삭제했습니다.
- ExerciseSessionRecord에 ExerciseLap 및 ExerciseSegment를 추가했습니다.
읽기, 변경 로그, 삽입, 삭제 작업에 대한 주기적 및 일일 비율 제한 (메모리 제한 포함)
모든 NutritionRecord 필드에 대한 유효성 검사가 추가되었습니다.
HeartRateVariabilityRmssdRecord 유효성 검사가 추가되었습니다.
지원 중단된 두 API인 HealthConnectClient#isProviderAvailable 및 HealthConnectClient#isApiSupported가 삭제되었습니다.

버그 수정

모든 단위 유형에서 고정 단위 같음, 더 이상 단위 초기화에 사용된 유형에 종속되지 않습니다. 예를 들어 Mass.grams(1000)는 이제 Mass.kilograms(1)와 같습니다.

버전 1.0

버전 1.0.0-alpha11

2023년 2월 22일

androidx.health.connect:connect-client:1.0.0-alpha11가 출시되었습니다. 버전 1.0.0-alpha11에 포함된 커밋을 확인하세요.

API 변경사항

헬스 커넥트를 여는 데 사용하는 인텐트를 추가했습니다. (Ic8055)
일부 운동 유형을 삭제했습니다. 삭제된 유형 대신 EXERCISE_TYPE_STRENGTH_TRAINING, EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING 또는 EXERCISE_TYPE_CALISTHENICS를 사용하세요. (I7291c)
지원 중단된 두 API isSdkSupported()와 isProviderAvailable()을 결합한 새 API sdkStatus()를 추가했습니다. (Iac89d)
providerPackageName을 받는 API가 목록이 아닌 단일 문자열을 받도록 변경했습니다. (I67e0f)

버전 1.0.0-alpha10

2023년 1월 25일

androidx.health.connect:connect-client:1.0.0-alpha10가 출시되었습니다. 버전 1.0.0-alpha10에 포함된 커밋을 확인하세요.

API 변경사항

ExerciseEventRecord, ExerciseLapRecord, ExerciseRepititionRecord, SwimmingStrokesRecord는 더 이상 RecordTypes로 지원되지 않습니다. 이러한 API는 더 이상 HealthConnect에서 데이터를 쓰거나 읽을 수 없습니다. HealthConnect 통합에서 이러한 데이터 유형에 관한 참조를 삭제합니다. (If7ca2)
새 문자열 기반 형식에서 권한을 허용하도록 권한 API를 변경했습니다. 이 변경사항을 적용하려면 권한 선언도 표준 Android 권한 형식으로 변경해야 합니다. (Ib0a2f)

버전 1.0.0-alpha09

2023년 1월 11일

androidx.health.connect:connect-client:1.0.0-alpha09가 출시되었습니다. 버전 1.0.0-alpha09에 포함된 커밋을 확인하세요.

새로운 기능

헬스 커넥트의 새로운 여성 건강 데이터 유형 2개(IntermenstrualBleedingRecord, MenstruationPeriodRecord)를 추가했습니다. MenstruationFlow.ENUMs는 적음, 보통, 많음, 알 수 없음입니다.

API 변경사항

IntermenstrualBleedingRecord를 추가했습니다. (Idc470)
MenstruationPeriodRecord 레코드 유형을 추가했습니다. (Iea545)

버전 1.0.0-alpha08

2022년 12월 7일

androidx.health.connect:connect-client:1.0.0-alpha08가 출시되었습니다. 버전 1.0.0-alpha08에 포함된 커밋을 확인하세요.

API 변경사항

BodyWaterMass, HeartRateVariabilityRmssdRecord를 지원되는 새로운 레코드 유형으로 추가합니다. (Ifd58f)
지원되는 RecordTypes로 HipCircumferenceRecord, WaistCircumferenceRecord를 삭제합니다. (I62fb9)
MenstruationFlowRecord.flow를 stringdef에서 intdefs로 변경했습니다. (I0369f)
성능 향상을 위해 Strings가 있는 enum 유사 레코드 필드를 Integers로 변경했습니다. (I3b295)
ExerciseSession, ExerciseRepetitions, SleepStage enum 유사 필드를 문자열 유형에서 정수 유형으로 변경했습니다. (Id32a9)
ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL로 이름을 바꿨습니다. (I5d7bd)
CervicalMucus enum에 'Unusual'을 추가합니다. 구체성 향상을 위해 'Clear'를 'Eggwhite'로 바꿉니다. CervicalMucus#appearance 및 #sensation을 StringDefs에서 IntDefs로 변경했습니다. (I3ac51)
이제 DeviceTypes enum의 StringDef가 기기에서 IntDefs로 이동됩니다. (I3abf3)
호환되는 구현이 없는 SDK 버전에서 false를 반환하는 HealthConnectClient.isApiSupported()를 추가합니다. HealthConnectClient.isAvailable->isProviderAvailable로 이름을 바꿨습니다. (I3674e)

버그 수정

1보다 작은 HeartRate beatsPerMinute 값을 허용하지 않습니다. (I6052f)
@JvmDefaultWithCompatibility 주석을 추가합니다. (I8f206)

버전 1.0.0-alpha07

2022년 10월 24일

androidx.health.connect:connect-client:1.0.0-alpha07가 출시되었습니다. 버전 1.0.0-alpha07에 포함된 커밋을 확인하세요.

API 변경사항

기본값이 없는 레코드 인수는 기본값이 있는 인수 앞에 배치됩니다. 일관성을 위해 Instant 및 ZoneOffset 인수는 항상 맨 앞에 배치됩니다. (Id618c)
HealthConnectClient.getOrCreate#packageNames의 이름을 providerPackageNames로 바꿉니다. (Id81e4)

버그 수정

레코드 필드 값 유효성 검사를 추가합니다. 제공된 값이 적절한 범위를 벗어나면 매우 잘못된 값으로 인해 IllegalArgumentExceptions가 발생합니다. (Ie171d)
해당하는 경우 종료 시간 전에 기록 시작 시간을 확인합니다. (I02460)

버전 1.0.0-alpha06

2022년 10월 5일

androidx.health.connect:connect-client:1.0.0-alpha06가 출시되었습니다. 버전 1.0.0-alpha06에 포함된 커밋을 확인하세요.

버그 수정

서비스 연결 수명 주기를 개선합니다. (If2bd5)
서비스 연결에서 예외가 발생할 때 NPE 비정상 종료 버그를 수정했습니다. (I13546)

버전 1.0.0-alpha05

2022년 9월 21일

androidx.health.connect:connect-client:1.0.0-alpha05가 출시되었습니다. 버전 1.0.0-alpha05에 포함된 커밋을 확인하세요.

API 변경사항

Metadata.uid를 Metadata.id로 바꾸고 관련 CRUD API 전반에서 용어 recordId를 일관되게 사용했습니다. (I3d1d2)
PermissionController.createRequestPermissionActivityContract를 인스턴스 메서드가 아닌 정적 메서드로 변경했습니다. PermissionController.createRequestPermissionResultContract로 이름을 바꿨습니다. (Icd2fe)
BloodGlucoseRecord의 BloodGlucose 단위 유형을 추가했습니다. (I97678)
MenstruationRecord를 MenstruationFlowRecord로 바꿨습니다. (I3b88e)

버그 수정

클라이언트 프로세스에서 포그라운드 통계를 전파하지 않는 의도하지 않은 동작을 수정했습니다. (Ifb44c)

버전 1.0.0-alpha04

2022년 8월 24일 androidx.health.connect:connect-client:1.0.0-alpha04가 출시되었습니다. 버전 1.0.0-alpha04에 포함된 커밋을 확인하세요.

`androidx.health.connect로 이전

1.0.0-alpha04부터 androidx.health:health-connect-client가 androidx.health.connect:connect-client로 이전되었습니다. 헬스 커넥트의 이전 버전을 보려면 androidx.health 페이지를 방문하세요.

이전하려면 종속 항목 가져오기를 androidx.health:health-connect-client:1.0.0-alpha03에서 androidx.health.connect:connect-client:1.0.0-alpha04로 변경하면 됩니다.

새로운 기능

API 호출을 위해 기본으로 제공되는 선택적 디버그 로그가 포함되었습니다. (링크)

API 변경사항

메타데이터 clientId를 clientRecordId로, clientVersion을 clientRecordVersion으로 바꿨습니다. (링크)
메타데이터 UID를 더 읽기 좋게 개선했으며 더 이상 null을 허용하지 않습니다. (링크)
체중 단위에 파운드를 추가했습니다. (링크)
DeletionChange.deleteUid의 이름을 uid로 바꿨습니다. (링크)
Permission -> HealthPermission으로 이름을 바꿨습니다. 이렇게 하면 Android Framework 권한의 모호성을 방지할 수 있습니다. (링크)

버그 수정

에너지의 칼로리 단위가 잘못된 회귀 문제를 수정했습니다. (링크)
일부 레코드 유형의 집계와 관련된 회귀 문제를 수정했습니다. (링크)