新手上路使用者規劃

建議您按照下列指南引導使用者使用您的應用程式。

匯出應用程式新手上路活動

許多應用程式都有自訂的新手上路流程，例如功能教學或詢問使用者 同意。我們強烈建議開發人員匯出新手上路活動 每當使用者與應用程式互動時，Health Connect 就會啟動 一切都是從 0 開始方法是在資訊清單中新增以下內容：

<!-- 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 提出權限要求。
• 執行任何其他應用程式專屬邏輯，例如安排定期執行 工作站
• 完成後，請允許使用者關閉活動。

如果應用程式「未」匯出新手上路活動，請改為使用 Health Connect 當使用者嘗試執行以下動作時，會前往管理權限畫面 連結應用程式。如果應用程式具備相關權限 是讓整合正常運作的唯一先決條件。

請注意，新手上路活動可能會多次啟動， 使用者之後會撤銷應用程式權限，然後再重新連結應用程式。