Pierwsze kroki na Androidzie

Z tego przewodnika dowiesz się, jak zacząć korzystać z Google Fit na Androidzie.

Uwaga: Google Fit jest częścią Usług Google Play. Poznaj korzyści, jakie Twoja aplikacja uzyskuje dzięki Usługom Google Play.

Konfiguracja

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

Załóż konto Google

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

Pobierz Usługi Google Play

Pobierz najnowszą bibliotekę klienta dla Usług Google Play na hoście programisty:

1. Otwórz Menedżera pakietów Android SDK.
2. W sekcji Narzędzia SDK znajdź Usługi Google Play.
3. Jeśli stan tych pakietów nie jest ustawiony na Zainstalowane, wybierz je i kliknij Zainstaluj pakiety.

Uzyskiwanie identyfikatora klienta OAuth 2.0

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

Tworzenie i konfigurowanie projektu

Do tworzenia aplikacji za pomocą interfejsu Fitness API zalecamy użycie środowiska programistycznego Android Studio. Szczegółowe informacje o tworzeniu i konfigurowaniu nowego projektu 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ść:

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.1.0")
        implementation("com.google.android.gms:play-services-auth:20.7.0")
}

Imponująca wersja DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.1.0'
    implementation 'com.google.android.gms:play-services-auth:20.7.0'
}

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

Tworzenie i testowanie aplikacji

Po ukończeniu konfiguracji możesz zacząć tworzyć aplikację. Na początek dowiedz się, jakie typy danych możesz przechowywać i odczytywać. Dowiedz się więcej o korzystaniu z danych w Google Fit.

Uzyskanie niezbędnych uprawnień Androida

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

Uzyskiwanie uprawnień OAuth

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

Tworzenie klienta API

Utwórz klienta API i dodaj typy danych, których Twoja aplikacja potrzebuje, 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 na urządzeniach towarzyszących.
• RecordingClient: umożliwia zbieranie danych z czujników przy niskim zużyciu energii,
• HistoryClient: wstawiaj, usuwaj i odczytu dane historyczne w Google Fit.
• SessionsClient: tworzenie sesji aktywności użytkowników i zarządzanie nimi.
• GoalsClient: odczytywanie celów związanych z punktami kardio i krokami 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

Oto wynik procesu autoryzacji, który pojawia się, gdy użytkownik poprosi o pozwolenie:

Ilustracja 1. Proces autoryzacji dla użytkowników

1. Uprawnienia Androida: przed pobraniem aplikacji użytkownicy widzą uprawnienia, których ma żądać Twoja aplikacja. Gdy aplikacja zostanie pobrana, poprosi o wszystkie wymagane uprawnienia w czasie działania, a użytkownicy przyznają lub odmówią przyznania tych uprawnień.
2. Sprawdź i połącz: aplikacja sprawdza, czy przyznano jej 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 wymaganych dla typów danych, do których chce uzyskać dostęp.
4. Dostęp przyznany: gdy użytkownik przyzna uprawnienia, aplikacja będzie miała dostęp do typów danych należących do zakresów, na które użytkownik przyznał uprawnienia.

Poproś o weryfikację

Po utworzeniu i przetestowaniu aplikacji musisz złożyć wniosek o jej weryfikację, podając różne poziomy uzasadnienia dla zakresów wrażliwych i zakresów z ograniczeniami.