헬스 커넥트

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

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2023년 2월 22일	-	-	-	1.0.0-alpha11

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

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

종속 항목 선언

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

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

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.0.0-alpha11"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.0.0-alpha11")
}

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

의견

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

새로운 문제 제출하기

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

버전 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 권한의 모호성을 방지할 수 있습니다. (링크)

버그 수정

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