Quando novos recursos são adicionados à Conexão Saúde, os usuários nem sempre atualizam a versão do app. A API Feature Availability é uma maneira de verificar se um recurso do Conexão Saúde está disponível no dispositivo do usuário e decidir qual ação tomar.
Primeiros passos
A API Feature Availability compartilha a mesma dependência do SDK
Health Connect. 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")
}
Faça a verificação
A principal função para verificar a disponibilidade de recursos é 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
...
}
Para uma lista de todas as flags de recursos disponíveis, consulte a página de referência HealthConnectFeatures
.
Gerenciar a falta de disponibilidade de recursos
Se um recurso não estiver disponível no dispositivo de um usuário, uma atualização poderá ativá-lo. Você pode orientar o usuário a atualizar 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.