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

تتضمّن العديد من التطبيقات مسارًا مخصّصًا لإعداد المستخدمين في ما يتعلّق بسير العمل، مثل تعريف المستخدم بميزات التطبيق أو طلب موافقة المستخدم. لإنشاء مسار ربط سلس، يمكن لتطبيقك أيضًا استخدام Matchmaking API لطلب ربط تطبيقات أخرى يمكنها كتابة البيانات التي تم ضبط تطبيقك على قراءتها.

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

<!-- 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.SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

يمكن للمستخدمين بدء عملية الربط بتطبيقك مباشرةً من تطبيق Health Connect، بدلاً من بدءها من داخل تطبيقك.

الإصدارات المتوافقة

لتوفير الدعم لكل من الأجهزة التي تعمل بإصدارات Android الأقدم من 14 والإصدار 14 والإصدارات الأحدث، اتّبِع الخطوات التالية:

• الطريقة المقترَحة: أنشئ نشاطًا واحدًا لإعداد التطبيق يتناول كلا السيناريوهَين. استخدِم اسمًا مستعارًا للنشاط، كما هو موضّح في المثال، للتحقّق من التوافق مع إصدارات Android المختلفة.

• طريقة بديلة: يمكنك تصدير نشاطَين منفصلَين، أحدهما لكل إصدار من Android. وقد يؤدي هذا النهج إلى زيادة تعقيد الصيانة.

متطلبات النشاط الذي تم تصديره

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

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

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

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