为新用户制定计划

我们建议您按照以下指南引导用户使用您的应用。

为应用配置新用户引导流程

许多应用都有自定义的新用户引导流程，例如功能教程或征求用户同意。我们强烈建议开发者，将用户首次与 Health Connect 应用互动时该应用会启动的新用户引导 activity 导出来。为此，请在清单中添加以下代码：

<!-- 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 时，系统会启动导出的 activity。此 activity 必须执行以下操作：

• 显示任何相关的用户教程，例如说明系统会写入或读取哪些数据。
• 视需要征求用户同意。
• 向 Health Connect 发出权限请求。
• 执行任何其他特定于应用的逻辑，例如调度一项定期 worker。
• 完成后，允许用户关闭此 activity。

对于不导出初始配置 activity 的应用，Health Connect 会在用户尝试关联应用后将用户转到管理权限界面。对于那些授予了权限是确保集成正常运行的唯一前提条件的应用，这种做法可能是可以接受的。

请注意，新用户引导 activity 可能会多次启动，例如，如果用户之后撤消了应用的权限，然后重新连接了该应用。