Pierwsze kroki na Androidzie

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

Uwaga: Google Fit jest częścią Usług Google Play. Więcej informacji o korzyści, jakie aplikacja uzyskuje dzięki Google Play Usługi.

Konfiguracja

Zanim zaczniesz tworzyć aplikację, wykonaj te czynności sekcji.

Załóż konto Google

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

Pobierz Usługi Google Play

Pobierz najnowszą bibliotekę klienta dla Usług Google Play w ramach programowania host:

1. Otwórz Menedżera pakietów SDK na Androida.
2. W sekcji Narzędzia SDK znajdź Usługi Google Play.
3. Jeśli te pakiety mają stan inny niż Zainstalowane, wybierz oba 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 utworzenia aplikacji przy użyciu interfejsu Fitness API zalecamy korzystanie ze środowiska programistycznego Android Studio. Dla: Szczegółowe informacje o tworzeniu i konfigurowaniu nowego projektu w Android Studio znajdziesz Utwórz projekt.

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 będzie automatycznie pobierać pakiet SDK fitness, gdy tworzy Twoją aplikację.

Tworzenie i testowanie aplikacji

Po zakończeniu konfigurowania możesz zacząć tworzyć aplikację. Aby uzyskać dowiedz się, jakie typy danych może przechowywać Twoja aplikacja przeczytaj. Dowiedz się więcej o współpracy z w Google Fit.

Uzyskiwanie niezbędnych uprawnień Androida

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

Uzyskaj uprawnienia OAuth

Typy danych, do których aplikacja ma dostęp, odpowiadają zakresów autoryzacji. Aby zapytać dla tych uprawnień, musisz dodać typów danych, do których aplikacja potrzebuje dostępu w FitnessOptions instancję. Gdy aplikacja poprosi o użycie danych z Google Fit pakiet Android SDK automatycznie sprawdza, do których zakresów należą, i pyta użytkownika do tych zakresów.

Tworzenie klienta API

Utwórz klienta interfejsu API i dodaj typy danych, do których aplikacja ma mieć dostęp i 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 w urządzeniach towarzyszących.
• RecordingClient: do zbierania danych z czujnika w tle, zawsze włączonego zużycia energii.
• HistoryClient: wstawianie, usuwanie i odczytywanie danych historycznych w Google Fit.
• SessionsClient: możesz tworzyć sesje związane z aktywnością użytkownika i nimi zarządzać.
• GoalsClient: odczytuj cele związane z punktami kardio i krokami utworzone przez użytkowników w Google Fit.
• ConfigClient: daje dostęp do niestandardowych typów danych i ustawień na platformie Google Fit.

Zobacz przykład utworzenia klienta Fitness API

Wynikowy proces autoryzacji użytkownika

Poniżej przedstawiono wynik procesu autoryzacji, z którym doświadczają użytkownicy gdy pojawi się prośba o uprawnienia:

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

1. Uprawnienia Androida: użytkownicy widzą, jakie uprawnienia na Androidzie mają Twoja aplikacja. o które prosiliście przed pobraniem. Gdy to zrobisz, prosi o przyznanie wymaganych uprawnień w czasie działania aplikacji, a użytkownicy mogą je przyznawać i odbierać tych uprawnień.
2. Sprawdź i połącz: aplikacja sprawdza, czy uprawnienia zostały przyznane. przyznane przed wysłaniem prośby o dostęp do innych typów danych.
3. Żądanie zakresów protokołu OAuth: Google prosi użytkownika o przyznanie uprawnień aplikacji. zakresy protokołu OAuth wymagane dla typów danych, do których chce uzyskać dostęp.
4. Dostęp przyznany: gdy użytkownik przyzna uprawnienia, aplikacja będzie mogła uzyskiwanie dostępu do typów danych należących do zakresów przyznanych przez użytkownika i korzystania z nich.

Wniosek o weryfikację

Po skompilowaniu i przetestowaniu aplikacji musisz zgłosić się do weryfikacji za pomocą innego potrzebnych poziomów uzasadnienia zakresach wrażliwych i z ograniczonym dostępem.