איך יודעים אילו תכונות זמינות

כשמוסיפים תכונות חדשות ל-Health Connect, יכול להיות שהמשתמשים לא תמיד יעדכנו את הגרסה שלהם. בעזרת Feature Availability API אפשר לבדוק אם תכונה ב-Health Connect זמינה במכשיר של המשתמש ולהחליט איזו פעולה לבצע.

שנתחיל?

ל-Feature Availability API יש את אותה תלות כמו ל-Health Connect SDK. כדי להתחיל, מוודאים שלפחות גרסה 1.1.0-alpha08 נמצאת בקובץ build.gradle:

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
  ...
}

טיפול במקרים שבהם התכונה לא זמינה

אם תכונה מסוימת לא זמינה במכשיר של משתמש, יכול להיות שעדכון יאפשר אותה. אם במכשיר של המשתמש לא מותקנת הגרסה הנתמכת האחרונה של Health Connect, מומלץ להפנות אותו לעדכון האפליקציה. עם זאת, משתמשים שמשתמשים ב-APK (ב-Android 13 ומטה) לא יכולים להשתמש בתכונות של מודול המערכת שזמינות רק במכשירים עם Android 14 ואילך.