技术问询：能否在HealthKit中添加样本描述及为血糖测量存储用户描述？

当然可以给HealthKit中的样本（包括血糖测量数据）附加用户描述信息！HealthKit提供了官方支持的方式来存储这类自定义备注内容，下面我给你一步步拆解具体实现：

1. 使用官方元数据键存储描述 #

HealthKit专门定义了HKMetadataKeyNote这个元数据键，用于存储用户对样本的备注或描述。这个字段是系统认可的，不仅你的App可以读写，苹果自带的「健康」App也能识别并显示这些备注，非常实用。

示例：保存带描述的血糖样本 #

下面是Swift代码示例，展示如何创建并保存带有用户描述的血糖测量数据：

import HealthKit

// 初始化HealthStore实例
let healthStore = HKHealthStore()

// 确保血糖类型在当前设备可用
guard let bloodGlucoseType = HKObjectType.quantityType(forIdentifier: .bloodGlucose) else {
    fatalError("血糖测量类型在当前设备不被支持")
}

// 假设这是用户输入的描述文本（比如从App的输入框获取）
let userDescription = "餐后2小时，早餐吃了燕麦粥"

// 创建血糖测量值（示例：8.2 mmol/L，注意单位要正确）
let glucoseUnit = HKUnit.moleUnit(with: .milli, molarMass: HKUnitMolarMassBloodGlucose)
let glucoseQuantity = HKQuantity(unit: glucoseUnit, doubleValue: 8.2)

// 创建带元数据的血糖样本
let glucoseSample = HKQuantitySample(
    type: bloodGlucoseType,
    quantity: glucoseQuantity,
    start: Date(), // 测量开始时间
    end: Date(),   // 测量结束时间（即时测量的话和开始时间一致）
    metadata: [HKMetadataKeyNote: userDescription] // 附加用户描述
)

// 保存样本到HealthKit
healthStore.save(glucoseSample) { success, error in
    DispatchQueue.main.async {
        if let error = error {
            print("保存失败：\(error.localizedDescription)")
        } else if success {
            print("带描述的血糖样本已成功保存！")
        }
    }
}

2. 读取样本时获取用户描述 #

当你从HealthKit查询血糖数据时，可以直接从样本的metadata字典中取出HKMetadataKeyNote对应的值：

// 构建查询条件：获取所有历史血糖数据
let predicate = HKQuery.predicateForSamples(
    withStart: Date.distantPast,
    end: Date(),
    options: .strictStartDate
)

// 按时间倒序排序（最新的在前）
let sortDescriptor = NSSortDescriptor(
    key: HKSampleSortIdentifierStartDate,
    ascending: false
)

// 创建样本查询
let query = HKSampleQuery(
    sampleType: bloodGlucoseType,
    predicate: predicate,
    limit: 20, // 最多获取20条数据
    sortDescriptors: [sortDescriptor]
) { _, samples, error in
    guard let glucoseSamples = samples as? [HKQuantitySample], error == nil else {
        print("查询失败：\(error?.localizedDescription ?? "未知错误")")
        return
    }
    
    // 遍历查询结果，提取血糖值和用户描述
    for sample in glucoseSamples {
        let glucoseValue = sample.quantity.doubleValue(for: glucoseUnit)
        let userNote = sample.metadata?[HKMetadataKeyNote] as? String ?? "无备注"
        print("血糖值：\(glucoseValue) mmol/L | 备注：\(userNote)")
    }
}

// 执行查询
healthStore.execute(query)

注意事项 #

• 权限申请：在使用HealthKit之前，必须在Info.plist中添加对应的权限描述（NSHealthShareUsageDescription和NSHealthUpdateUsageDescription），并向用户请求读写血糖数据的权限，否则无法进行保存或查询操作。
• 元数据限制：虽然HKMetadataKeyNote可以存储文本，但不要写入过长的内容，HealthKit对元数据的总大小有一定限制，日常的简短描述完全足够。
• 兼容性：使用官方的HKMetadataKeyNote而非自定义元数据键，能保证你的备注在其他支持HealthKit的App中也能正常显示，比如系统的「健康」App会在血糖条目下方直接展示这个备注。

内容的提问来源于stack exchange，提问作者Szymon Klimaszewski