Pierwsze kroki na Androidzie

Z tego przewodnika dowiesz się, jak zacząć tworzyć aplikacje Google Fit na Androida.

Uwaga: Google Fit jest częścią Usług Google Play. Poznaj korzyści płynące z używania Usług Google Play przez aplikację

Konfiguracja

Zanim zaczniesz tworzyć aplikację, wykonaj czynności opisane w poniższych 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. Warto utworzyć oddzielne konto, aby przetestować aplikację z perspektywy użytkownika.

Pobierz Usługi Google Play

Pobierz najnowszą bibliotekę kliencką Usług Google Play na stronie dostawcy hostingu:

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

Uzyskiwanie identyfikatora klienta OAuth 2.0

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

Tworzenie i konfigurowanie projektu

Do tworzenia aplikacji korzystającej z interfejsu 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 sekcji 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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.2.0")
}

Świetny 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.2.0'
}

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

Tworzenie i testowanie aplikacji

Po zakończeniu czynności konfiguracyjnych możesz zacząć tworzyć swoją aplikację. Na początek dowiedz się, jakie typy danych może zapisywać i odczytywać aplikacja. Dowiedz się więcej o korzystaniu z danych w Google Fit.

Uzyskiwanie niezbędnych uprawnień Androida

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

Uzyskiwanie uprawnień dotyczących protokołu OAuth

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

Tworzenie klienta API

Utwórz klienta API i dodaj typy danych, których aplikacja potrzebuje do zapisu lub odczytu danych. Dostępne są te punkty końcowe:

• SensorsClient: uzyskiwanie dostępu 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: jeśli zużycie energii jest zawsze włączone, zbieranie danych z czujnika w tle jest włączone.
• HistoryClient: wstawianie, usuwanie i odczytywanie danych historycznych w Google Fit.
• SessionsClient: tworzenie sesji związanych z aktywnością użytkownika i zarządzanie nimi.
• GoalsClient: odczytywanie celów dotyczących punktów kardio i kroków utworzonych przez użytkowników w Google Fit.
• ConfigClient: korzystaj z niestandardowych typów danych i ustawień na platformie Google Fit.

Zobacz przykład, jak utworzyć klienta Fitness API

Wynikowy proces autoryzacji użytkownika

Poniżej pokazujemy proces autoryzacji, który pojawia się, gdy użytkownik jest proszony o przyznanie uprawnień:

Rys. 1. Proces autoryzacji użytkowników.

1. Uprawnienia Androida: przed pobraniem aplikacji użytkownicy mogą sprawdzić, jakich uprawnień Androida żąda Twoja aplikacja. Po pobraniu aplikacja żąda wszelkich wymaganych uprawnień w czasie działania, a użytkownicy je przyznają lub odrzucają.
2. Sprawdź i połącz: aplikacja sprawdza, czy przyznano uprawnienia, zanim poprosi o dostęp do innych typów danych.
3. Żądanie zakresów OAuth: Google prosi użytkownika o przyznanie do aplikacji zakresów OAuth niezbędnych dla typów danych, do których chce mieć dostęp.
4. Dostęp zastosowany: gdy użytkownik przyzna uprawnienia, aplikacja uzyska dostęp do typów danych należących do zakresów, do których użytkownik przyznał uprawnienia.

Wniosek o weryfikację

Po skompilowaniu i przetestowaniu aplikacji musisz poprosić o weryfikację z różnymi poziomami uzasadnienia wymaganymi w przypadku zakresów wrażliwych i zakresów z ograniczeniami.