Erste Schritte mit Android

Einrichten eines Google-Kontos

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. Möglicherweise möchten Sie ein separates Konto erstellen, um Ihre App aus Nutzersicht zu testen.

Google Play-Dienste installieren

Rufen Sie die aktuelle Clientbibliothek für die 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 für diese Pakete nicht Installiert ist, wählen Sie beide aus und klicken Sie auf Pakete installieren.

OAuth 2.0-Client-ID abrufen

Um die Fitness API zu aktivieren, rufen Sie eine OAuth 2.0-Client-ID ab.

Projekt erstellen und konfigurieren

Wir empfehlen, die Entwicklungsumgebung Android Studio zu verwenden, um eine App mit der Fitness API zu erstellen. Weitere Informationen zum Erstellen und Konfigurieren eines neuen Projekts in Android Studio finden Sie unter Projekt erstellen.

Google Play-Dienste-Clientbibliothek hinzufügen

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

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

...

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

apply plugin: 'com.android.application'

...

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

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

Erforderliche Android-Berechtigungen abrufen

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

OAuth-Berechtigungen abrufen

Die Datentypen, auf die Ihre App zugreifen darf, entsprechen Autorisierungsbereichen. Um diese Berechtigungen anzufordern , müssen Sie in einer FitnessOptions Instanz angeben , auf welche Datentypen Ihre App Zugriff benötigt. Wenn Ihre App die Verwendung eines der Google Fit-Datentypen anfordert, prüft das Android SDK automatisch, zu welchen Bereichen sie gehören, und fordert den Nutzer auf, diese Bereiche zu autorisieren.

• SensorsClient: Zugriff auf verschiedene Quellen von Gesundheits- und Wellnessdaten von Hardwaresensoren auf dem lokalen Gerät und auf Begleitgeräten.
• RecordingClient: Für die energiesparende, immer aktive Hintergrunderfassung von Sensordaten.
• HistoryClient: Historische Daten in Google Fit einfügen, löschen und lesen.
• SessionsClient: Sitzungen der Nutzeraktivität erstellen und verwalten.
• GoalsClient: Von Nutzern in Google Fit erstellte Ziele für Kardiopunkte und Schritte lesen.
• ConfigClient: Zugriff auf benutzerdefinierte Datentypen und Einstellungen in der Google Fit-Plattform.

Beispiel für das Erstellen eines Fitness API-Clients

Ergebnis des Nutzerautorisierungsablaufs

Im Folgenden wird der resultierende Autorisierungsablauf dargestellt, den Nutzer sehen, wenn sie um Berechtigungen gebeten werden:

1. Android-Berechtigungen: Nutzer sehen, welche Android-Berechtigungen Ihre App angefordert hat, bevor sie sie herunterladen. Nachdem Ihre App heruntergeladen wurde, fordert sie alle erforderlichen Laufzeitberechtigungen an. Nutzer erteilen oder verweigern diese Berechtigungen.
2. Prüfen und verbinden: Ihre App prüft, ob Berechtigungen erteilt wurden, bevor sie Zugriff auf andere Datentypen anfordert.
3. Anfrage für OAuth-Bereiche: 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.