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

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

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

Настраивать

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

Получите учетную запись Google

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

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

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

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

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

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

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

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

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

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

Котлин DSL

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

...

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

Заводной DSL

apply plugin: 'com.android.application'

...

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

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

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

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

Получите необходимые разрешения Android

Для чтения и записи некоторых типов данных ваше приложение должно запрашивать разрешения Android .

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

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

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

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

• SensorsClient : доступ к различным источникам данных о здоровье и самочувствии от аппаратных датчиков на локальном устройстве и на сопутствующих устройствах.
• RecordingClient : для маломощного, всегда включенного фонового сбора данных датчика.
• HistoryClient : вставка, удаление и чтение исторических данных в Google Fit.
• SessionsClient : создание и управление сеансами пользовательской активности.
• GoalsClient : чтение целей Heart Point и Steps, созданных пользователями в Google Fit.
• ConfigClient : доступ к пользовательским типам данных и настройкам на платформе Google Fit.

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

Результирующий поток авторизации пользователя

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

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

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

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

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