Molte app hanno un flusso di onboarding personalizzato per workflow come l'informazione dell'utente sulle funzionalità dell'app o la richiesta del consenso dell'utente. Per creare un flusso di connessione senza interruzioni, la tua app può anche utilizzare l'API Matchmaking per chiedere agli utenti di connettere altre app che possono scrivere dati che la tua app è configurata per leggere.
Per includere un flusso di onboarding personalizzato, configura Health Connect in modo che venga avviato automaticamente dopo la concessione delle autorizzazioni. Tieni presente, tuttavia, che l'API Matchmaking non supporta questo trigger. Per farlo, aggiungi quanto segue al manifest:
<!-- 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>
Gli utenti possono avviare la connessione alla tua app direttamente dall'app Connessione Salute, anziché dall'interno della tua app.
Supporto delle versioni
Per supportare sia i dispositivi con versioni precedenti di Android 14 sia quelli con Android 14 e versioni successive:
Approccio consigliato: crea una singola attività di onboarding che gestisca entrambi gli scenari. Utilizza un alias di attività, come mostrato nell'esempio,per verificare la compatibilità tra le versioni di Android.
Approccio alternativo:esporta due attività separate, una per ogni versione di Android. Questo approccio potrebbe aumentare la complessità della manutenzione.
Requisiti per l'attività esportata
Quando un utente tenta di connettere la tua app a Health Connect, viene avviata l'attività esportata. Questa attività deve:
- Mostra qualsiasi informazione pertinente per l'utente, ad esempio spiegando quali dati vengono scritti o letti.
- Chiedi all'utente di concedere il consenso, se necessario.
- Invia una richiesta di autorizzazioni a Health Connect.
- Esegui qualsiasi altra logica specifica dell'applicazione, ad esempio la pianificazione di un worker periodico.
- Una volta completata, consenti all'utente di chiudere l'attività.
Per le app che non esportano un'attività di onboarding, Health Connect porta l'utente alla schermata Gestisci autorizzazioni quando tenta di connettere l'app. Questa soluzione potrebbe essere accettabile per le app in cui la concessione delle autorizzazioni è l'unico prerequisito per il funzionamento dell'integrazione.
Tieni presente che l'attività di onboarding potrebbe essere avviata più di una volta, ad esempio se l'utente revoca in un secondo momento le autorizzazioni per la tua app e poi la ricollega.