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

تتضمّن العديد من التطبيقات عملية إعداد مخصّصة، مثل تقديم معلومات عن الميزات أو طلب موافقة العميل. لتفعيل 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.SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

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

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

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

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

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

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

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

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

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

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