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

عند إضافة ميزات جديدة إلى 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.2.0-alpha06")
}

عناصر التحكّم في الميزات

يتم إدراج علامات الميزات المتاحة لتطبيق 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. يجب توفير خيار احتياطي معقول في منطق الكتابة وواجهة المستخدم.