Erste Schritte mit Android

In dieser Anleitung wird beschrieben, wie Sie mit der Entwicklung mit Google Fit unter Android beginnen.

Hinweis: Google Fit ist Teil der Google Play-Dienste. Weitere Informationen zu den Vorteilen, die Ihre App durch die Verwendung der Google Play Dienste erhält.

Einrichtung

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

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:

Kotlin DSL

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.5.1")
}

Groovy DSL

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.5.1'
}

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 der Entwicklung Ihrer App beginnen. Informationen zu den Datentypen, die Ihre App speichern undlesen kann Weitere Informationen zum Arbeiten mit Daten in Google Fit

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 Instanzangeben, 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 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:

Abbildung 1: Autorisierungsablauf für Nutzer

1. Android-Berechtigungen: Nutzer sehen, welche Android-Berechtigungen Ihre App angefordert hat, bevor sie sie herunterladen. Nachdem Ihre App heruntergeladen wurde, fordert sie alle Laufzeitberechtigungen an, die sie benötigt, 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 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 eine Überprüfung beantragen. Für unterschiedliche Begründungen sind vertrauliche und eingeschränkte Bereiche erforderlich.