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

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

إجراء عملية التحقّق

إنّ الوظيفة الرئيسية للتحقّق من مدى توفّر الميزات هي getFeatureStatus(). يؤدي ذلك إلى عرض ثوابت الأعداد الصحيحة FEATURE_STATUS_AVAILABLE أو FEATURE_STATUS_UNAVAILABLE:

if (healthConnectClient
     .features
     .getFeatureStatus(
       HealthConnectFeatures.FEATURE_HEALTH_DATA_BACKGROUND_READ
     ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {

  // Feature is available
  ...
} else {
  // Feature is not available
  ...
}

التعامل مع نقص الميزات

إذا لم تكن إحدى الميزات متاحة على جهاز المستخدم، قد يؤدي تحديث إلى تفعيلها. إِنْتَ يمكنك توجيه المستخدم لتحديث Health Connect إذا لم يكن أحدث إصدار معتمد على أجهزتهم. ومع ذلك، لا يمكن للمستخدمين الذين يستخدمون حِزم APK (على Android 13 والإصدارات الأقدم) استخدام ميزات وحدة النظام التي لا تتوفّر إلا على الأجهزة التي تعمل بنظام Android 14 أو إصدار أحدث.