新手上路使用者規劃

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

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

許多應用程式都有自訂的新手上路流程，例如功能教學，或徵詢使用者同意。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.ACTION_SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

請注意，Android 14 尚未提供此功能的相關支援，但很快就會推出。

如果使用者嘗試將應用程式與 Health Connect 連線，系統就會啟動匯出的活動。此活動必須要能符合以下條件：

• 顯示任何相關的使用者教學內容，例如說明會寫入或讀取哪些資料。
• 視情況徵詢使用者同意。
• 向 Health Connect 提出權限要求。
• 執行任何其他應用程式專屬邏輯，例如安排週期性 worker。
• 完成後，請允許使用者關閉活動。

對於「未」匯出新手上路活動的應用程式，Health Connect 會在使用者嘗試連線應用程式時，改為將他們導向「管理權限」畫面。如果應用程式必須取得權限，整合項目才能正常運作，或許就可以採用上述做法。

請注意，新手上路活動可能會多次啟動，例如使用者之後撤銷授予應用程式的權限，然後又重新連結，就會發生此情況。