Erste Schritte mit Android

In diesem Leitfaden erfahren Sie, wie Sie mit der Entwicklung von Google Fit unter Android beginnen.

Hinweis :Google Fit ist Teil der Google Play-Dienste. Hier erfahren Sie mehr über die Vorteile Ihrer App durch die Verwendung von Google Play-Diensten.

Einrichtung

Bevor Sie mit dem Erstellen Ihrer Anwendung beginnen, führen Sie die Schritte in den folgenden Abschnitten aus.

Erstellen Sie sich ein Google-Konto

Sie benötigen ein Google-Konto, um die Google Fit APIs verwenden zu können. Sie können ein neues Konto erstellen oder ein vorhandenes verwenden. Sie können ein separates Konto erstellen, um Ihre Anwendung aus Sicht eines Nutzers zu testen.

Google Play-Dienste installieren

Laden Sie die aktuelle Clientbibliothek für Google Play-Dienste auf Ihrem Entwicklungshost herunter:

1. Öffnen Sie den Android SDK Manager.
2. Suchen Sie unter SDK-Tools nach Google Play-Dienste.
3. Wenn der Status für diese Pakete nicht Installiert ist, wählen Sie beide aus und klicken Sie auf Pakete installieren.

OAuth 2.0-Client-ID abrufen

Rufen Sie eine OAuth 2.0-Client-ID ab, um die Fitness API zu aktivieren.

Projekt erstellen und konfigurieren

Wir empfehlen die Verwendung der Android Studio-Entwicklungsumgebung, um eine App mit der Fitness API zu erstellen. Wie Sie ein neues Projekt erstellen und in Android Studio konfigurieren, erfahren Sie unter Projekt erstellen.

Clientbibliothek für Google Play-Dienste hinzufügen

Öffnen Sie in Android Studio die Datei build.gradle für Ihr Modul und fügen Sie die Clientbibliothek der Google Play-Dienste als Abhängigkeit hinzu:

Kotlin-DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.2.0'
}

Dadurch wird sichergestellt, dass Gradle das Fitness SDK automatisch herunterlädt, wenn es Ihre App erstellt.

Anwendung erstellen und testen

Nachdem Sie die Einrichtungsschritte abgeschlossen haben, können Sie mit dem Erstellen Ihrer Anwendung beginnen. Informieren Sie sich zuerst über die Datentypen, die Ihre App speichern und lesen kann. Weitere Informationen zum Arbeiten mit Daten in Google Fit

Erforderliche Android-Berechtigungen erhalten

Zum Lesen und Schreiben bestimmter Datentypen muss Ihre App Android-Berechtigungen anfordern.

OAuth-Berechtigungen erhalten

Die Datentypen, auf die Ihre App zugreifen darf, entsprechen den Autorisierungsbereichen. Wenn Sie nach diesen Berechtigungen fragen möchten, müssen Sie hinzufügen, auf welche Datentypen Ihre Anwendung in einer FitnessOptions-Instanz zugreifen muss. Wenn Ihre App anfordert, einen der Google Fit-Datentypen zu verwenden, prüft das Android SDK automatisch, zu welchen Bereichen sie gehören, und fordert den Nutzer auf, diese Bereiche zu autorisieren.

API-Client erstellen

Erstellen Sie einen API-Client und fügen Sie die Datentypen hinzu, auf die die Anwendung zugreifen muss, um Daten zu schreiben oder zu lesen. Die folgenden Endpunkte sind verfügbar:

• SensorsClient: Über Hardwaresensoren des lokalen Geräts und von Begleitgeräten lassen sich verschiedene Quellen für Gesundheits- und Fitnessdaten abrufen.
• RecordingClient: Für die energiesparende, durchgängig aktive Erfassung von Sensordaten im Hintergrund.
• HistoryClient: Verlaufsdaten in Google Fit einfügen, löschen und lesen.
• SessionsClient: Hiermit können Sie Sitzungen mit Nutzeraktivitäten erstellen und verwalten.
• GoalsClient: Hier können Sie die von Nutzern in Google Fit erstellten Kardiopunkte und Schritte lesen.
• ConfigClient: Hier können Sie auf benutzerdefinierte Datentypen und Einstellungen in der Google Fit-Plattform zugreifen.

Beispiel für die Erstellung eines Fitness API-Clients

Daraus resultierender Nutzerautorisierungsvorgang

Im Folgenden wird der Autorisierungsablauf dargestellt, den Nutzer ausführen, wenn sie nach Berechtigungen gefragt werden:

Abbildung 1: Autorisierungsablauf für Nutzer

1. Android-Berechtigungen: Nutzer können vor dem Herunterladen der App sehen, welche Android-Berechtigungen Ihre App angefordert hat. Nachdem Ihre App heruntergeladen wurde, fordert sie alle erforderlichen Laufzeitberechtigungen an und Nutzer gewähren oder lehnen diese Berechtigungen ab.
2. Prüfen und verbinden: Ihre App prüft, ob Berechtigungen erteilt wurden, bevor Zugriff auf andere Datentypen angefordert wird.
3. OAuth-Bereiche-Anfrage: Google fordert den Nutzer auf, Ihrer Anwendung die OAuth-Bereiche zu gewähren, die für die Datentypen erforderlich sind, auf die zugegriffen werden soll.
4. Zugriff angewendet: Nachdem der Nutzer Berechtigungen gewährt hat, kann Ihre Anwendung auf die Datentypen zugreifen, die zu den Bereichen gehören, für die der Nutzer die Berechtigung erteilt hat.

Überprüfung beantragen

Nachdem Sie Ihre Anwendung erstellt und getestet haben, müssen Sie eine Überprüfung beantragen und dabei verschiedene Begründungen für sensible und eingeschränkte Bereiche angeben.