Pierwsze kroki na Androidzie

Z tego przewodnika dowiesz się, jak rozpocząć tworzenie aplikacji na Google Fit na Androida.

Uwaga: Google Fit jest częścią Usług Google Play. Dowiedz się, jakie korzyści dla aplikacji wynikają z korzystania z Usług Google Play

Konfiguracja

Zanim zaczniesz tworzyć aplikację, wykonaj czynności opisane w tych sekcjach.

Załóż konto Google

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

Pobierz Usługi Google Play

Pobierz najnowszą bibliotekę klienta Usług Google Play na hostowanym środowisku deweloperskim:

1. Otwórz Menedżera pakietu Android SDK.
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.

Pobieranie identyfikatora klienta OAuth 2.0

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

Tworzenie i konfigurowanie projektu

Zalecamy użycie środowiska programistycznego Android Studio do tworzenia aplikacji z Fitness API. Szczegółowe informacje o tworzeniu nowego projektu i jego konfigurowaniu w Android Studio znajdziesz w artykule Tworzenie projektu.

Dodawanie biblioteki klienta Usług Google Play

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

Kotlin 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")
}

Groovy DSL

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

Dzięki temu Gradle automatycznie pobiera pakiet SDK Fitness podczas kompilowania aplikacji.

Tworzenie i testowanie aplikacji

Po zakończeniu konfiguracji możesz zacząć tworzyć aplikację. Aby zacząć, dowiedz się, jakie typy danych może ona przechowywać i czytać. Dowiedz się więcej o pracy z danymi w Google Fit.

Uzyskaj wymagane uprawnienia na Androidzie

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

Przyznawanie uprawnień OAuth

Typy danych, do których aplikacja ma uprawnienia dostępu, odpowiadają zakresowi autoryzacji. Aby poprosić o te uprawnienia, musisz dodać typy danych, do których aplikacja potrzebuje dostępu, w FitnessOptionsinstansji. Gdy aplikacja prosi o możliwość korzystania z jakiegokolwiek 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 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 dobrze zorganizowanym życiu pochodzących z czujników sprzętowych na urządzeniu lokalnym i na urządzeniach towarzyszących.
• RecordingClient: zbieranie danych z czujników w tle przy niskim poborze mocy.
• HistoryClient: w Google Fit możesz wstawiać, usuwać i czytać dane historyczne.
• SessionsClient: tworzenie sesji aktywności użytkowników i zarządzanie nimi.
• GoalsClient: odczytywanie celów związanych z punktami i krokami utworzonych przez użytkowników w Google Fit.
• ConfigClient: dostęp do niestandardowych typów danych i ustawień na platformie Google Fit.

Przykład tworzenia klienta Fitness API

Wynikający z tego proces autoryzacji użytkownika

Poniżej przedstawiono proces autoryzacji, który użytkownicy przechodzą, gdy proszą o przyznanie uprawnień:

Rysunek 1.Proces autoryzacji dla użytkowników.

1. Uprawnienia na Androidzie: użytkownicy widzą, jakie uprawnienia na Androidzie żądała Twoja aplikacja przed pobraniem. Po pobraniu aplikacja prosi o uprawnienia, których potrzebuje w czasie działania, a użytkownicy udzielają lub odmawiają tych uprawnień.
2. Sprawdzanie i łączenie: aplikacja sprawdza, czy zostały przyznane uprawnienia, zanim poprosi o dostęp do innych typów danych.
3. Prośba o zakresy OAuth: Google prosi użytkownika o przyznanie Twojej aplikacji zakresów OAuth potrzebnych do obsługi typów danych, do których aplikacja ma uzyskiwać dostęp.
4. Zastosowane uprawnienia: gdy użytkownik przyzna uprawnienia, aplikacja może uzyskać dostęp do typów danych należących do zakresów, do których użytkownik przyznał uprawnienia.

Przesyłanie wniosku o weryfikację

Po utworzeniu i przetestowaniu aplikacji musisz przesłać prośbę o weryfikację z różnymi poziomami uzasadnienia wymaganymi w przypadku zakresów wrażliwych i zakresów z ograniczeniami.