Pierwsze kroki na Androidzie

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

Konfiguracja

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

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 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.

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

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.

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

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

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

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.

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

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.