Erste Schritte mit Android

Erstellen Sie sich ein Google-Konto

Zur Nutzung der Google Fit APIs benötigen Sie ein Google-Konto. Sie können ein neues Konto erstellen oder ein bestehendes Konto zu verwenden. Es empfiehlt sich, zum Testen ein separates Konto zu erstellen. für Ihre App aus der Perspektive der Nutzer.

Google Play-Dienste installieren

Hol dir die aktuelle Clientbibliothek für Google Play-Dienste bei deiner Entwicklung Host:

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 Install Packages (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, zum Erstellen einer App mit der Fitness API die Android Studio-Entwicklungsumgebung zu verwenden. Für wie Sie ein neues Projekt erstellen und in Android Studio konfigurieren, siehe 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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

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

Dadurch wird das Fitness-SDK automatisch von Gradle heruntergeladen, für die Entwicklung Ihrer App.

Erforderliche Android-Berechtigungen erhalten

Damit Sie einige Datentypen lesen und schreiben können, muss Ihre App Android-Berechtigungen anfordern.

OAuth-Berechtigungen abrufen

Die Datentypen, auf die deine App zugreifen darf, entsprechen denen von Autorisierungsbereiche. Fragen für diese Berechtigungen müssen Sie Hinzufügen auf welche Datentypen deine App in einem FitnessOptions zugreifen muss Instanz. Wenn Ihre App anfordert, Google Fit-Daten zu verwenden Typen überprüft, prüft das Android SDK automatisch, zu welchen Bereichen sie gehören, und fragt den Nutzer zur 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 Daten schreiben oder lesen. Die folgenden Endpunkte sind verfügbar:

• SensorsClient: Über Hardwaresensoren des lokalen Geräts und der Companion-Geräte können Sie auf verschiedene Quellen von Gesundheits- und Fitnessdaten zugreifen.
• RecordingClient: Für die Erfassung von Sensordaten im Hintergrund mit geringem Stromverbrauch.
• HistoryClient: Hier können Sie Verlaufsdaten einfügen, löschen und lesen in Google Fit
• SessionsClient: Hier können Sie Sitzungen mit Nutzeraktivitäten erstellen und verwalten.
• GoalsClient: Hier können Sie die von Nutzern in Google Fit erstellten Kardiopunkt- und Schrittziele lesen.
• ConfigClient: Auf der Google Fit-Plattform können Sie auf benutzerdefinierte Datentypen und Einstellungen zugreifen.

Sehen Sie sich ein Beispiel zum Erstellen eines Fitness API-Clients an.

Daraus resultierender Ablauf der Nutzerautorisierung

Hier sehen Sie den resultierenden Autorisierungsablauf für die Nutzer: wenn sie nach Berechtigungen gefragt werden:

</ph>

1. Android-Berechtigungen: Nutzer sehen, welche Android-Berechtigungen die App hat. die Sie vor dem Download angefordert haben. Nachdem Ihre App heruntergeladen wurde, fordert alle benötigten Laufzeitberechtigungen an und Nutzer gewähren oder verweigern für diese Berechtigungen.
2. Prüfen und verbinden: Ihre App prüft, ob Berechtigungen gewährt, bevor Zugriff auf andere Datentypen angefordert wird.
3. Anfrage für OAuth-Bereiche: Google fordert den Nutzer dazu auf, Ihrer App zuzustimmen. OAuth-Bereiche, die für die Datentypen erforderlich sind, auf die zugegriffen werden soll.
4. Zugriff angewendet: Nachdem ein Nutzer Berechtigungen erteilt hat, kann Ihre App Auf die Datentypen zugreifen, die zu den Bereichen gehören, die der Nutzer gewährt hat Berechtigung erteilen.