Muchas apps tienen un flujo de integración personalizado para flujos de trabajo, como educar al usuario sobre las funciones de la app o solicitar su consentimiento. Para crear un flujo de conexión sin problemas, tu app también puede usar la API de Matchmaking para solicitar a los usuarios que conecten otras apps que puedan escribir datos que tu app esté configurada para leer.
Para incluir un flujo de integración personalizado, configura Health Connect para que se inicie automáticamente después de que se otorguen los permisos. Sin embargo, ten en cuenta que la API de Matchmaking no admite este activador. Para ello, agrega lo siguiente en tu manifiesto:
<!-- 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>
Los usuarios pueden iniciar la conexión a tu app directamente desde la app de Health Connect, en lugar de hacerlo desde tu app.
Compatibilidad con las versiones
Para admitir dispositivos anteriores a Android 14 y Android 14+:
Enfoque recomendado: Crea una sola actividad de integración que controle ambos casos. Usa un alias de actividad, como se muestra en el ejemplo,para verificar la compatibilidad en todas las versiones de Android.
Enfoque alternativo: Exporta dos actividades separadas, una para cada versión de Android. Este enfoque puede aumentar la complejidad del mantenimiento.
Requisitos de la actividad exportada
Cuando un usuario intenta conectar tu app con Health Connect, se inicia la actividad exportada. Esta actividad debe hacer lo siguiente:
- Mostrar la educación de usuario relevante, como explicar qué datos se escriben o leen
- Pedir al usuario que otorgue consentimiento si es necesario
- Enviar una solicitud de permisos a Health Connect
- Llevar a cabo cualquier otra lógica específica de la aplicación, como programar un trabajador periódico
- Permitir que el usuario descarte la actividad una vez completada
En el caso de las apps que no exportan una actividad de integración, Health Connect lleva al usuario a la pantalla Administrar permisos una vez que intenta conectar la app. Esto puede ser aceptable para las apps en las que los permisos que se otorgan son el único requisito previo para que funcione la integración.
Ten en cuenta que la actividad de integración puede iniciarse más de una vez, por ejemplo, si el usuario revoca permisos a tu app y la vuelve a conectar más adelante.