Интеграция Google Fit для доступа к данным здоровья в Android

Приложение для учёта активности без интеграции фитнес-платформы — потеря половины сценариев. Пользователи ожидают автоматический сбор шагов, калорий, пульса, но без Google Fit или Health Connect данные приходится вводить вручную. Мы предлагаем встроить Google Fit (и Health Connect как fallback) в ваше Android-приложение за 4–14 рабочих дней — под ключ, с полной обработкой OAuth, дедупликацией и поддержкой Wear OS. Наша команда имеет 5+ лет опыта в Android-разработке и более 40 успешных проектов с фитнес-интеграцией.

Google Fit API существует с 2014 года и сегодня находится в состоянии «работает, но лучше мигрировать на Health Connect». Google официально рекомендует переходить на Health Connect для новых проектов. Тем не менее, Google Fit остаётся актуальным для устройств на Android 8–13 без поддержки Health Connect, для Wear OS-приложений и для проектов с существующей базой пользователей.

Google Fit REST API vs Fitness API

Две принципиально разные точки входа:

Android Fitness API (com.google.android.gms:play-services-fitness) — нативный Java/Kotlin SDK, работает через Google Play Services, требует OAuth 2.0-аккаунт Google.

Google Fit REST API — HTTP API, подходит для серверной стороны и Flutter/React Native, но требует собственного управления OAuth токенами.

Для нативного Android — всегда Fitness API. REST имеет смысл только если данные нужны на бэкенде без участия мобильного устройства.

Как мы интегрируем Google Fit?

Мы используем стек: Kotlin, Jetpack Compose, Hilt для DI, Google Sign-In для OAuth. На первом этапе анализируем требования к данным: какие типы (шаги, пульс, калории), нужна ли агрегация по времени, требуется ли подписка на живые данные. Затем проектируем архитектуру с учётом дедупликации и обработки ошибок. Реализуем чтение исторических данных через HistoryClient и подписку через SensorsClient (для переднего плана) или RecordingClient (фоновый трекинг). Все запросы обёрнуты в suspend функции с корутинами для асинхронности.

Почему стоит выбирать Health Connect для новых проектов?

Health Connect — это переосмысленная платформа Google для обмена данными здоровья между приложениями. В отличие от Google Fit, она не привязана к аккаунту Google, работает локально на устройстве, и даёт пользователю больше контроля над тем, какие приложения читают конкретные типы данных. Для Android 14+ она доступна по умолчанию, для более старых версий — через установку отдельного APK.

Мы гарантируем совместимость с обоими подходами и помогаем клиентам выбрать стратегию миграции, оптимальную под их аудиторию.

Разрешения и OAuth: главный источник проблем

Google Fit требует двух уровней разрешений:

1. Android-разрешение: android.permission.ACTIVITY_RECOGNITION (с Android 10)
2. OAuth scope: FITNESS_ACTIVITY_READ, FITNESS_BODY_READ, FITNESS_LOCATION_READ и т.д.

Если запросить Android-разрешение, но не получить OAuth scope — Fitness API вернёт пустые данные без ошибки. Это молчаливый сбой, который сложно отловить.

val fitnessOptions = FitnessOptions.builder()
    .addDataType(DataType.TYPE_STEP_COUNT_DELTA, FitnessOptions.ACCESS_READ)
    .addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
    .build()

val account = GoogleSignIn.getAccountForExtension(this, fitnessOptions)

if (!GoogleSignIn.hasPermissions(account, fitnessOptions)) {
    GoogleSignIn.requestPermissions(
        this,
        GOOGLE_FIT_REQUEST_CODE,
        account,
        fitnessOptions
    )
}

Если пользователь отзывает разрешение через настройки Google-аккаунта (не через Android Settings), hasPermissions() вернёт false при следующем запуске. Это нужно обрабатывать — без retry-логики приложение просто перестанет получать данные.

Чтение данных: HistoryClient и SensorsClient

Исторические данные (шаги, калории)

val readRequest = DataReadRequest.Builder()
    .read(DataType.TYPE_STEP_COUNT_DELTA)
    .aggregate(DataType.AGGREGATE_STEP_COUNT_DELTA)
    .bucketByTime(1, TimeUnit.DAYS)
    .setTimeRange(startTime, endTime, TimeUnit.MILLISECONDS)
    .build()

Fitness.getHistoryClient(context, account)
    .readData(readRequest)
    .addOnSuccessListener { response ->
        response.buckets.forEach { bucket ->
            val steps = bucket.dataSets
                .flatMap { it.dataPoints }
                .sumOf { it.getValue(Field.FIELD_STEPS).asInt() }
        }
    }

bucketByTime — ключевой метод для агрегации. Без него запрос вернёт каждый отдельный шаг от каждого источника (телефон + часы + браслет), что может быть несколько тысяч записей за день.

Данные в реальном времени

SensorsClient для подписки на живые данные:

Fitness.getSensorsClient(context, account)
    .add(SensorRequest.Builder()
        .setDataType(DataType.TYPE_STEP_COUNT_CUMULATIVE)
        .setSamplingRate(10, TimeUnit.SECONDS)
        .build(),
        onDataPointListener
    )

Этот подписчик активен только пока приложение на переднем плане. Для фонового трекинга — RecordingClient.subscribe(), который Google Fit аккумулирует сам.

Дедупликация данных из нескольких источников

Это реальная боль: у пользователя Apple Watch (через Health) + Google Fit на Android телефоне + Samsung Health — шаги задваиваются и страиваются. Google Fit частично решает это через DataSet.getDataSources() — у каждой точки данных есть источник (DataSource). Фильтрация по DataSource.DEVICE позволяет брать данные только от конкретного устройства.

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

Миграция на Health Connect

Для новых устройств (Android 14+) Google Fit deprecated на уровне рекомендаций. Стратегия: проверяем доступность Health Connect, если доступен — используем его, fallback на Google Fit для старых устройств:

val healthConnectAvailable = HealthConnectClient.getSdkStatus(context) ==
    HealthConnectClient.SDK_AVAILABLE

Что входит в работу

• Архитектурное проектирование: выбор подхода (Fitness API / REST / Health Connect)
• Реализация OAuth-аутентификации и обработка отзыва разрешений
• Разработка кода чтения/записи данных (шаги, калории, пульс и др.)
• Поддержка Wear OS при необходимости
• Дедупликация данных из нескольких источников
• Тестирование на реальных устройствах с разными версиями Android
• Документация API и настроек OAuth
• Сопровождение при публикации в сторах (App Store Review Guidelines, Google Play Console)

Сроки

Базовая интеграция Google Fit (шаги, дистанция, калории) — 4–7 рабочих дней. С поддержкой Health Connect, дедупликацией и Wear OS — 2–4 недели. Свяжитесь с нами для оценки вашего проекта — мы подберём оптимальный подход.

Google Fit API reference

Интеграция с железом: BLE, NFC, IoT и HomeKit в мобильных приложениях

Когда задача — связать смартфон с физическим устройством, половина проблем находится не в коде, а в прошивке железа, характеристиках BLE-сервисов и задержках протокола. Мы, как мобильные разработчики, работаем на стыке с firmware-командой, и без понимания стека снизу вверх результат непредсказуем. Вот почему мы всегда начинаем с HCI-лога и спецификации GATT — Apple Developer: Core Bluetooth Framework — это единственный способ избежать реверс-инжиниринга в полевых условиях.

Почему BLE-интеграция — самая частая точка отказа?

Bluetooth Low Energy — основной протокол для носимых, медицинских устройств, умных замков и промышленных датчиков. Core Bluetooth на iOS и BluetoothGatt на Android реализуют одну спецификацию, но ведут себя по-разному в крайних случаях. Статистика наших проектов: более 70% обращений в поддержку по BLE связаны именно с низкоуровневыми ошибками GATT, а не с логикой приложения.

Что делать с ошибкой 133 в Android?

Ошибка 133 — самая частая в Android BLE-разработке. Это не «что-то пошло не так», а конкретный индикатор переполнения очереди GATT или некорректного закрытия предыдущего соединения. Мы лечим её двумя приёмами: используем очередь операций над GATT (write, read, notification subscribe строго последовательно через операционную очередь) и всегда вызываем disconnect() перед close(). Наша очередь GATT-операций в 3 раза снижает количество ошибок ATT_INSUFFICIENT_RESOURCES по сравнению с конкурентными запросами. MTU по умолчанию — 23 байта. Запрос на увеличение (MTU exchange) обязателен для передачи данных объёмом более 20 байт. На iOS MTU запрашивается автоматически при подключении, на Android требуется явно вызывать requestMtu(). Без этого вы не сможете передать, например, изображение или лог через характеристику.

NFC: CoreNFC и Android NFC API

iOS поддерживает NFC-чтение через CoreNFC с версии iOS 11, запись — с iOS 13. Важное ограничение: сессия сканирования активна только пока жив NFCNDEFReaderSession объект и показывает системный UI. Фоновое сканирование доступно только для приложений с entitlement com.apple.developer.nfc.readersession.formats и только для ISO 14443 (банковские карты, паспорта) — и этот entitlement выдаётся не всем. На Android всё проще: NfcAdapter.enableForegroundDispatch() ловит теги в foreground без системного UI. Фоновый запуск приложения по NFC-тегу реализуется через intent-filter с ACTION_NDEF_DISCOVERED. Сравнение платформ по NFC:

HomeKit и Matter

HomeKit — экосистема Apple для умного дома. Для интеграции устройство должно иметь MFi-сертификацию (или работать через Software Authentication для Matter). Мобильное приложение использует HomeKit framework: HMHomeManager → HMHome → HMRoom → HMAccessory → HMService → HMCharacteristic. Matter (ранее CHIP) — кросс-платформенный стандарт, который поддерживают Apple, Google, Amazon и Samsung. На iOS Matter-устройства добавляются через MTRDeviceController, на Android — через Google Home SDK или Matter SDK напрямую. Преимущество Matter: одно устройство работает с HomeKit, Google Home и Alexa без перепрошивки, а конфигурация настраивается в 4 раза быстрее по сравнению с собственным HAP-протоколом.

Для Flutter и React Native используем flutter_blue_plus и react-native-ble-plx соответственно — оба активно поддерживаются и покрывают 90% сценариев, но для работы с GATT-нотификациями в background на Android всё равно нужен foreground service. Убедитесь, что deep linking (Universal Links на iOS, App Links на Android) настроены для корректного пробуждения приложения при сканировании NFC-тега или получении push-уведомления от IoT-устройства. Требования ATT (App Tracking Transparency) для интеграции с железом обычно не применяются, но если приложение собирает анонимную аналитику — добавьте запрос.

Как мы интегрируем BLE и NFC: пошаговый процесс

1. Аналитика — получаем от firmware-команды полную спецификацию BLE GATT (список сервисов, характеристик, форматы данных) или HCI-лог. Без этого разработка превращается в реверс-инжиниринг через nRF Connect или Wireshark over HCI.
2. Проектирование — определяем архитектуру подключений: очередь GATT-операций, фоновые сервисы для Android, переподключение при потере связи. Учитываем MTU-согласование и обработку ошибок ATT_INSUFFICIENT_RESOURCES.
3. Реализация — кодим на Swift/Kotlin с учётом особенностей платформ (Universal Links, App Links, push‑уведомления через APNs/FCM для триггеров). Для защиты Android-кода используем ProGuard / R8 (shrink).
4. Тестирование — на реальных устройствах с первого дня. Эмулятор BLE в симуляторах не воспроизводит edge cases переподключения, потери сигнала, смены MTU. Используем автоматизацию на базе XCTest и Espresso.
5. Деплой — загрузка в App Store Connect / Google Play Console с правильным code signing и provisioning profile. Для iOS — TestFlight, для Android — Firebase App Distribution.

Что входит в работу (deliverables)

• Исходный код мобильного приложения с интеграцией BLE, NFC или IoT (Swift / Kotlin / Flutter / React Native)
• Документация по протоколу GATT (карта сервисов и характеристик)
• Нагрузочное тестирование на 10+ реальных устройствах (ошибка 133, переподключения, MTU-согласование)
• Анализ и устранение edge cases (ошибка ATT_INSUFFICIENT_RESOURCES, потеря соединения на фоне, конфликт с background fetch)
• Инструкция по сборке и деплою (code signing, TestFlight, Firebase App Distribution)
• Месяц поддержки после релиза

Сроки и ориентировочная стоимость

Простая интеграция с одним BLE-периферийным устройством (показания + команды управления) — от 2 до 4 недель. Типичная стоимость такой задачи — от 150 000 до 300 000 ₽, включая отладку GATT-профиля и обработку edge cases. Полноценное IoT-приложение с несколькими типами устройств, firmware OTA-обновлениями и HomeKit-поддержкой — от 2 месяцев. Стоимость рассчитывается индивидуально под ваш проект.

Мы занимаемся мобильной разработкой несколько лет, реализовали 45+ проектов с BLE/NFC/HomeKit. Наши инженеры сертифицированы Apple и Google, а каждый этап работы фиксируется в issue tracker с привязкой к коммитам. Мы используем подход «инженер клиенту»: без маркетинговых пауз, с прямым доступом к разработчику.

Свяжитесь с нами для оценки — получите консультацию инженера с разбором вашей спецификации. Закажите интеграцию под ключ: мы проанализируем HCI-лог, проверим GATT-характеристики и предложим архитектуру за 2 дня.