التخطيط لإعداد المستخدمين

ننصحك باتّباع الإرشادات التالية لمنح المستخدمين إمكانية الوصول إلى تطبيقك.

إعداد تطبيقك

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

<!-- Required to support pre-Android 14 devices with APK Health Connect -->
<activity
  android:name=".OnboardingActivity"
  android:exported="true"
  android:permission="com.google.android.apps.healthdata.permission.START_ONBOARDING"
  <intent-filter>
    <action android:name="androidx.health.ACTION_SHOW_ONBOARDING"/>
  </intent-filter>
</activity>
<!-- Required to support Android 14+ devices with platform Health Connect -->
<activity-alias
  android:name="UAndAboveOnboardingActivity"
  android:exported="true"
  android:targetActivity=".OnboardingActivity"
  android:permission="android.permission.health.START_ONBOARDING">
  <intent-filter>
    <action android:name="android.health.connect.action.ACTION_SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

يُرجى العلم أنّ هذه الميزة غير متاحة بعد في نظام التشغيل Android 14. ولكنه يتوفر قريبًا.

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

• عرض أي معلومات ذات صلة للمستخدم مثل شرح البيانات المكتوبة أو تَقْرَأ
• اطلب من المستخدم منح موافقته إذا لزم الأمر.
• قدِّم طلب أذونات للوصول إلى Health Connect.
• تنفيذ أي منطق آخر محدد بالتطبيق مثل جدولة موعد عامل.
• بعد اكتمال العملية، اسمح للمستخدم بإغلاق النشاط.

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

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