برای کاربران ورودی برنامه ریزی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
بسیاری از برنامه‌ها دارای یک جریان سفارشی ورود مانند آموزش ویژگی یا درخواست رضایت کاربر هستند. برای فعال کردن 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 و Android 14+:
رویکرد پیشنهادی: یک فعالیت ورودی واحد ایجاد کنید که هر دو سناریو را مدیریت کند. همانطور که در مثال نشان داده شده است، از یک نام مستعار فعالیت برای تأیید سازگاری در نسخه های Android استفاده کنید.
رویکرد جایگزین: دو فعالیت جداگانه را صادر کنید، یکی برای هر نسخه اندروید. این رویکرد ممکن است منجر به افزایش پیچیدگی تعمیر و نگهداری شود.
الزامات فعالیت صادراتی
هنگامی که کاربری سعی می کند برنامه شما را به Health Connect متصل کند، فعالیت صادر شده راه اندازی می شود. این فعالیت باید موارد زیر را انجام دهد:
- هر گونه آموزش مرتبط با کاربر را نمایش دهید، مانند توضیح داده های نوشته شده یا خوانده شده.
- از کاربر بخواهید در صورت نیاز رضایت بدهد.
- یک درخواست مجوز برای Health Connect انجام دهید.
- هر منطق خاص کاربردی دیگری مانند برنامه ریزی یک کارگر دوره ای را انجام دهید.
- پس از تکمیل، به کاربر اجازه دهید فعالیت را رد کند.
برای برنامه‌هایی که فعالیت ورودی را صادر نمی‌کنند ، Health Connect به‌جای آن کاربر را به صفحه مدیریت مجوزها پس از تلاش کاربر برای اتصال برنامه می‌آورد. این ممکن است برای برنامه‌هایی قابل قبول باشد که مجوزهای اعطا شده تنها پیش‌نیاز برای عملکرد یکپارچه‌سازی است.
توجه داشته باشید که فعالیت ورود ممکن است بیش از یک بار راه اندازی شود، برای مثال اگر کاربر بعداً مجوزهای برنامه شما را لغو کند و سپس آن را دوباره وصل کند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
