Начать работу на Android

В этом руководстве объясняется, как начать разработку приложений с использованием Google Fit на Android.

Примечание: Google Fit является частью сервисов Google Play. Узнайте о преимуществах использования сервисов Google Play для вашего приложения .

Настраивать

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

Зарегистрируйте аккаунт Google

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

Получите сервисы Google Play

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

1. Откройте менеджер Android SDK .
2. В разделе «Инструменты SDK» найдите «Сервисы Google Play» .
3. Если статус этих пакетов не «Установлено» , выберите оба пакета и нажмите «Установить пакеты» .

Получите идентификатор клиента OAuth 2.0.

Для активации Fitness API получите идентификатор клиента OAuth 2.0 .

Создайте и настройте свой проект.

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

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

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

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:21.5.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:21.5.0'
}

Это гарантирует, что Gradle автоматически загрузит 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.

Посмотрите пример того, как создать клиент для Fitness API.

В результате формируется процесс авторизации пользователя.

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

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

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

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

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