عرض البيانات وتحديد المصدر

لضمان اطمئنان المستخدمين إلى أنّه تتم قراءة بياناتهم بشكل صحيح، عليك أن توضّح لهم كيفية حصول تطبيقك على البيانات التي تأتي من السمة packageName الخاصة بفئة DataOrigin.

يمكنك إجراء ذلك بطريقتَين:

  1. الإحالة الأساسية
  2. الإحالة في التعليم

تحديد المصدر الأساسي

يجب أن تعرض واجهة المستخدم على الأقل رمز مصدر التطبيق واسمه (أو اسم التطبيق فقط إذا تعذّر عرض الرمز). تكون عملية تحديد المصدر الأساسية مناسبة للشاشات التالية: الصفحة الرئيسية وسجلّ الأنشطة وتفاصيل الأنشطة.

لإتاحة تحديد المصدر بشكل صحيح، يمكن لتطبيقك عرض اسم التطبيق الذي سجّل البيانات في الأصل ورمزه. يساعد ذلك في تعزيز ثقة المستخدمين ويقدّم توضيحًا بشأن مصدر المعلومات الصحية.

لا تحتاج إلى طلب أي إذن حسّاس، مثل QUERY_ALL_PACKAGES، لاسترداد هذه المعلومات. يوضّح المثال التالي كيفية استرداد تصنيف التطبيق ورمزه لحزمة معيّنة من PackageManager:

fun getAppLabelAndIcon(context: Context, packageName: String): Pair<CharSequence?, Drawable?>{
    return try {
      val pm = context.packageManager
      val appInfo = pm.getApplicationInfo(packageName, 0)
      val label = pm.getApplicationLabel(appInfo)
      val icon = pm.getApplicationIcon(appInfo)
      label to icon
    } catch (e: PackageManager.NameNotFoundException){
      null to null
    }
}

تساعد هذه الأداة في التحقّق من صحة تحديد المصدر من خلال عرض اسم التطبيق ورمزه بجانب البيانات. يمكنك الاطّلاع على عملية التنفيذ في نموذج HealthConnectManager.kt.

تحديد المصدر الأساسي لبيانات القراءة
الشكل 1: تحديد المصدر الأساسي لبيانات القراءة

الإحالة إلى مصدر في التعليم

يجب أن يساعد تطبيقك المستخدمين في الحصول على معلومات حول مصدر البيانات، مع توفير رابط مباشر إلى شاشة "أذونات التطبيق" في Health Connect. هذا النوع من تحديد المصدر مناسب للشاشات التالية: تفاصيل النشاط والتقارير والإحصاءات.

تحديد مصدر الإحالة في تفاصيل النشاط وشاشات التقارير في تطبيق الشريك تحديد المصدر في شاشات الإحصاءات في تطبيق الشريك
الشكل 2: تحديد المصدر مع اختلافات في التعليم

تحديد مصدر الإحالة في تفاصيل النشاط وشاشات التقارير في تطبيق الشريك تحديد المصدر في شاشات الإحصاءات في تطبيق الشريك

مزامنة البيانات

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

عرض حالة مزامنة البيانات
الشكل 3: حالة مزامنة البيانات معروضة