Verificar a disponibilidade do recurso

Quando novos recursos são adicionados à Conexão Saúde, os usuários nem sempre atualizam a versão. A API Feature Disponibilidade é uma maneira de verificar se um recurso da Conexão Saúde está disponível no dispositivo do usuário e decidir qual ação realizar.

Primeiros passos

A API Feature Disponibilização compartilha a mesma dependência que o SDK da Conexão Saúde. Para começar, verifique se pelo menos a versão 1.1.0-alpha08 está no arquivo build.gradle:

dependencies {
  implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}

Fazer a verificação

A função principal para verificar a disponibilidade do recurso é getFeatureStatus(). Isso retorna as constantes inteiras FEATURE_STATUS_AVAILABLE ou FEATURE_STATUS_UNAVAILABLE:

if (healthConnectClient
     .features
     .getFeatureStatus(
       HealthConnectFeatures.FEATURE_READ_HEALTH_DATA_IN_BACKGROUND
     ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {

  // Feature is available
  ...
} else {
  // Feature is not available
  ...
}

Gerenciar a falta de disponibilidade de recursos

Se um recurso não estiver disponível no dispositivo de um usuário, ele poderá ser ativado por uma atualização. Você pode pedir que o usuário atualize o app Conexão Saúde se ele não tiver a versão mais recente compatível no dispositivo. No entanto, os usuários que usam o APK (no Android 13 e versões anteriores) não podem usar os recursos do módulo do sistema que estão disponíveis apenas em dispositivos com o Android 14 ou mais recente.