Erste Schritte mit Android

Erstellen Sie sich ein Google-Konto

Sie benötigen ein Google-Konto, um die Google Fit APIs nutzen zu können. Sie können ein neues Konto erstellen oder ein vorhandenes Konto verwenden. Du kannst ein separates Konto erstellen, um deine App aus Nutzersicht 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

Um eine Fitness API zu aktivieren, müssen Sie eine OAuth 2.0-Client-ID abrufen.

Projekt erstellen und konfigurieren

Wir empfehlen, zum Erstellen einer App mit der Fitness API die Android Studio-Entwicklungsumgebung zu verwenden. Weitere Informationen zum Erstellen eines neuen Projekts und 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.

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

...

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

apply plugin: 'com.android.application'

...

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

Dadurch wird Gradle das SDK automatisch herunterladen, wenn es Ihre App erstellt.

Erforderliche Android-Berechtigungen erhalten

Wenn Sie einige Arten von Daten lesen und schreiben möchten, müssen Sie Android-Berechtigungen anfordern.

OAuth-Berechtigungen abrufen

Die Datentypen, auf die Ihre App zugreifen darf, entsprechen den Autorisierungsbereichen. Wenn Sie diese Berechtigungen anfordern möchten, müssen Sie in einer FitnessOptions-Instanz die Datentypen hinzufügen, auf die die App zugreifen muss. Wenn deine App einen Google Fit-Datentyp verwendet, prüft das Android SDK automatisch, zu welchen Bereichen sie gehört, und fragt den Nutzer nach einer 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. Die folgenden Endpunkte sind verfügbar:

• SensorsClient: Sie können auf verschiedene Quellen von Gesundheits- und Fitnessdaten von Hardwaresensoren im lokalen Gerät und auf Companion-Geräten zugreifen.
• RecordingClient: Damit wird der Hintergrund bei jeder Aufnahme des Sensors ständig aktiviert.
• HistoryClient: In Google Fit können Sie Verlaufsdaten einfügen, löschen und lesen.
• SessionsClient: Nutzersitzungen erstellen und verwalten.
• GoalsClient: Sie können die Punkte für Kardiopunkte und Schritte lesen, die von Nutzern in Google Fit erstellt wurden.
• ConfigClient: Auf benutzerdefinierte Datentypen und Einstellungen auf der Google Fit-Plattform zugreifen.

Beispiel für die Erstellung eines Fitness API-Clients

Resultierender Autorisierungsvorgang für Nutzer

Hier sehen Sie den Autorisierungsvorgang, den Nutzer ausführen, wenn sie nach Berechtigungen gefragt werden:

1. Android-Berechtigungen: Nutzer sehen vor dem Download, welche Android-Berechtigungen die App angefordert hat. Nachdem die Anwendung heruntergeladen wurde, fordert sie alle erforderlichen Laufzeitberechtigungen an und Nutzer erteilen oder ablehnen diese Berechtigungen.
2. Prüfen und verbinden: Ihre Anwendung prüft, ob Berechtigungen gewährt wurden, bevor sie Zugriff auf andere Datentypen anfordert.
3. OAuth-Umfang-Anfrage: Google fordert den Nutzer auf, Ihrer App die OAuth-Bereiche zu gewähren, die für die Datentypen erforderlich sind, auf die er zugreifen möchte.
4. Zugriff angewendet: Nachdem der Nutzer Berechtigungen gewährt hat, kann Ihre App auf die Datentypen zugreifen, die zu den Bereichen gehören, für die der Nutzer die Berechtigung gewährt hat.