برای کاربران ورودی برنامه ریزی کنید

بسیاری از برنامه‌ها دارای یک جریان سفارشی ورود مانند آموزش ویژگی یا درخواست رضایت کاربر هستند. برای فعال کردن 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 به‌جای آن کاربر را به صفحه مدیریت مجوزها پس از تلاش کاربر برای اتصال برنامه می‌آورد. این ممکن است برای برنامه‌هایی قابل قبول باشد که مجوزهای اعطا شده تنها پیش‌نیاز برای عملکرد یکپارچه‌سازی است.

توجه داشته باشید که فعالیت ورود ممکن است بیش از یک بار راه اندازی شود، برای مثال اگر کاربر بعداً مجوزهای برنامه شما را لغو کند و سپس آن را دوباره وصل کند.