计划用户 onboarding

我们建议您遵循以下指南将用户 onboarding 到您的应用程序。

Onboard 您的应用程序

许多应用程序都有自定义的 onboarding 流程，例如功能教育或询问用户同意。强烈建议开发人员导出 Health Connect 在用户首次与应用程序交互时启动的 onboarding 活动。为此，请在您的清单中添加以下内容

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

请注意，此功能的支持尚未在 Android 14 中提供，但即将推出。

当用户尝试将您的应用程序连接到 Health Connect 时，将启动导出的活动。此活动必须执行以下操作

• 显示任何相关的用户教育，例如解释写入或读取的数据。
• 如果需要，请要求用户授予同意。
• 向 Health Connect 发出权限请求。
• 执行任何其他特定于应用程序的逻辑，例如调度定期工作程序。
• 完成后，允许用户关闭活动。

对于不导出 onboarding 活动的应用程序，Health Connect 将在用户尝试连接应用程序后将用户带到管理权限屏幕。对于权限授予是集成正常运行的唯一先决条件的应用程序，这可能是可以接受的。

请注意，onboarding 活动可能会启动多次，例如，如果用户随后撤销对您的应用程序的权限，然后重新连接。