Pierwsze kroki na Androidzie

Z tego przewodnika dowiesz się, jak rozpocząć tworzenie aplikacji korzystającej z Google Fit na Androidzie.

Uwaga: Google Fit jest częścią Usług Google Play. Dowiedz się, jakie korzyści przynosi Twojej aplikacji korzystanie z Usług Google Play Services.

Konfiguracja

Zanim zaczniesz tworzyć aplikację, wykonaj czynności opisane w poniższych sekcjach.

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

1. Otwórz Menedżera SDK na Androida.
2. W sekcji Narzędzia pakietu SDK znajdź Usługi Google Play.
3. Jeśli stan tych pakietów to Zainstalowane, 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ść:

Kotlin DSL

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.5.1")
}

Groovy DSL

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

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

Tworzenie i testowanie aplikacji

Po wykonaniu czynności konfiguracyjnych możesz zacząć tworzyć aplikację. Na po czątek dowiedz się, jakie typy danych może ona przechowywać i odczytywać. Więcej informacji o pracy z danymi w Google Fit

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 Twoja 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 w 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 kardio 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:

Rysunek 1.Proces autoryzacji użytkowników.

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. Zastosowano dostęp: po przyznaniu uprawnień aplikacja może uzyskiwać dostęp do typów danych należących do zakresów, na które użytkownik wyraził zgodę.

Złóż wniosek o weryfikację

Po utworzeniu i przetestowaniu aplikacji musisz złożyć wniosek o weryfikację. W przypadku różnych poziomów uzasadnienia wymaganych dla zakresów wrażliwych i z ograniczeniami.