Planifica la integración de usuarios
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muchas apps tienen un flujo de integración personalizado, como la educación sobre funciones o la solicitud del consentimiento del usuario. Para permitir que Health Connect inicie tu flujo de integración, agrega lo siguiente a 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. Si tu app requiere alguna interacción adicional más allá de otorgarle permiso para leer o escribir datos, proporciona una actividad de integración.
Compatibilidad con las versiones
Para admitir dispositivos anteriores a Android 14 y dispositivos con Android 14 y versiones posteriores, haz lo siguiente:
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 independientes, 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.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
