لضمان اطمئنان المستخدمين إلى أنّه تتم قراءة بياناتهم بشكل صحيح، عليك أن توضّح لهم كيفية حصول تطبيقك على البيانات التي تأتي من السمة packageName
الخاصة بفئة DataOrigin
.
يمكنك إجراء ذلك بطريقتَين:
تحديد المصدر الأساسي
يجب أن تعرض واجهة المستخدم على الأقل رمز مصدر التطبيق واسمه (أو اسم التطبيق فقط إذا تعذّر عرض الرمز). تكون عملية تحديد المصدر الأساسية مناسبة للشاشات التالية: الصفحة الرئيسية وسجلّ الأنشطة وتفاصيل الأنشطة.
لإتاحة تحديد المصدر بشكل صحيح، يمكن لتطبيقك عرض اسم التطبيق الذي سجّل البيانات في الأصل ورمزه. يساعد ذلك في تعزيز ثقة المستخدمين ويقدّم توضيحًا بشأن مصدر المعلومات الصحية.
لا تحتاج إلى طلب أي إذن حسّاس، مثل
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.

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


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