Planifier l'intégration des utilisateurs

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. Pour permettre à Santé Connect de lancer votre parcours d'intégration, ajoutez les éléments suivants à 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.SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

Les utilisateurs peuvent établir la connexion à votre application directement depuis l'application Santé Connect, plutôt que depuis votre application. Si votre application nécessite une interaction supplémentaire en plus de l'autorisation de lire ou d'écrire des données, fournissez une activité d'acceptation.

Compatibilité avec les versions

Pour prendre en charge les appareils Android 14 et versions antérieures, procédez comme suit:

  • Approche recommandée:créez une seule activité d'intégration qui gère les deux scénarios. Utilisez un alias d'activité, comme indiqué dans l'exemple,pour vérifier la compatibilité entre les versions d'Android.

  • Autre approche:exportez deux activités distinctes, une pour chaque version d'Android. Cette approche peut augmenter la complexité de la maintenance.

Exigences concernant les activités exportées

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.