Periksa ketersediaan fitur

Saat fitur baru ditambahkan ke Health Connect, pengguna mungkin tidak selalu mengupdate Health Connect versi mereka. Feature Availability API adalah cara untuk memeriksa apakah fitur di Health Connect tersedia di perangkat pengguna Anda dan memutuskan tindakan yang harus dilakukan.

Memulai

Feature Availability API memiliki dependensi yang sama dengan Health Connect SDK. Untuk memulai, pastikan setidaknya versi 1.1.0-alpha08 ada di file build.gradle Anda:

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

Lakukan pemeriksaan

Fungsi utama untuk memeriksa ketersediaan fitur adalah getFeatureStatus(). Fungsi ini menampilkan konstanta bilangan bulat FEATURE_STATUS_AVAILABLE atau FEATURE_STATUS_UNAVAILABLE:

Untuk menentukan apakah perangkat pengguna mendukung Baca Data Kesehatan di Latar Belakang di Health Connect, periksa ketersediaan FEATURE_READ_HEALTH_DATA_IN_BACKGROUND di klien:

if (healthConnectClient
     .features
     .getFeatureStatus(
       HealthConnectFeatures.FEATURE_READ_HEALTH_DATA_IN_BACKGROUND
     ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {

  // Feature is available
} else {
  // Feature isn't available
}

Untuk mengetahui daftar semua flag fitur yang tersedia, lihat halaman referensi HealthConnectFeatures.

Menangani kurangnya ketersediaan fitur

Jika fitur tidak tersedia di perangkat pengguna, update dapat mengaktifkannya. Anda dapat mempertimbangkan untuk mengarahkan pengguna agar mengupdate Health Connect jika mereka tidak memiliki versi terbaru yang didukung di perangkat mereka. Namun, pengguna yang menggunakan APK (di Android 13 dan yang lebih rendah) tidak dapat menggunakan fitur modul sistem yang hanya tersedia di perangkat yang menjalankan Android 14 atau yang lebih tinggi.

Untuk jenis perangkat yang diperluas, jika FEATURE_EXTENDED_DEVICE_TYPES tidak tersedia di perangkat pengguna, nilai tersebut akan diperlakukan sebagai Device.TYPE_UNKNOWN. Sediakan penggantian yang wajar dalam logika penulisan dan UI Anda.