Verfügbarkeit von Funktionen prüfen

Wenn Health Connect neue Funktionen hinzugefügt werden, aktualisieren Nutzer ihre Version von Health Connect möglicherweise nicht immer. Mit der Feature Availability API können Sie prüfen, ob eine Funktion in Health Connect auf dem Gerät Ihres Nutzers verfügbar ist, und entscheiden, welche Aktion ausgeführt werden soll.

Erste Schritte

Die Feature Availability API hat dieselbe Abhängigkeit wie das Health Connect SDK. Prüfen Sie zuerst, ob in der Datei build.gradle mindestens Version 1.1.0-alpha08 enthalten ist:

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

Prüfung durchführen

Die Hauptfunktion zur Überprüfung der Verfügbarkeit von Funktionen ist getFeatureStatus(). Dies gibt die Ganzzahlkonstanten FEATURE_STATUS_AVAILABLE oder FEATURE_STATUS_UNAVAILABLE zurück:

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

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

Umgang mit fehlenden Funktionen

Wenn eine Funktion auf dem Gerät eines Nutzers nicht verfügbar ist, kann sie durch ein Update aktiviert werden. Sie können den Nutzer auffordern, Health Connect zu aktualisieren, wenn er nicht die neueste unterstützte Version auf seinem Gerät hat. Nutzer, die das APK verwenden (unter Android 13), können jedoch nicht die Funktionen des Systemmoduls nutzen, die nur auf Geräten mit Android 14 oder höher verfügbar sind.