기능 사용 가능 여부 확인

헬스 커넥트에 새로운 기능이 추가될 때 사용자가 헬스 커넥트 버전을 업데이트하지 않을 수 있습니다. 기능 사용 가능 여부 API는 헬스 커넥트의 기능이 사용자 기기에서 사용 가능한지 확인하고 취할 조치를 결정하는 방법입니다.

시작하기

기능 사용 가능 여부 API는 헬스 커넥트 SDK와 동일한 종속 항목을 공유합니다. 시작하려면 build.gradle 파일에 버전 1.1.0-alpha08 이상이 있는지 확인하세요.

dependencies {
  implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}

확인 실행

기능 가용성을 확인하는 기본 함수는 getFeatureStatus()입니다. 그러면 정수 상수 FEATURE_STATUS_AVAILABLE 또는 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
  ...
}

사용 가능한 모든 기능 플래그의 목록은 HealthConnectFeatures 참조 페이지를 확인하세요.

기능 사용 불가능 처리

사용자 기기에서 기능을 사용할 수 없는 경우 업데이트를 통해 사용 설정될 수 있습니다. 기기에 지원되는 최신 버전이 없는 경우 사용자에게 헬스 커넥트를 업데이트하도록 안내하는 것이 좋습니다. 하지만 Android 13 이하에서 APK를 사용하는 사용자는 Android 14 이상을 실행하는 기기에서만 사용할 수 있는 시스템 모듈 기능을 사용할 수 없습니다.