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

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

מתגי feature flag

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

ביצוע הבדיקה

הפונקציה העיקרית לבדיקת הזמינות של תכונות היא 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 isn't available
}

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

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

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

בסוגי מכשירים מורחבים, אם FEATURE_EXTENDED_DEVICE_TYPES לא זמין במכשיר של המשתמש, המערכת מתייחסת לערכים האלה כאל Device.TYPE_UNKNOWN. צריך לספק חלופה הגיונית בלוגיקה של הכתיבה ושל ממשק המשתמש.