Te recomendamos la siguiente guía para incorporar usuarios a tu app.
Integra tu app
Muchas apps tienen un flujo de integración personalizado, como la educación sobre funciones o la solicitud del consentimiento del usuario. Se recomienda que los desarrolladores exporten una actividad de integración que Health Connect pueda iniciar cuando el usuario interactúe con la app por primera vez. 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.ACTION_SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Ten en cuenta que la compatibilidad con esta función aún no está disponible para Android 14, pero lo estará pronto.
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.