Erste Schritte mit Android

In diesem Leitfaden erfahren Sie, wie Sie mit Google Fit auf Android-Geräten mit der Entwicklung beginnen.

Einrichtung

Bevor Sie mit dem Erstellen Ihrer App beginnen, führen Sie die folgenden Schritte aus: .

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.

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).

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

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

Ö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:

Kotlin-DSLGrooviges DSL
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.3.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.3.0'
}

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

Anwendung erstellen und testen

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie mit der Erstellung Ihrer App beginnen. Um Informationen zu den Datentypen, die Ihre App speichern und speichern kann lesen. Weitere Informationen zur Arbeit mit in Google Fit.

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

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.

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.

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

<ph type="x-smartling-placeholder">
</ph>
Abbildung 1: Autorisierungsvorgang für Nutzer
  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.

Überprüfung beantragen

Nachdem Sie Ihre App erstellt und getestet haben, beantragen Sie Bestätigung mit unterschiedlichen Begründungen, die für Vertrauliche und eingeschränkte Bereiche: