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 la formazione sulle funzionalità o la richiesta del consenso dell'utente. Consigliamo vivamente agli sviluppatori di esportare un'attività di onboarding avviata da Connessione Salute quando l'utente interagisce con l'app 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, viene avviata l'attività esportata. Questa attività deve:
- Mostra qualsiasi istruzione pertinente per gli utenti, ad esempio spiegando quali dati sono scritti o legati.
- Chiedi all'utente di concedere il consenso, se necessario.
- Effettua una richiesta di autorizzazione a Connessione Salute.
- Eseguire qualsiasi altra logica specifica dell'applicazione, come la pianificazione di un worker periodico.
- Al termine, consenti all'utente di ignorare l'attività.
Per le app che non esportano un'attività di onboarding, Connessione Salute porta invece l'utente alla schermata Gestisci autorizzazioni dopo che l'utente tenta di connettere l'app. Questo può essere accettabile per le app in cui le autorizzazioni concesse sono 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 in seguito l'utente revoca le autorizzazioni alla tua app e poi la riconnette.