Muitos apps têm um fluxo de integração personalizado para fluxos de trabalho, como instruir o usuário sobre os recursos do app ou pedir o consentimento do usuário. Para criar um fluxo de conexão contínuo, seu app também pode usar a API Matchmaking para pedir aos usuários que conectem outros apps que podem gravar dados que seu app está configurado para ler.
Para incluir um fluxo de integração personalizado, configure a Conexão Saúde para iniciá-lo automaticamente depois que as permissões forem concedidas. No entanto, a API Matchmaking não oferece suporte a esse acionador. 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.SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Os usuários podem iniciar a conexão com seu app diretamente pelo app Conexão Saúde, em vez de dentro do seu app.
Compatibilidade das versões
Para oferecer suporte a dispositivos pré-Android 14 e Android 14 ou mais recentes:
Abordagem recomendada:crie uma única atividade de integração que processe os dois cenários. Use um alias de atividade, conforme mostrado no exemplo,para verificar a compatibilidade entre as versões do Android.
Abordagem alternativa:exporte duas atividades separadas, uma para cada versão do Android. Essa abordagem pode levar a uma maior complexidade de manutenção.
Requisitos de atividade exportada
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.