Начало работы на устройстве Android

В этом руководстве рассказывается, как начать разработку с Google Fit на Android.

Примечание. Google Fit – это часть сервисов Google Play. Подробнее о преимуществах использования сервисов Google Play…

Настройка

Прежде чем приступить к созданию приложения, выполните действия, описанные в следующих разделах.

Создайте аккаунт Google

Чтобы использовать Google Fit API, вам нужен аккаунт Google. Вы можете создать новый аккаунт или использовать существующий. Вы можете создать отдельный аккаунт, чтобы протестировать приложение с точки зрения пользователя.

Установить сервисы Google Play

Скачайте последнюю версию клиентской библиотеки для сервисов Google Play на хост разработки:

1. Откройте Android SDK Manager.
2. В разделе SDK Tools найдите Сервисы Google Play.
3. Если статус этих пакетов не Installed (Установлено), выберите их и нажмите Install Packages (Установить пакеты).

Как получить идентификатор клиента OAuth 2.0

Чтобы включить Fitness API, получите идентификатор клиента OAuth 2.0.

Как создать и настроить проект

Для создания приложения с Fitness API рекомендуем использовать среду разработки Android Studio. Подробные инструкции по созданию и настройке проекта в Android Studio приведены в статье Создание проекта.

Добавьте клиентскую библиотеку сервисов Google Play

В Android Studio откройте файл build.gradle для своего модуля и добавьте клиентскую библиотеку сервисов Google Play в качестве зависимости:

Kotlin DSL

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

...

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

Groovy DSL

apply plugin: 'com.android.application'

...

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

Это гарантирует, что Gradle автоматически скачает Fitness SDK при сборке приложения.

Создайте и протестируйте приложение

После завершения настройки можно приступать к созданию приложения. Для начала узнайте, какие типы данных ваше приложение может хранить и считывать. Подробнее о том, как работать с данными в Google Fit…

Как получить необходимые разрешения Android

Чтобы читать и записывать некоторые типы данных, вашему приложению нужно запрашивать разрешения Android.

Получите разрешения OAuth

Типы данных, к которым у приложения есть доступ, соответствуют областям авторизации. Чтобы запросить эти разрешения, вам нужно добавить типы данных, к которым приложению требуется доступ, в экземпляр FitnessOptions. Когда приложение запрашивает доступ к любому из типов данных Google Fit, Android SDK автоматически проверяет, к каким областям они относятся, и запрашивает у пользователя разрешение на доступ к этим областям.

Создайте API-клиент

Создайте API-клиент и добавьте типы данных, к которым приложению нужен доступ для записи или чтения. Доступны следующие конечные точки:

• SensorsClient – доступ к различным источникам данных о здоровье и самочувствии, полученных от аппаратных датчиков на локальном и дополнительных устройствах.
• RecordingClient – для фонового сбора данных датчиков в режиме низкого энергопотребления.
• HistoryClient – вставка, удаление и чтение статистики в Google Fit.
• SessionsClient – создание сеансов действий пользователей и управление ими.
• GoalsClient – чтение целей по баллам кардиотренировок и шагам, созданных пользователями в Google Fit.
• ConfigClient – доступ к специальным типам данных и настройкам на платформе Google Fit.

Пример создания API-клиента Fitness

Процесс авторизации пользователя

Ниже показано, как выглядит процесс авторизации, когда у пользователей запрашиваются разрешения.

Рисунок 1. Процесс авторизации пользователей.

1. Разрешения Android. Перед скачиванием приложения пользователи видят, какие разрешения Android оно запрашивает. После скачивания приложение запрашивает необходимые динамические разрешения, а пользователи предоставляют или отклоняют их.
2. Проверка и подключение. Приложение проверяет, предоставлены ли разрешения, прежде чем запрашивать доступ к другим типам данных.
3. Запрос областей действия OAuth. Google предлагает пользователю предоставить вашему приложению области действия OAuth, необходимые для типов данных, к которым оно хочет получить доступ.
4. Доступ предоставлен. После того как пользователь предоставит разрешения, ваше приложение сможет получить доступ к типам данных, которые относятся к областям действия, для которых пользователь предоставил разрешение.

Как подать заявку на проверку

После создания и тестирования приложения вам нужно подать заявку на проверку. При этом для конфиденциальных и ограниченных областей действия потребуется обоснование.