Pierwsze kroki na Androidzie

Uzyskaj 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 SDK na Androida.
2. W sekcji Narzędzia SDK znajdź Usługi Google Play.
3. Jeśli stan tych pakietów nie jest Zainstalowany, zaznacz oba i kliknij Zainstaluj pakiety.

Uzyskaj identyfikator klienta OAuth 2.0

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

Tworzenie i konfigurowanie projektu

Do tworzenia aplikacji za pomocą Fitness API zalecamy używanie środowiska programistycznego Android Studio. Szczegółowe informacje o tym, jak utworzyć nowy projekt i skonfigurować go w Android Studio, znajdziesz w artykule Tworzenie projektu.

Dodaj bibliotekę 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.6.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.6.0'
}

Dzięki temu Gradle automatycznie pobierze pakiet SDK Fitness podczas tworzenia aplikacji.

Uzyskaj niezbędne uprawnienia na Androida

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

Uzyskaj uprawnienia OAuth

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

Utwórz klienta interfejsu API

Utwórz klienta interfejsu API i dodaj typy danych, do których 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 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 Fitness API.

Wynikowy proces autoryzacji użytkownika

Poniżej przedstawiamy proces autoryzacji, który widzą użytkownicy, gdy są proszeni o uprawnienia:

1. Uprawnienia na Androida: przed pobraniem aplikacji użytkownicy widzą, o jakie uprawnienia na Androida prosi aplikacja. Po pobraniu aplikacja prosi o wszystkie uprawnienia, których potrzebuje, a użytkownicy przyznają lub odmawiają tych uprawnień.
2. Sprawdź i połącz: przed poproszeniem o dostęp do innych typów danych aplikacja sprawdza, czy przyznano jej uprawnienia.
3. Prośba o zakresy OAuth: Google prosi użytkownika o przyznanie aplikacji zakresów OAuth potrzebnych do uzyskania dostępu do typów danych, do których aplikacja chce mieć dostęp.
4. Zastosowany dostęp: gdy użytkownik przyzna uprawnienia, aplikacja będzie mogła uzyskać dostęp do typów danych należących do zakresów, na które użytkownik wyraził zgodę.