Migrationsanleitung

Google hat viele Gesundheitsprodukte und -dienstleistungen im Portfolio, darunter auch Health Connect. Die Google Fit Android API wurde eingestellt und wird bis Ende 2024 unterstützt. Danach wird sie eingestellt. Die folgenden Richtlinien geben Aufschluss darüber, zu welchen APIs oder Plattformen Sie von jeder Google Fit Android API migrieren sollten.

Sensor-API

Mit der Sensor API können Sie die Sensor-Rohdaten in Ihrer App in Echtzeit lesen. Die Sensor API bietet folgende Möglichkeiten:

  • Hier werden Datenquellen aufgeführt, die auf dem Gerät und auf Begleitgeräten verfügbar sind.
  • Registriert Listener für den Empfang von Sensorrohdaten
  • Hebt die Registrierung von Listenern auf, sodass sie keine Sensor-Rohdaten mehr erhalten.

Von der Sensor API zu den folgenden APIs oder Plattformen migrieren:

Telefon Kleidung

SensorManager, FusedLocationProvider verwenden

Gesundheitsdienste nutzen

  • PassiveMonitoringClient
  • MeasureClient
  • Übungsclient

    Oder verwenden Sie SensorManager, FusedLocationProvider

Session API

Sitzungen stellen ein Zeitintervall dar, in dem Nutzer eine Fitnessaktivität durchführen.

Mit der Session API kann deine App Sitzungen im Fitness-Store erstellen.

Von der Session API zu den folgenden APIs oder Plattformen migrieren:

Telefon Kleidung

Start/Stopp: Nicht zutreffend. Die Anwendung sollte den Status laufender Sitzungen intern verfolgen.

Lesen/Schreiben: Health Connect verwenden.

Start/Stopp: Gesundheitsdienste verwenden (TrainingClient)

Lesen/Schreiben: Verwenden Sie Health Connect über die mobile App.

Für bestimmte Workflows empfehlen wir Folgendes:

  • Sitzung einfügen: Entwickler sollten Health Connect verwenden und entweder einen ActivitySession-Eintrag oder einen SleepSession-Eintrag einfügen.

    • Aufzeichnungs-API

    Mit der Recording API kann Ihre App über Abos eine automatisierte Speicherung von Sensordaten anfordern, die den Akku schonen. Ein Abo ist mit einer Android-App verknüpft und besteht aus einem Fitnessdatentyp oder einer bestimmten Datenquelle.

    Von der Recording API zu den folgenden APIs oder Plattformen migrieren:

    Telefon Kleidung

    So migrieren Sie von der Recording API:

    1. Implementieren Sie die Datenerfassung mit SensorManager.
    2. Aufgezeichnete Daten in Health Connect schreiben.
    3. Kombinieren Sie die Schritte a und b gegebenenfalls in einem Dienst im Vordergrund, z. B. wenn Sie weiter Daten aufzeichnen möchten, ohne mit der App selbst zu interagieren.

    Gesundheitsdienste nutzen

    • PassiveMonitoringClient
    • Übungsclient

      Weitere Informationen zu den Unterschieden zwischen dem PassiveMonitoringClient und dem Übungsclient finden Sie in der Dokumentation zu den Gesundheitsdiensten.

    History API

    Mit der Verlaufs-API kann deine App Bulk-Vorgänge im Fitness-Store ausführen, z. B. bisherige Gesundheits- und Fitnessdaten lesen, einfügen, aktualisieren und löschen.

    Von der History API zu den folgenden APIs oder Plattformen migrieren:

    Telefon Kleidung

    Health Connect verwenden

    Nutze Health Connect über die mobile App und nicht über das Wearable.

    Zielvorhaben-API

    Ziele sind Ziele in der Google Fit App, die Nutzer selbst festlegen können. Sie motivieren Nutzende, jeden Tag aktiv zu bleiben. Über ihr Profil können Nutzer anpassen, wie viele Schritte und Kardiopunkte sie pro Tag anstreben möchten. Die Fit-Plattform zeichnet mithilfe der Goals API ihre Ziele auf und verfolgt ihre täglichen Aktivitäten anhand dieser Ziele.

    Telefon Kleidung
    Keine Ersatz-API verfügbar. Keine Ersatz-API verfügbar.

    BLE-API

    Ihre App kann verfügbare BLE-Geräte (Bluetooth Low Energy) finden und Sensordaten mithilfe der BLE API in die Google Fit-Plattform einfügen.

    Von der BLE API zu den folgenden APIs oder Plattformen migrieren:

    Telefon Kleidung
    Android Bluetooth APIs direkt verwenden Android Bluetooth APIs direkt verwenden

    Von der Fit Android API zur Health Connect API migrieren

    Für die Migration zur Health Connect API sind 3 wichtige Schritte erforderlich.

    Schritt 1: Integration

    Der erste Schritt zur Integration besteht darin, Health Connect zu deiner App hinzuzufügen. Das umfasst Folgendes:

    • Führe die hier beschriebenen Schritte aus, um eine Verknüpfung mit Health Connect herzustellen.
    • Deklarieren Sie Datentypen und den Zugriffsmodus, die im App-Manifest erforderlich sind.
    • Hole dir die Berechtigung des Nutzers für den Zugriff auf Health Connect.
    • Daten gemäß Ihren spezifischen Anwendungsfällen oder Workflows lesen/schreiben

    Schritt 2: Migrieren

    Wir empfehlen, sowohl die Google Fit Android API- als auch die Health Connect API-Integrationen aktiv zu lassen, während Nutzer von einer Plattform zur anderen migrieren. Auch wenn die Fit Android API eingestellt wurde, versuchen wir, die API frühestens Ende 2024 einzustellen. So haben Nutzer genug Zeit, zu Health Connect zu wechseln und den Dienst weiter zu nutzen.

    Schritt 3: Bereinigen

    So entfernen Sie das Fit SDK:

    1. Entfernen Sie den mit der Fit Android API verbundenen Code.
    2. Entfernen Sie Abhängigkeiten.

    Der Zeitpunkt der Einstellung der Fit Android API sollte von Ihren eigenen Analysen und Bewertungen abhängen. Die Integration mit der Fit Android API kann bis Ende 2024 aufrechterhalten werden.