التحقّق من توفّر الميزات

عند إضافة ميزات جديدة إلى Health Connect، قد لا يُجري المستخدمون تحديثًا ل إصدار Health Connect في بعض الأحيان. واجهة برمجة التطبيقات Feature Availability API هي طريقة للتحقّق مما إذا كانت إحدى ميزات Health Connect متاحة على جهاز المستخدم وتحديد الإجراء الذي يجب اتّخاذه.

البدء

تشترك واجهة برمجة التطبيقات Feature Availability API في التبعية نفسها التي تتبعها حزمة تطوير البرامج (SDK) لتطبيق Health Connect. للبدء، تأكَّد من توفّر الإصدار 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 أو الإصدارات الأحدث.