Verificare la disponibilità delle funzionalità

Quando vengono aggiunte nuove funzionalità a Connessione Salute, gli utenti potrebbero non aggiornare sempre la loro versione di Connessione Salute. L'API Feature Availability consente di verificare se una funzionalità di Connessione Salute è disponibile sul dispositivo dell'utente e di decidere quale azione intraprendere.

Inizia

L'API Feature Availability condivide la stessa dipendenza dell'SDK Health Connect. Per iniziare, verifica che nel file build.gradle sia presente almeno la versione 1.1.0-alpha08:

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

Esegui il controllo

La funzione principale per verificare la disponibilità delle funzionalità è getFeatureStatus(). Restituisce le costanti intere FEATURE_STATUS_AVAILABLE o 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
  ...
}

Gestire la mancanza di disponibilità delle funzionalità

Se una funzionalità non è disponibile sul dispositivo di un utente, un aggiornamento potrebbe attivarla. Puoi valutare l'idea di invitare l'utente ad aggiornare Connessione Salute se non ha la versione più recente supportata sul suo dispositivo. Tuttavia, gli utenti che utilizzano l'APK (su Android 13 e versioni precedenti) non possono utilizzare le funzionalità del modulo di sistema che sono disponibili solo su dispositivi con Android 14 o versioni successive.