Erste Schritte mit Android

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 Konto verwenden. Es kann sinnvoll sein, ein separates Konto zu erstellen, um Ihre App aus Nutzersicht 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 Services.
3. Wenn der Status für diese Pakete nicht Installiert lautet, 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 Android Studio-Entwicklungsumgebung 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:21.4.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:21.4.0'
}

So 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. Wenn Sie diese Berechtigungen anfordern möchten, müssen Sie in einer FitnessOptions-Instanz hinzufügen, 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 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 Ihre App zugreifen muss, um Daten zu schreiben oder zu lesen. Folgende Endpunkte sind verfügbar:

• SensorsClient: Zugriff auf verschiedene Quellen für Gesundheits- und Wellnessdaten von Hardwaresensoren auf dem lokalen Gerät und auf Begleitgeräten.
• RecordingClient: Für die Hintergrundsammlung von Sensordaten mit geringem Stromverbrauch und Always-on-Funktion.
• HistoryClient: Verlaufsdaten in Google Fit einfügen, löschen und lesen.
• SessionsClient: Sitzungen mit Nutzeraktivitäten erstellen und verwalten.
• GoalsClient: Ziele für Kardiopunkte und Schritte lesen, die von Nutzern in Google Fit erstellt wurden.
• ConfigClient: Zugriff auf benutzerdefinierte Datentypen und Einstellungen in der Google Fit-Plattform.

Beispiel für das Erstellen eines Fitness API-Clients

Daraus resultierender Nutzerautorisierungsablauf

Im Folgenden sehen Sie den resultierenden Autorisierungsablauf, den Nutzer durchlaufen, 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, werden alle erforderlichen Laufzeitberechtigungen angefordert und 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 gewährt: 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.