Health

  
플랫폼에 구애받지 않는 방식으로 성능 기준에 적합한 건강 애플리케이션을 만듭니다.

이 표에는 androidx.health 그룹의 모든 아티팩트가 나열됩니다.

아티팩트 공개 버전 출시 후보 베타 버전 알파 버전
health-services-client - - - 1.0.0-alpha03
health-connect-client - - - 1.0.0-alpha03
이 라이브러리는 2022년 7월 27일에 최종 업데이트되었습니다.

종속 항목 선언

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

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

Groovy

dependencies {
    implementation "androidx.health:health-services-client:1.0.0-alpha03"
}

Kotlin

dependencies {
    implementation("androidx.health:health-services-client:1.0.0-alpha03")
}

의견

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

새 문제 만들기

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

Health Connect Client 버전 1.0

버전 1.0.0-alpha04

2022년 8월 24일

버전 1.0.0-alpha04 이상의 경우 Health Connect 페이지에서 출시 노트를 확인할 수 있습니다.

버전 1.0.0-alpha03

2022년 7월 27일

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

새로운 기능

  • 새로운 API 변경사항 요약: 읽기, 쓰기, 집계 API에 단위 집합이 추가되었습니다. 이제 앱에서 NutritionRecord 영양소 관련 그램 또는 밀리그램과 같이 원하는 단위로 기록을 검색하거나 쓸 수 있습니다.

API 변경사항

  • 다양한 요청 응답 객체에서 List<DataOrigin>Set<DataOrigin>이 되도록 수정합니다(I42342).
  • 전원->에너지에서 기초 총 칼로리의 단위를 수정합니다(I0b429).
  • 시리즈 기록 내에서 시리즈 샘플 클래스를 이동했습니다(Ica9bb).
    • CyclingPedalingCadence -> CyclingPedalingCadenceRecord.Sample
    • HeartRate -> HeartRateRecord.Sample
    • StepsCadence -> StepsCadenceRecord.Sample
  • HealthDataRequestPermission 클래스를 지원 중단하고 PermissionController.createRequestPermissionActivityContract로 대체했습니다. 이를 통해 검색 가능성과 통합 매개변수가 개선됩니다(I81e7f).
  • 볼륨에 미국 액량 온스를 추가했습니다(I5f03d).
  • 속도 단위 유형을 추가했습니다(I1d574).
  • 비율 단위 유형을 추가했습니다(I08f23).
  • 압력 단위 유형을 추가했습니다(Ifb01f).
  • 질량 단위 유형을 추가했습니다(Ifd81a).
  • 볼륨 단위 유형을 추가했습니다(I59ad1).
  • 전원 단위 유형을 추가했습니다. 전원 시리즈 샘플 클래스를 PowerRecord 클래스 내에서 이동했습니다(I5b1e5).
  • 에너지 단위 유형을 추가했습니다(I983ae).
  • 온도 단위 유형을 추가했습니다(I4cdb5).
  • Exercise에 관련되도록 Activity 참조의 이름을 바꿉니다(I3f936). 예를 들면 다음과 같습니다.
    • ActivityLap에서 ExerciseLapRecord로 이름을 바꿨습니다.
    • ActivityEvent에서 ExerciseEventRecord로 이름을 바꿨습니다.
    • Repetitions에서 ExerciseRepetitionsRecord로 이름을 바꿨습니다.
    • ActivitySession에서 ExerciseSessionRecord로 이름을 바꿨습니다.
  • 기록 아래에 중첩된 패키지 메타데이터를 이동했습니다(Ie0835).
  • 남은 모든 기록에서 길이 단위를 사용합니다(Ib10dd).
    • ActivityLapRecord
    • ElevationGainedRecord
    • HeightRecord
    • HipCircumferenceRecord
    • WaistCircumferenceRecord
  • 길이 단위 유형을 추가했습니다(Idae39).
  • CervicalMucus 설명 용어를 업데이트합니다(I25a2b).
    • CervicalMucus.Amount -> CervicalMucusRecord.Texture
    • CervicalMucus.Appearance -> CervicalMucusRecord.Sensation
  • 모든 기록 클래스 이름에 'Record' 접미사를 추가했습니다(I1ffc2).

버그 수정

  • lib가 출시 버전과 minifyEnabled true로 빌드된 경우 발생하는 proguard 문제를 수정했습니다(I78933).
  • 공용으로 사용할 수 없는 문서를 숨깁니다(I7a08f).
  • 자체 protobuf 종속 항목이 있을 수 있는 클라이언트의 문제를 수정했습니다(https://android-review.googlesource.com/c/platform/frameworks/support/+/2105430).

버전 1.0.0-alpha02

2022년 6월 1일

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

API 변경사항

  • AggregationResult에서 hasMetricgetMetric을 지원 중단하고 contains 연산자와 get 연산자를 추가했습니다(I7cc7c).
  • OvulationTest.Result.HIGHOvulationTest.Result.INCONCLUSIVE를 추가합니다(I9f9c4).

버그 수정

  • SDK 요구사항을 26개로 줄입니다(I6d201).

버전 1.0.0-alpha01

2022년 5월 11일

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

새로운 기능

  • 다른 앱에서 공유하는 피트니스 및 건강 기록을 읽는 API
  • 피트니스 및 건강 기록을 작성하여 다른 앱과 공유하는 API
  • 액세스할 수 있는 기록의 집계된 측정항목을 가져오는 API
  • 다른 앱에 의한 기록 증분 변경사항(삽입, 업데이트, 삭제)을 가져오는 API
  • 사용자에게 건강 관련 권한을 요청하는 메시지를 표시하는 API
  • 건강 관련 권한을 확인하거나 부여된 권한을 취소하는 API

Health Services Client 버전 1.0

버전 1.0.0-alpha03

2021년 11월 3일

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

새로운 기능

  • SDK는 건강 관리 서비스 APK와의 IPC 연결이 끊어진 경우 측정, 운동 수신기 및 수동 모니터링 콜백 등록 요청을 자동으로 다시 등록합니다.

API 변경사항

  • 건강 관리 서비스 Client가 현재 Wear3에서만 지원되므로 SDK 라이브러리의 minSdkVersion이 API 수준 30으로 변경되었습니다.

버전 1.0.0-alpha02

2021년 9월 29일

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

API 변경사항

  • 이제 ExerciseClient에서 운동 준비를 지원합니다. 그럼 운동을 시작하기 전에 클라이언트가 센서를 준비하고 GPS 수정과 같은 작업을 기다리게 됩니다.
  • CumulativeDataPoints 및 StatisticalDataPoints AggregateDataPoint 클래스를 도입하여 활성 운동 중에 추적된 집계 측정항목을 더 효과적으로 모델링합니다. CumulativeDataPoints는 집계된 구간 데이터 유형(예: 운동 중 총 거리)의 누적 값을 보유하며, StatisticalDataPoints는 샘플링된 데이터 포인트(예: 최소, 최대, 평균 HeartRateBpm)의 집계를 모델링합니다. 이전 AGGREGATE_* DataType을 대체하며 getLatestAggregateMetrics()를 통해 ExerciseUpdate에서 액세스할 수 있습니다. AGGREGATE_* DataType은 더 이상 지원되지 않습니다.
  • PassiveMonitoring 이벤트 이름이 PassiveGoals로 변경되었으며, 이를 통해 일일 측정항목(예: DAILY_STEPS)과 같은 데이터 유형에서 목표를 설정하고 목표 달성 시 알림을 받을 수 있습니다.
  • 새로운 HrAccuracy, LocationAccuracy 및 LocationAvailability 클래스를 도입하여 심박수, 위치 정확도 및 이용 가능 여부의 모델링을 개선했습니다.
  • ExerciseConfig 및 새 PassiveMonitoringConfig 필드의 이름 지정이 개선되고 GPS 기반 데이터를 요청하기 위해 ExerciseConfig.shouldEnableGps가 도입되었습니다.

버그 수정

  • 더 나은 하위 호환성 지원을 위해 Proto 지원 IPC 전송으로 이전했습니다.

버전 1.0.0-alpha01

2021년 5월 18일

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

초기 출시의 기능

건강 관리 서비스 라이브러리는 개발자가 기기별 센서 구현과 통합할 수 있도록 일관된 API 세트를 제공합니다. Wear OS 3 에뮬레이터 및 향후 출시될 기기에서는 기본적으로 지원되며 향후 추가 플랫폼이 지원됩니다. 이 초기 출시에는 세 가지 최상위 API 노출 영역(ExerciseClient, PassiveMonitoringClient, MeasureClient)이 포함되어 있습니다.

ExerciseClient

ExerciseClient는 걷기와 달리기에서 댄스와 수구에 이르기까지 최대 82개의 다양한 ExerciseType으로 활동적인 운동을 추적하는 애플리케이션용으로 만들어졌습니다. 이러한 운동을 추적하는 동안 기기에서 사용할 수 있는 운동 유형과 하드웨어에 따라 50개의 다양한 DataType이 제공됩니다. 시작하려면 ExerciseConfig에서 관련 정보를 지정하고 exerciseClient.startExercise를 호출한 후 업데이트 리스너에서 진행 상황을 수신 대기하면 됩니다.

PassiveMonitoringClient

PassiveMonitoringClient는 애플리케이션이 하루 종일 사용자 활동을 추적하는 경우에 적합합니다. PendingIntent를 일련의 DataType에 등록하면 일괄 처리된 변경사항을 처리할 수 있습니다. 또는 특정 단계 수에 도달 등 Event를 지정할 수 있습니다.

MeasureClient

사용자는 운동하는 동안이나 하루 종일이 아닌 특정 순간의 심박수를 측정해야 할 때가 있습니다. 그러한 순간에는 MeasureClient가 적합합니다. 지원되는 DataType에 콜백을 등록하여 데이터 스트림을 수신하면 더 이상 필요하지 않을 때 콜백을 등록 취소할 수 있습니다.