新手上路使用者規劃

許多應用程式都有自訂的新手上路流程，例如功能教學，或徵詢使用者同意。如要讓 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 版本的相容性。

  • 其他方法：匯出兩個個別活動，每個 Android 版本一個。這種做法可能會導致維護作業更加複雜。

匯出活動的必要條件

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

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

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

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