التخطيط لإعداد المستخدمين
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتضمّن العديد من التطبيقات عملية إعداد مخصّصة، مثل تقديم معلومات عن الميزات أو طلب موافقة العميل. لتفعيل 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 المستخدم بدلاً من ذلك إلى شاشة إدارة الأذونات بعد أن يحاول المستخدم
ربط التطبيق. قد يكون هذا مقبولًا للتطبيقات التي تكون فيها الأذونات التي يتم منحهم
هي الشرط الأساسي الوحيد لعمل عملية الدمج.
يُرجى العلم أنّه قد يتم تشغيل نشاط الإعداد أكثر من مرة، على سبيل المثال إذا سحَب المستخدِم في وقت لاحق أذونات الوصول إلى تطبيقك ثم أعادها.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Plan for onboarding users\n\nMany apps have a custom onboarding flow such as feature education or asking user\nconsent. To enable Health Connect to launch your onboarding flow, add the\nfollowing to your manifest: \n\n \u003c!-- Required to support pre-Android 14 devices with APK Health Connect --\u003e\n \u003cactivity\n android:name=\".OnboardingActivity\"\n android:exported=\"true\"\n android:permission=\"com.google.android.apps.healthdata.permission.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"androidx.health.ACTION_SHOW_ONBOARDING\"/\u003e\n \u003c/intent-filter\u003e\n \u003c/activity\u003e\n \u003c!-- Required to support Android 14+ devices with platform Health Connect --\u003e\n \u003cactivity-alias\n android:name=\"UAndAboveOnboardingActivity\"\n android:exported=\"true\"\n android:targetActivity=\".OnboardingActivity\"\n android:permission=\"android.permission.health.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"android.health.connect.action.SHOW_ONBOARDING\" /\u003e\n \u003c/intent-filter\u003e\n \u003c/activity-alias\u003e\n\nUsers may initiate the connection to your app directly from the Health\nConnect app, rather than from within your app. If your app requires any\nadditional interaction beyond being granted permission to read or write data,\nprovide an onboarding activity.\n\nVersion support\n---------------\n\nTo support both pre-Android 14 and Android 14+ devices:\n\n- **Recommended approach:** Create a single onboarding activity that handles\n both scenarios. Use an activity alias, as shown in the example,to verify\n compatibility across Android versions.\n\n- **Alternative approach:** Export two separate activities,\n one for each Android version. This approach may lead to increased maintenance\n complexity.\n\nExported activity requirements\n------------------------------\n\nWhen a user attempts to connect your app to Health Connect, the exported\nactivity is launched. This activity must do the following:\n\n- Display any relevant user education such as explaining what data is written or read.\n- Ask the user to grant consent if required.\n- Make a permissions request to Health Connect.\n- Carry out any other application specific logic such as scheduling a periodic worker.\n- Once complete, allow the user to dismiss the activity.\n\nFor apps that *don't* export an onboarding activity, Health Connect instead\nbrings the user to the **Manage permissions** screen once the user attempts to\nconnect the app. This may be acceptable for apps where permissions being\ngranted is the only prerequisite for the integration to function.\n\nNote that the onboarding activity may be launched more than once, for example if\nthe user later revokes permissions to your app and then reconnects it."]]
