HealthKit: Nedir, Nasıl Çalışır ve Entegrasyon

HealthKit Nedir?

HealthKit, 2014 yılında iOS 8 ile birlikte tanıtılan, kullanıcının sağlık ve fitness verilerinin merkezi yönetimi için tasarlanmış bir Apple çerçevesidir. Platform, uygulamaların ve cihazların tıbbi bilgileri yazabileceği ve okuyabileceği birleşik bir depo görevi görür.

Üçüncü taraf çözümlerin aksine, HealthKit doğrudan iOS işletim sistemine entegre edilmiştir ve donanım düzeyinde yüksek performans ve güvenlik sağlar. Uygulamaların birbirine doğrudan erişimi yoktur — tüm işlemler merkezi HKHealthStore üzerinden gerçekleşir.

Apple WWDC 2024'e göre, ABD'deki iPhone kullanıcılarının %87'sinden fazlası, HealthKit'i temel alan yerleşik Sağlık uygulamasını en az bir kez kullanmıştır. Ekosistem, fitness takipçilerinden tele-tıp hizmetlerine kadar binlerce üçüncü taraf uygulamayı içerir.

HealthKit Mimarisi

HealthKit mimarisi, her veri kaynağı için izole edilmiş kapsayıcılarla çok seviyeli depolama prensibi üzerine inşa edilmiştir. Alt seviyede, donanım AES-256 ile şifrelenmiş bir SQLite veritabanı bulunur. Üst seviyede ise HKHealthStore — birleşik etkileşim arayüzü bulunur.

Her kayıt, HKSource kaynağı, HKDevice cihazı, tarih, saat ve bir iCloud senkronizasyon bayrağı gibi meta veriler içerir. Sistem, aynı kaynaktan gelen yinelenen kayıtları otomatik olarak tekilleştirerek veri bozulmasını önler.

Veriler türlere göre gruplandırılır — sayısal göstergeler için HKQuantityType (kalp atış hızı, adımlar, kaloriler) ve kategorik olaylar için HKCategoryType (uyku, semptomlar, adet döngüsü). Bu yapı, HKSampleQuery veya HKStatisticsQuery aracılığıyla herhangi bir parametre kombinasyonunun esnek bir şekilde sorgulanmasına olanak tanır.

HealthKit'te Veri Türleri

HealthKit, 100'den fazla standartlaştırılmış veri türünü destekler ve bunlar kategorilere ayrılır: fiziksel aktivite, beslenme, uyku, kardiyovasküler sistem, üreme sağlığı, laboratuvar sonuçları ve yaşamsal belirtiler. Her türün bir HKUnit ölçüm birimi ve bir erişim seviyesi vardır.

Geliştiriciler ayrıca HKCorrelation aracılığıyla özel korelasyonlar oluşturabilir — ilgili ölçümlerin bir grubu. Örneğin, bir yemek kaydı, kalori, protein, yağ ve karbonhidratları tek bir nesne olarak içerebilir. Glikoz seviyeleri gibi sıralı ölçümler için HKSeriesSample kullanılır.

HealthKit ile çalışmak, çerçeve içe aktarıldığında otomatik olarak oluşturulan bir singleton olan HKHealthStore'u tanımlamakla başlar. Uygulama, mağaza aracılığıyla platformun cihazda kullanılabilir olup olmadığını kontrol eder, çünkü iPad ve iPod touch'ta destek bulunmayabilir. HealthKit'in Mac Catalyst'te kullanılamadığını da unutmamak önemlidir — macOS için ayrı bir uygulama gerekir.

import HealthKit

let healthStore = HKHealthStore()

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

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

let typesToRead: Set = [stepType, heartRateType]

HealthKit Nasıl Çalışır

HealthKit, eşzamansız bir yayınla-abone ol modeli kullanarak veri kaynakları ve uygulamalar arasında bir arabulucu görevi görür. Kaynak uygulama, HKHealthStore aracılığıyla veri yazar ve abone uygulamalar, arka planda çalışan HKObserverQuery aracılığıyla yeni kayıt bildirimleri alır.

Çerçeve, iCloud aracılığıyla arka plan senkronizasyonunu destekler: kullanıcı oturum açtıysa, HealthKit verileri otomatik olarak gerçek zamanlı olarak tüm Apple cihazlarına dağıtır. Ağ olmadığında, değişiklikler yerel olarak arabelleğe alınır ve bağlantı geri yüklendiğinde veri kaybı olmadan senkronize edilir.

Apple'a göre, iPhone ve Apple Watch arasındaki senkronizasyon gecikmesi aktivite verileri için 30 saniyeden azdır. Diğer türler — uyku, beslenme, laboratuvar sonuçları — için senkronizasyon, pil tasarrufu için 15 dakikaya kadar aralıklarla bir programa göre gerçekleşir.

HKHealthStore ve Veri İşlemleri

HKHealthStore, tüm işlemlerin gerçekleştirildiği merkezi singleton'dur: saveObject ile kaydetme, execute ile okuma ve deleteObject ile silme. Her işlem eşzamansızdır ve bir closure aracılığıyla sonuç döndürür, bu da uygun hata yönetimi gerektirir.

Sorgular birkaç türe ayrılır: HKSampleQuery ölçütlere göre kayıtları almak için, HKStatisticsQuery toplu veriler için — toplam, ortalama, minimum, maksimum — ve HKObserverQuery gerçek zamanlı değişiklikleri izlemek için. Periyodik arka plan güncellemeleri için HKHeartbeatSeriesQuery kullanılır.

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)

Bir Uygulamaya HealthKit Entegrasyonu

HealthKit entegrasyonu, Xcode'da HealthKit yeteneğini etkinleştirmek ve projeye entitlement eklemekle başlar. Bundan sonra uygulama, requestAuthorization çağrısı aracılığıyla belirli veri türlerine erişim izni ister. Önemli: HealthKit simülatörde kullanılamaz ve iOS'lu fiziksel bir cihaz gerektirir.

Entegrasyon süreci üç aşamadan oluşur: veri türlerini tanımlama, yetkilendirme isteme ve okuma ve yazma işlemlerini gerçekleştirme. Her aşama eşzamansızdır ve hataları işlemelidir — kullanıcı, anahtarlı sistem iletişim kutusunda herhangi bir veri türüne erişimi reddedebilir.

Apple araştırmalarına göre, HealthKit entegrasyonuna sahip uygulamalar %40 daha yüksek kullanıcı katılımı gösterir. Başarının anahtar faktörü, yetkilendirme isteği açıklamasında uygulamanın neden belirli sağlık verilerine ihtiyaç duyduğunu açıklamaktır.

Yetkilendirme İsteği

Yetkilendirme isteği ilk başlatmada bir kez yapılır. Uygulama iki tür kümesi belirtir — okuma ve yazma için. Kullanıcı, her veri türü için anahtarlarla bir sistem iletişim kutusu görür ve gereksiz kategorileri reddederek seçici olarak erişim izni verebilir.

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("Yetkilendirme alındı")
    }
}

HealthKit Güvenliği

HealthKit, donanım şifrelemesi, uygulama sandboxing'i ve ayrıntılı izinler dahil olmak üzere çok katmanlı bir güvenlik modeli uygular. Tüm sağlık verileri cihazda şifrelenmiş olarak saklanır ve bir kez istenen kullanıcının ayrı onayı olmadan iCloud'a iletilmez.

Önemli bir özellik Intent mekanizmasıdır: uygulamanın verilere sürekli arka plan erişimi yoktur. Her okuma veya yazma isteği işletim sistemi tarafından doğrulanır ve kullanıcı, uygulamayı yeniden yüklemeye gerek kalmadan Ayarlar — Gizlilik — Sağlık üzerinden istediği zaman izni iptal edebilir.

Apple, App Store İnceleme Yönergeleri'nde HealthKit kullanımını sıkı bir şekilde düzenler. Uygulama, açık onay olmadan HealthKit verilerini üçüncü taraflara aktaramaz, bunları reklam veya hedefleme için kullanamaz ve beyan edilen işlevsellik için gerekenden daha uzun süre saklayamaz.

Sınırlamalar ve Kısıtlamalar

HealthKit'in çeşitli sınırlamaları vardır: cihazdaki maksimum veritabanı boyutu 1 GB, tek bir sorgudaki kayıt sayısı sınırı 1000 ve aynı veri türleri arasındaki minimum aralık 1 saniyedir. Çerçeve ayrıca arka plan güncellemelerini sınırlar — günde en fazla 60 HKObserverQuery tetiklemesi.

Bu sınırlamalar performansla dengelenir: 1000 kayıt okumak ortalama 50–100 milisaniye sürer ve tek bir kayıt yazmak 10 milisaniyeden az sürer. Büyük veri hacimleri için, tek tek kayıtları getirmek yerine ön toplama ile HKStatisticsCollectionQuery kullanılması önerilir. HealthKit sorguları eşzamansız olarak işler — uygulama HKHealthStore'dan veri beklerken bloke olmaz.