نمایش داده ها و اسناد

برای اطمینان به کاربران از اینکه داده‌های آنها به درستی خوانده می‌شود، به وضوح نشان دهید که برنامه شما چگونه داده‌هایی را که از ویژگی packageName کلاس DataOrigin می‌آید، به دست می‌آورد.

دو راه برای رسیدن به این هدف وجود دارد:

1. اسناد پایه
2. انتساب با تحصیلات

اسناد پایه

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