برای اطمینان دادن به کاربران از اینکه داده‌هایشان به‌درستی خوانده می‌شود، به‌وضوح نشان دهید که برنامه‌تان چگونه داده‌ها را دریافت می‌کند، که از ویژگی packageName کلاس DataOrigin می‌آید.
دو روش برای دستیابی به این هدف وجود دارد:
ارجاع پایه
حداقل، میانای کاربر (UI) شما باید نماد منبع برنامه و نام آن را نمایش دهد (یا فقط نام برنامه را اگر نماد قابل‌نمایش نباشد). اسناد پایه برای صفحه‌های زیر مناسب است: صفحه اصلی، گزارش فعالیت، و جزئیات فعالیت.
برای پشتیبانی از ارجاع مناسب، برنامه شما می‌تواند نام و نماد برنامه‌ای را که در ابتدا داده‌ها را ثبت کرده است نمایش دهد. این کار اعتماد کاربر را افزایش می‌دهد و منبع اطلاعات سلامت را شفاف می‌کند.
برای بازیابی این اطلاعات، نیازی به درخواست هیچ‌گونه اجازه حساسی، مانند
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 تأخیر کافی وجود دارد، این اعلان را درطول همگام‌سازی در برنامه‌تان نشان دهید. این به کاربر اطلاع می‌دهد که ممکن است تکمیل فرایند کمی طول بکشد. اگر از اعلان‌ها برای همگام‌سازی استفاده می‌کنید، باید به‌طور پیش‌فرض روی اولویت پایین تنظیم شوند.
