Начать работу на 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 для создания приложения с Fitness 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.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}

Отличный 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.3.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.

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

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

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

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

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

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

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