Nous vous recommandons de suivre les conseils suivants pour intégrer les utilisateurs dans votre application.
Intégrer votre application
De nombreuses applications disposent d'un processus d'acceptation personnalisé proposant une formation aux fonctionnalités ou demandant le consentement de l'utilisateur, par exemple. Nous recommandons vivement aux développeurs d'exporter une activité d'acceptation lancée par Santé Connect lorsque l'utilisateur interagit avec l'application pour la première fois. Pour ce faire, ajoutez le code suivant à votre fichier manifeste :
<!-- 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>
Veuillez noter que cette fonctionnalité n'est pas encore disponible pour Android 14, mais elle le sera bientôt.
Lorsqu'un utilisateur tente de connecter votre application à Santé Connect, l'activité exportée est lancée. Cette activité doit effectuer les opérations suivantes :
- Présenter toute information pertinente à l'utilisateur, par exemple en expliquant quelles données sont écrites ou lues
- Demander à l'utilisateur d'accorder son consentement si nécessaire
- Envoyer une demande d'autorisation à Santé Connect
- Exécuter toute autre logique spécifique à l'application, telle que la planification d'un worker périodique
- Autoriser l'utilisateur à ignorer l'activité à la fin
Pour les applications qui n'exportent pas d'activité d'acceptation, Santé Connect redirige l'utilisateur vers l'écran Manage permissions (Gérer les autorisations) une fois qu'il tente de connecter l'application. Cela peut être acceptable pour les applications pour lesquelles les autorisations sont la seule condition préalable au fonctionnement de l'intégration.
Notez que l'activité d'acceptation peut être lancée plusieurs fois, par exemple si l'utilisateur révoque ultérieurement des autorisations pour votre application, puis la reconnecte.