Pierwsze kroki na Androidzie

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

Konfiguracja

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

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 przetestowania z perspektywy użytkownika.

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.

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

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.

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

Kotlin DSLŚwietny 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 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ę więcej o typach danych, które może przechowywać Twoja aplikacja przeczytaj. Dowiedz się więcej o współpracy z w Google Fit.

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

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.

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

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.