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

כשמוסיפים תכונות חדשות ל-Health Connect, יכול להיות שהמשתמשים לא תמיד יעודכנו לגרסה העדכנית של Health Connect. ה-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
  ...
}

רשימה של כל הדגלים הזמינים של התכונות מופיעה בדף העזר בנושא HealthConnectFeatures.

איך מתמודדים עם חוסר זמינות של תכונות

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