Planejar a integração de usuários

Muitos apps têm um fluxo de integração personalizado, como instruções sobre recursos ou pedidos de consentimento do usuário. Para permitir que a Conexão Saúde inicie seu fluxo de integração, 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 do app Conexão Saúde, em vez de dentro do seu app. Se o app exigir qualquer interação além da permissão para ler ou gravar dados, forneça uma atividade de integração.

Compatibilidade de versão

Para oferecer suporte a dispositivos Android 14 e versões mais recentes:

  • Abordagem recomendada:crie uma única atividade de integração que lide com ambos os 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 aumentar a complexidade da manutenção.

Requisitos de atividades exportadas

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.