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

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

إعداد تطبيقك

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

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