許多應用程式都有自訂的新手上路流程，例如向使用者說明應用程式功能，或徵詢使用者同意。如要建立無縫連結流程，應用程式也可以使用 Matchmaking API，提示使用者連結其他可寫入資料的應用程式，而您的應用程式已設定為讀取這些資料。
如要加入自訂新手上路流程，請設定「健康資料同步」，在授予權限後自動啟動該流程。不過請注意，Matchmaking API 不支援這項觸發條件。如要這麼做，請在資訊清單中新增下列內容：
<!-- 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>
使用者可以直接從「健康資料同步」應用程式啟動與您應用程式的連結，不必從您的應用程式啟動。
版本支援
如要同時支援 Android 14 之前的裝置和 Android 14 以上版本裝置，請按照下列步驟操作：
建議做法：建立單一的新手上路活動，同時處理這兩種情況。如範例所示，使用活動別名驗證 Android 版本之間的相容性。
替代做法：匯出兩個不同的活動，分別對應一個 Android 版本。這種做法可能會導致維護作業更加複雜。
匯出活動的規定
如果使用者嘗試將應用程式與「健康資料同步」連線，系統就會啟動匯出的活動。此活動必須要能符合以下條件：
- 顯示任何相關的使用者教學內容，例如說明會寫入或讀取哪些資料。
- 視情況徵詢使用者同意。
- 向健康資料同步提出權限要求。
- 執行任何其他應用程式專屬邏輯，例如安排週期性 worker。
- 流程結束後，允許使用者關閉活動。
對於「未」匯出新手上路活動的應用程式，健康資料同步會在使用嘗試連線應用程式時，改為將他們導向「管理權限」畫面。如果應用程式必須取得權限，整合項目才能正常運作，或許就可以採用上述做法。
請注意，新手上路活動可能會多次啟動，例如使用者之後撤銷授予應用程式的權限，然後又重新連結，就會發生此情況。