Recomendamos as orientações a seguir para integrar usuários ao app.
Integrar seu app
Muitos apps têm um fluxo de integração personalizado, como instruções sobre recursos ou pedidos de consentimento do usuário. Recomendamos que os desenvolvedores exportem uma atividade de integração que a Conexão Saúde inicia quando o usuário interage com o app pela primeira vez. Para fazer isso, adicione o seguinte ao manifesto:
<!-- 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>
O suporte para esse recurso ainda não está disponível para o Android 14, mas será lançado em breve.
Quando um usuário tentar conectar seu app à Conexão Saúde, a atividade exportada será iniciada. Essa atividade precisa fazer o seguinte:
- Mostrar todas as instruções relevantes ao usuário, como explicar quais dados são gravados ou lidos.
- Pedir o consentimento do usuário, se necessário.
- Fazer uma solicitação de permissão à Conexão Saúde.
- Realizar qualquer outra lógica específica do aplicativo, como agendar um worker periódico.
- Depois de concluída, permita que o usuário dispense a atividade.
Para apps que não exportam uma atividade de integração, a Conexão Saúde leva o usuário para a tela Gerenciar permissões quando ele tenta conectar o app. Isso pode ser aceitável para apps em que as permissões concedidas são o único pré-requisito para a integração funcionar.
A atividade de integração pode ser iniciada mais de uma vez, por exemplo, se o usuário revogar as permissões do app e depois reconectar.