Piano per l'onboarding degli utenti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Molte app hanno un flusso di onboarding personalizzato, ad esempio informazioni sulle funzionalità o richiesta del consenso dell'utente. Per consentire a Connessione Salute di avviare il flusso di onboarding, aggiungi quanto segue al 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.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. Se la tua app richiede un'interazione aggiuntiva oltre alla concessione dell'autorizzazione per leggere o scrivere dati, fornisci un'attività di onboarding.
Supporto delle versioni
Per supportare sia i dispositivi precedenti ad 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 attività, come mostrato nell'esempio,per verificare la compatibilità tra le versioni di Android.
Approccio alternativo:esporta due attività distinte,
una per ogni versione di Android. Questo approccio potrebbe comportare un aumento della complessità della manutenzione.
Requisiti per le attività esportate
Quando un utente tenta di collegare la tua app a Connessione Salute, viene avviata l'attività esportata. Questa attività deve:
- Mostrare informazioni pertinenti per gli utenti, ad esempio spiegare quali dati vengono scritti oletti.
- Se necessario, chiedi all'utente di concedere il consenso.
- Invia una richiesta di autorizzazione a Connessione Salute.
- Esegui qualsiasi altra logica specifica dell'applicazione, ad esempio 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 indirizza l'utente alla schermata Gestisci autorizzazioni quando l'utente tenta di collegare l'app. Questo potrebbe 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 può essere avviata più volte, ad esempio se l'utente in un secondo momento revoca le autorizzazioni per la tua app e poi la ricollega.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-27 UTC."],[],[],null,["# Plan for onboarding users\n\nMany apps have a custom onboarding flow such as feature education or asking user\nconsent. To enable Health Connect to launch your onboarding flow, add the\nfollowing to your manifest: \n\n \u003c!-- Required to support pre-Android 14 devices with APK Health Connect --\u003e\n \u003cactivity\n android:name=\".OnboardingActivity\"\n android:exported=\"true\"\n android:permission=\"com.google.android.apps.healthdata.permission.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"androidx.health.ACTION_SHOW_ONBOARDING\"/\u003e\n \u003c/intent-filter\u003e\n \u003c/activity\u003e\n \u003c!-- Required to support Android 14+ devices with platform Health Connect --\u003e\n \u003cactivity-alias\n android:name=\"UAndAboveOnboardingActivity\"\n android:exported=\"true\"\n android:targetActivity=\".OnboardingActivity\"\n android:permission=\"android.permission.health.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"android.health.connect.action.SHOW_ONBOARDING\" /\u003e\n \u003c/intent-filter\u003e\n \u003c/activity-alias\u003e\n\nUsers may initiate the connection to your app directly from the Health\nConnect app, rather than from within your app. If your app requires any\nadditional interaction beyond being granted permission to read or write data,\nprovide an onboarding activity.\n\nVersion support\n---------------\n\nTo support both pre-Android 14 and Android 14+ devices:\n\n- **Recommended approach:** Create a single onboarding activity that handles\n both scenarios. Use an activity alias, as shown in the example,to verify\n compatibility across Android versions.\n\n- **Alternative approach:** Export two separate activities,\n one for each Android version. This approach may lead to increased maintenance\n complexity.\n\nExported activity requirements\n------------------------------\n\nWhen a user attempts to connect your app to Health Connect, the exported\nactivity is launched. This activity must do the following:\n\n- Display any relevant user education such as explaining what data is written or read.\n- Ask the user to grant consent if required.\n- Make a permissions request to Health Connect.\n- Carry out any other application specific logic such as scheduling a periodic worker.\n- Once complete, allow the user to dismiss the activity.\n\nFor apps that *don't* export an onboarding activity, Health Connect instead\nbrings the user to the **Manage permissions** screen once the user attempts to\nconnect the app. This may be acceptable for apps where permissions being\ngranted is the only prerequisite for the integration to function.\n\nNote that the onboarding activity may be launched more than once, for example if\nthe user later revokes permissions to your app and then reconnects it."]]
