Erste Schritte mit Android

In diesem Leitfaden wird erläutert, wie Sie mit der Entwicklung mit Google Fit auf Android-Geräten beginnen.

Hinweis :Google Fit ist Teil der Google Play-Dienste. Weitere Informationen zu den Vorteilen der Verwendung von Google Play-Diensten für Ihre App

Einrichtung

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

Erstellen Sie sich ein Google-Konto

Für die Verwendung der Google Fit APIs benötigen Sie ein Google-Konto. Sie können ein neues Konto erstellen oder ein vorhandenes Konto verwenden. Sie können ein separates Konto erstellen, um Ihre App aus der Perspektive eines Nutzers zu testen.

Google Play-Dienste installieren

Rufen Sie die aktuelle Clientbibliothek für Google Play-Dienste auf Ihrem Entwicklungshost ab:

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

OAuth 2.0-Client-ID abrufen

Wenn du die Fitness API aktivieren möchtest, erforderliche OAuth 2.0-Client-ID abrufen.

Projekt erstellen und konfigurieren

Wir empfehlen die Verwendung der Android Studio-Entwicklungsumgebung, um eine App mit der Fitness API zu erstellen. Weitere Informationen zum Erstellen eines neuen Projekts und zum Konfigurieren in Android Studio finden 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.3.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.3.0'
}

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

App erstellen und testen

Nachdem Sie die Einrichtungsschritte abgeschlossen haben, können Sie mit dem Erstellen Ihrer App 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 abrufen

Wenn Ihre App bestimmte Datentypen lesen und schreiben soll, muss sie Android-Berechtigungen anfordern.

OAuth-Berechtigungen abrufen

Die Datentypen, auf die Ihre App zugreifen darf, entsprechen Autorisierungsbereichen. Wenn Sie diese Berechtigungen anfordern möchten, müssen Sie in einer FitnessOptions-Instanz angeben, auf welche Datentypen Ihre App zugreifen muss. Wenn Ihre App die Verwendung eines der Google Fit-Datentypen anfordert, prüft das Android SDK automatisch, zu welchen Bereichen sie gehören, und fragt den Nutzer um Autorisierung für diese Bereiche.

API-Client erstellen

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

• SensorsClient: Zugriff auf verschiedene Quellen von Gesundheits- und Fitnessdaten von Hardwaresensoren auf dem lokalen Gerät und auf verbundenen Geräten.
• RecordingClient: Für die ständige Erfassung von Sensordaten im Hintergrund mit geringem Energieverbrauch.
• HistoryClient: Hiermit können Sie Verlaufsdaten in Google Fit einfügen, löschen und lesen.
• SessionsClient: Hier können Sie Sitzungen mit Nutzeraktivitäten erstellen und verwalten.
• GoalsClient: Liest Kardiopunkte- und Schrittziele aus, die von Nutzern in Google Fit erstellt wurden.
• ConfigClient: Zugriff auf benutzerdefinierte Datentypen und Einstellungen auf der Google Fit-Plattform.

Beispiel für die Erstellung eines Fitness API-Clients

Resulting user authorization flow

Im Folgenden sehen Sie den Autorisierungsablauf, der Nutzern angezeigt wird, wenn sie um Berechtigungen gebeten werden:

Abbildung 1: Autorisierungsablauf für Nutzer

1. Android-Berechtigungen: Nutzer sehen vor dem Herunterladen, welche Android-Berechtigungen Ihre App angefordert hat. Nachdem Ihre App heruntergeladen wurde, werden alle erforderlichen Laufzeitberechtigungen angefordert und die Nutzer erteilen oder verweigern diese Berechtigungen.
2. Prüfen und verbinden: Ihre App prüft, ob Berechtigungen erteilt wurden, bevor sie den Zugriff auf andere Datentypen anfordert.
3. Anfrage von OAuth-Bereichen: Google fordert den Nutzer auf, Ihrer App die OAuth-Bereiche zu gewähren, die für die Datentypen erforderlich sind, auf die sie zugreifen möchte.
4. Zugriff angewendet: Nachdem der Nutzer Berechtigungen erteilt hat, kann Ihre App 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 App erstellt und getestet haben, müssen Sie die Bestätigung beantragen. Für vertrauliche und eingeschränkte Bereiche sind unterschiedliche Begründungsstufen erforderlich.