Pierwsze kroki na Androidzie

Załóż konto Google

Aby korzystać z interfejsów Google Fit API, musisz mieć konto Google. Możesz utworzyć nowe konto lub użyć istniejącego. Możesz utworzyć osobne konto, aby testować aplikację z perspektywy użytkownika.

Pobierz Usługi Google Play

Pobierz najnowszą bibliotekę klienta Usług Google Play na hosta deweloperskiego:

1. Otwórz Menedżera pakietu Android SDK.
2. W sekcji SDK Tools znajdź Usługi Google Play.
3. Jeśli stan tych pakietów nie jest Zainstalowano, wybierz oba i kliknij Zainstaluj pakiety.

Uzyskiwanie identyfikatora klienta OAuth 2.0

Aby włączyć Fitness API, uzyskaj identyfikator klienta OAuth 2.0.

Tworzenie i konfigurowanie projektu

Do tworzenia aplikacji z interfejsem Fitness API zalecamy używanie środowiska programistycznego Android Studio. Szczegółowe informacje o tworzeniu nowego projektu i konfigurowaniu go w Android Studio znajdziesz w artykule Tworzenie projektu.

Dodawanie biblioteki klienta Usług Google Play

W Android Studio otwórz plik build.gradle modułu i dodaj bibliotekę klienta usług Google Play jako zależność:

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

Dzięki temu Gradle automatycznie pobierze pakiet SDK do fitnessu podczas kompilowania aplikacji.

Uzyskiwanie niezbędnych uprawnień na Androidzie

Aby odczytywać i zapisywać niektóre typy danych, aplikacja musi poprosić o uprawnienia na Androidzie.

Uzyskiwanie uprawnień OAuth

Typy danych, do których Twoja aplikacja ma uprawnienia dostępu, odpowiadają zakresom autoryzacji. Aby poprosić o te uprawnienia, musisz dodać typy danych, do których Twoja aplikacja potrzebuje dostępu, w FitnessOptionsinstancji. Gdy aplikacja prosi o użycie dowolnego typu danych Google Fit, pakiet SDK Androida automatycznie sprawdza, do których zakresów należą te dane, i prosi użytkownika o autoryzację tych zakresów.

Tworzenie klienta API

Utwórz klienta interfejsu API i dodaj typy danych, do których Twoja aplikacja musi mieć dostęp, aby zapisywać lub odczytywać dane. Dostępne są te punkty końcowe:

• SensorsClient: dostęp do różnych źródeł danych o zdrowiu i samopoczuciu z czujników sprzętowych na urządzeniu lokalnym i urządzeniach towarzyszących.
• RecordingClient: do ciągłego zbierania danych z czujników w tle przy niskim zużyciu energii.
• HistoryClient: wstawianie, usuwanie i odczytywanie danych historycznych w Google Fit.
• SessionsClient: tworzenie sesji aktywności użytkownika i zarządzanie nimi.
• GoalsClient: odczytywanie celów dotyczących punktów za aktywność i liczby kroków utworzonych przez użytkowników w Google Fit.
• ConfigClient: dostęp do niestandardowych typów danych i ustawień na platformie Google Fit.

Zobacz przykład tworzenia klienta interfejsu Fitness API

Wynikowy proces autoryzacji użytkownika

Poniżej przedstawiono wynikowy proces autoryzacji, z którym użytkownicy mają do czynienia, gdy są proszeni o uprawnienia:

1. Uprawnienia na Androidzie: przed pobraniem aplikacji użytkownicy widzą, o jakie uprawnienia na Androidzie prosi aplikacja. Po pobraniu aplikacja prosi o przyznanie uprawnień w czasie działania, a użytkownicy mogą je przyznać lub odrzucić.
2. Sprawdzanie i nawiązywanie połączenia: aplikacja sprawdza, czy przyznano uprawnienia, zanim poprosi o dostęp do innych typów danych.
3. Żądanie zakresów OAuth: Google prosi użytkownika o przyznanie aplikacji zakresów OAuth potrzebnych do uzyskania dostępu do typów danych, których aplikacja potrzebuje.
4. Dostęp zastosowany: po przyznaniu uprawnień przez użytkownika aplikacja może uzyskiwać dostęp do typów danych należących do zakresów, na które użytkownik wyraził zgodę.