Ti consigliamo le seguenti indicazioni per introdurre gli utenti nella tua app.
Eseguire l'onboarding dell'app
Molte app prevedono un flusso di onboarding personalizzato, ad esempio informazioni sulle funzionalità o richieste all'utente consenso. Consigliamo vivamente agli sviluppatori di esportare un'attività di onboarding che Connessione Salute avvia quando l'utente interagisce con l'app per il per la prima volta. Per farlo, aggiungi quanto segue nel file 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.ACTION_SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Tieni presente che il supporto per questa funzionalità non è ancora disponibile per Android 14. ma lo sarà a breve.
Quando un utente tenta di connettere la tua app a Connessione Salute, l'esportazione viene avviata l'attività. Questa attività deve:
- Mostrare qualsiasi istruzione pertinente per gli utenti, ad esempio spiegare quali dati sono scritti o lette.
- Chiedi all'utente di concedere il consenso, se necessario.
- Effettua una richiesta di autorizzazione a Connessione Salute.
- Eseguire qualsiasi altra logica specifica per l'applicazione, ad esempio pianificare una verifica periodica worker.
- Al termine, consenti all'utente di ignorare l'attività.
Per le app che non esportano un'attività di onboarding, Connessione Salute è invece visualizza la schermata Gestisci autorizzazioni quando l'utente tenta di connettere l'app. Questo potrebbe essere accettabile per le app in cui le autorizzazioni sono è l'unico prerequisito per il funzionamento dell'integrazione.
Tieni presente che l'attività di onboarding può essere lanciata più di una volta, ad esempio se l'utente revoca in un secondo momento le autorizzazioni per la tua app e poi la riconnette.