HealthKit: какво е това, принципи на работа и интеграция

Какво е HealthKit?

HealthKit е фреймуърк на Apple, представен през 2014 г. заедно с iOS 8, предназначен за централизирано управление на здравните данни и данните за физическа активност на потребителя. Платформата служи като единно хранилище, където приложенията и устройствата могат да записват и четат медицинска информация.

За разлика от решенията на трети страни, HealthKit е вграден директно в iOS операционната система, което осигурява висока производителност и сигурност на хардуерно ниво. Приложенията нямат прекъс достъп едно до друго — всички операции минават през централния HKHealthStore.

Според Apple WWDC 2024, над 87% от потребителите на iPhone в СЩП поне веднъж са използвали вграденото приложение Здраве, което се базира именно на HealthKit. Екосистемата включва хиляди приложения на трети страни — от фитнес трекери до телемедицински услуги.

Архитектура на HealthKit

Архитектурата на HealthKit е построена на принципа на многонивално хранилище с изолирани контейнери за всеки източник на данни. На долното ниво се намира SQLite база от данни, шифрована с хардуерен AES-256. На горното ниво се намира HKHealthStore — единният интерфейс за взаимодействие.

Всяка запис съдържа метаданни: източник HKSource, устройство HKDevice, дата, час и флаг за синхронизация от iCloud. Системата автоматично премахва дублираните по един и същ източник, предотвратявайки изкривяване на статистиката.

Данните се групират по типове — HKQuantityType за числови показатели (пулс, кръчки, калории) и HKCategoryType за категорийни събития (сън, симптоми, менструален цикъл). Тази структура позволява гъвкаво запитване на всяка комбинация от параметри чрез HKSampleQuery или HKStatisticsQuery.

Типове данни в HealthKit

HealthKit поддържа над 100 стандартизирани типа данни, разделени в категории: физическа активност, хранене, сън, сърдечно-съдовна система, репродуктивно здраве, лабораторни параметри и животнени показатели. Всеки тип има мерна единица HKUnit и ниво на достъп.

Разработчикът може също да създава персонализирани корелации чрез HKCorrelation — група свързани измервания. Например, запис за хранене може да съдържа калории, протеини, мазнини и въглехидрати като един обект. За последователни измервания, като ниво на глюкоза, се използва HKSeriesSample.

Работата с HealthKit започва с определяне на HKHealthStore — синглтон, който се създава автоматично при импортиране на фреймуърка. Чрез store приложението проверява дали платформата е налична на устройството, тъй като на iPad и iPod touch поддръжката може да липсва. Важно е също да се отбележи, че HealthKit не е наличен на Mac Catalyst — за macOS се изисква отделна имплементация.

import HealthKit

let healthStore = HKHealthStore()

let stepType = HKQuantityType
    .quantityType(forIdentifier: .stepCount)

let heartRateType = HKQuantityType
    .quantityType(forIdentifier: .heartRate)

let typesToRead: Set = [stepType, heartRateType]

Как работи HealthKit

HealthKit функционира като посредник между източниците на данни и приложенията, използвайки асинхронен модел на публикуване-абониране. Източниковото приложение записва данни чрез HKHealthStore, а абонираните приложения получават известия за нови записи чрез HKObserverQuery, който работи на заден план.

Фреймуъркът поддържа синхронизация на заден план чрез iCloud: ако потребителят е влязъл, HealthKit автоматично разпространява данните до всички Apple устройства в реално време. При липса на мрежа, промените се буферират локално и синхронизират при възстановяване на връзката без загуба на данни.

Според Apple, забавянето на синхронизацията между iPhone и Apple Watch е по-малко от 30 секунди за данните за активност. За други типове — сън, хранене, лабораторни параметри — синхронизацията става по график с интервал до 15 минути за пестене на батерията.

HKHealthStore и операции с данни

HKHealthStore — централният синглтон, чрез който се изпълняват всички операции: запазване чрез saveObject, четене чрез execute и изтриване чрез deleteObject. Всяка операция е асинхронна и върща резултата чрез closure, което изисква правилно обработване на грешки.

Запитванията се разделят на няколко типа: HKSampleQuery за избор на записи по критерии, HKStatisticsQuery за обобщени данни — сбор, средно, минимум, максимум — и HKObserverQuery за проследяване на промените в реално време. За периодични обновявания на заден план се използва HKHeartbeatSeriesQuery.

let type = HKQuantityType
    .quantityType(forIdentifier: .stepCount)
let now = Date()
let start = Calendar.current
    .date(
        byAdding: .day,
        value: -7,
        to: now
    )
let predicate = HKQuery
    .predicateForSamples(
        withStart: start,
        end: now,
        options: .strictStartDate
    )
let query = HKSampleQuery(
    sampleType: type,
    predicate: predicate,
    limit: 100
) { _, samples, _ in
    for sample in samples as [HKQuantitySample] {
        print(sample.quantity)
    }
}
healthStore.execute(query)

Интеграция на HealthKit в приложение

Интеграцията на HealthKit започва с включване на capability HealthKit в Xcode и добавяне на entitlement към проекта. След това приложението поисква разрешение за достъп до конкретни типове данни чрез извикване на requestAuthorization. Важно: HealthKit не е наличен на симулатора и изисква физическо устройство с iOS.

Процесът на интеграция включва три етапа: определяне на типовете данни, изискване на авторизация и изпълняване на операции за четене и запис. Всяка етапа е асинхронен и трябва да обработва грешки — потребителят може да откаже искането за достъп до всякаква тип данни в системния диалогов прозорец с прекълючватели.

Според проучванията на Apple, приложенията с интеграция на HealthKit показват 40% по-високо ниво на ангажираност на потребителите. Ключовият фактор за успех е обяснението защо на приложението са нужни конкретни здравни данни в описанието на искането за авторизация.

Изискване на авторизация

Изискването на авторизация се изпълнява веднъж при първото стартиране. Приложението посочва два набора от типове — за четене и запис. Потребителят вижда системен диалогов прозорец с прекълючватели за всеки тип данни и може да предостави достъп избирателно, като забранява ненужни категории.

let typesToWrite: Set = [
    HKQuantityType
        .quantityType(
            forIdentifier: .dietaryEnergyConsumed
        )
]
let typesToRead: Set = [
    HKQuantityType
        .quantityType(
            forIdentifier: .stepCount
        )
]

healthStore.requestAuthorization(
    toShare: typesToWrite,
    read: typesToRead
) { success, error in
    if success {
        print("Авторизацията е получена")
    }
}

Сигурност на HealthKit

HealthKit прилага многонивален модел на сигурност, включващ хардуерно шифроване, песъчница на приложенията и грануларни разрешения. Всички здравни данни се съхраняват шифровани на устройството и не се пренасят в iCloud без отделното съгласие на потребителя, което се изисква веднъж.

Ключовата характеристика — Intent механизъм: приложението няма постоянен фонов достъп до данните. Всяко искане за четене или запис се проверява от операционната система и потребителят може по всяко време да оттегли разрешението чрез Настройки — Поверителност — Здраве, без да се налага да преинсталира приложението.

Apple строго регулира използването на HealthKit в App Store Review Guidelines. Приложението не може да пренася HealthKit данни на трети страни без изрично съгласие, не може да ги използва за реклама или таргетиране и не може да ги съхранява по-дълго от необходимото за декларираната функционалност.

Ограничения

HealthKit има редица ограничения: максимален размер на базата от данни на устройството — 1 GB, лимит на броя записи в едно запитване — 1000, минимален интервал между идентични типове данни — 1 секунда. Фреймуъркът също ограничава фоновите обновления — не повече от 60 запускания на HKObserverQuery на ден.

Тези ограничения се компенсират от производителността: четенето на 1000 записи отнима средно 50–100 милисекунди, а записването на един запис отнима по-малко от 10 милисекунди. За големи обеми от данни се препоръчва използването на HKStatisticsCollectionQuery с предварително обобщаване вместо избиране на отделни записи. HealthKit обработва запитванията асинхронно — приложението не се блокира докато чака данни от HKHealthStore.