#import <HealthKit/HealthKit.h>

BOOL isSupport = [HKHealthStore isHealthDataAvailable];

HKHealthStore *healthStore = [[HKHealthStore alloc] init];
NSSet *shareType = [NSSet setWithObject:[HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount]];
NSSet *readType = [NSSet setWithObject:[HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount]];
[healthStore requestAuthorizationToShareTypes:shareType readTypes:readType completion:^(BOOL success, NSError * _Nullable error) { }]; 

[HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount];

[HKObjectType categoryTypeForIdentifier:HKCategoryTypeIdentifierSleepAnalysis];

[HKObjectType characteristicTypeForIdentifier:HKCharacteristicTypeIdentifierBiologicalSex];

[HKObjectType workoutType];

1.HKWorkoutTypeIdentifier  体能训练

[HKObjectType activitySummaryType];

转自：https://www.jianshu.com/p/10accd63cae7

不同的健康应用需求大致可以分为三种

1.统计分析 (Statistical Analysis)
2.允许用户输入设备(Enter Information)
3.允许来自第三方的设备数据(Application From Health Providers)
为此，apple开发了Healthkit来处理这些需求

1. Data in HealthKit

在不同的国家，对同一个概念有着不同的度量单位。所以在HealthKit中，提出了HKUnit的概念。他就是为了帮助开发者做单位转换的。HKUnit代表了一个在度量标准或单位系统中的特定单位

1.1 HKUnit

HKUnit *g = [HKUnit gramUnit]; //克
HKUnit *dL = [HkUnit literUnitWithMetricPrefix:HKMetricPrefixDeci];//分升
HKUnit *gPerdL = [g unitDivideByUnit:dL]; // 克/分升  g/dL
//对于复杂的组合单位，也可以使用这种方式创建 HKUnit *gPerdL = [HKUnit unitFromString:@"g/dL"]; 

1.2 HKQuantity

他可以用于进行单位转换

HKUnit *gramUnit = [HKUnit gramUnit];
HKQuantity *grams = [HKQuantity quantityWithUnit:gramUnit doubleValue:20]; //20克
double kg = [grams doubleValueForUnit:[HKUnit unitFormString:@"kg"]];//转换为了0.02kg 

但是不是所有的单位都是可以这样进行转换的，如果转化为一个不兼容的单位时，就会报错。所以我们可以使用下面的方法进行预判断。

BOOL kgCompatible = [grams isCompatibleWithUnit:[HKUnit unitFromString:@"kg"]]; // YES
BOOL kgCalComtible = [grams isCompatibleWithUnit:[HKUnit kilocalorieUnit]];  // NO 

也就是说HKQuantity就是带有单位的数量值

1.3 HKObjectType

Object types代表了HealthKit中的所有数据类型。在HealthKit中有超过60种类型，大多数的类型都会整合到他自己类中。所有的这些类，都是继承于HKObjectType。所有的类分为两个基本大类。(1)HKCharacteristicType:他代表一种不会改变的一些类型，比如生日、性别等。(2)HKSampleType:代表会随时间改变的类型，它们能在一定特定的时间点里获取的到类型的样本。在这个类型下面又分为两种类型
1>HKQuantityType ，比如血压
2>HKCategoryType,代表可以分类的类型，比如睡眠分析。具体结构如图1

图1.png

KHObjectType的创建：每一种类型都有的他自己的identifier。当然你不能创建自己的objectType和对应的identifier。但是我们可以理解下他的构造规则。

HKQuantityTypeIdentifierHeartRate
HKQuantityTypeIdentifier:代表他属于那种类型的数据
HeartRate :代表他的名字

只要你有了某个类型的identifier，你就可以使用构造方法进行创建

+(HKQuantityType *)quantityTypeForIdentifier:(NSString   *)identifier;
+(HKCategoryType *)categoryTypeForIdentifier:(NSString *)identifier;
+(HKCharacteristicType *)characteristicTypeForIdentifier:(NSString *)identifier;
//显然三种构造方法，对应了三种不同的类型

1.4 HKObject

在HealthKit中的所有存储数据都是HKObject的子类，具体结构如下图2

图2

HKQuantitySample有quantityType和quantity两个属性。qantityType代表了这个对象数据属于那种类型，quantity代表了具体的数值和单位。quantity的单位和quantityType需要匹配。每一个quantity type都对应了一种特定的单位。如果没有对应，则会抛出异常。如图3

图3.png

HKCategorySample和HKQuantitySample类似，他也有categoryType代表他属于那种类型的数据，同时他有value值。这里要记住categoryType是一种可以的数值都是可以被枚举出来的。所以，每种类型都有一套对应的枚举值，value值必须对应其中的一个数值，如果一种出现了异常的数值，就会报错。见图4

图4.png

这些类型都是继承自HKSample，因为sample一种可以在特定时间进行取样的的数据，所以，他有startDate和endDate。对于有些数据，比如果你想获取体重这种及时性非常高的值(总不能获取一段时间的体重吧)，所以他的startDate和endDate是相同的，而对于那种读取一定时间内的数值的数据类型，他们的startDate和endDate会不一样。每种sample也都有sampleType属性，他的实际类型和子类的type类型相同。如图5

图5.png

以上者这些都是继承于HKObject类型，每个Objec类型都有一个UUID类型的属性，他是这个sample的唯一标识。他也有source属性，他记录了数据的来源。metadata对象是NSDictionary类型的属性，所以可以在里面存放任何你想存放的数据，这个属性主要是为了扩展准备的。苹果也开发者准备了一些metadatakey。如图6

图6.png

Create an HKObject

NSString * identifier = HKQuantityTypeIdentifierBodyTemperature;
HKquantityType * tempType = [HKObjectType quantityTypeForIdentifier:identifier];
HKQuantity * myTemp = [HKQuantity quantityWithUnit:                 [HKUnit degreeFahrenheiUnit] doubleValue:98.6];
NSDictionary *meta = @{HKMetadataKeyBodyTemperatureSensorLocation : @(HKBodyTemperatureSensorLocationEar)};
HKQuantitySample *temperatureSample = [HKQuantitySample quantitySampleWithType:tempTypequantity:myTempstartDate:[NSDate date]endDate:[NSDate date] metadate:meta]; 

</br>

2. Save Data

self.store = [[HKHealthStore alloc] init];
...
HKQuantitySample *mySample = [self newSample];
[self.store saveObject:mySample withCompletion:^(BOOL success,NSError *error){ if (success) { NSLog(@"object saved!"); } }]; 

</br>

3 Ask For Data

3.1 Characteristics

前面讲到，HKCharacteristicType是一种基本不变的数据类型，所以我们可以直接去获取对应的数据，比如，生日、血型等

NSError *error;
NSDate *dateOfBirth = [self.store dateOfBirthWithError:&error];

3.2 Queries

所有的Query都继承自HKQuery

@interface HKQuery
//注定要检索的数据类型
@property (readonly) HKSampleType *sampleType //过滤返回的数据 @Property (readonly) NSPredicate *predicate @end 创建Predicate的几种方式 //1.直接是使用构造方法 [NSPredicate predicateWithFormat:@"%K > %@", HKPredicateKeyPathQuantity,weight]; //2.更加简便的方式 NSPredicateOperatorType greaterThan = NSGreaterThanPredicateOperatorType; [HKQuery perdicateForQuantitySampleWithOperatorType:greaterThan quantity:weight]; 

3.2.1 HKSampleQuery

Limit:每个query都有个limit值，他指定了请求返回值的数量，如果你不想限制检索的结果，你可以设置limit值为HKObjectQueryNoLimit。
Sort Order:决定返回的数据的排列顺序的数组。

//Code demo
HKQuantityType *bloodSugar = ...
NSString *endKey = HKSampleSortIdentifierEndDate;
NSSortDescriptor *endDate = [NSSortDescriptor sortDescriptorWithKey:endKey ascending:NO]; HKSampleQuery *query = [[HKSampleQuery alloc] initWithSampleType:bloodSugar perdicate:nil sortDescriptor:@[endDate] resultsHandle:^(HKSampleQuery * query, NSArray *results, NSError *error) { HKQuantitySample *sample = [results lastObject]; NSLog(@"Sample: %@",sample); }] 

3.2.2 HKObserverQuery

他会监听数据库中的数据改变。所以当一个新的数据被添加或移除的时候都会被调用。

HKQuantityType *bloodSugar = ...
HKObserverQuery *query;
query = [HKObserveQuery alloc]   initWithSampleType:bloodSugarperdicate:nilupdateHandler:^(HKObserverQuery *query,HKObserverCompletionHandler handler,NSError *error)
{NSLog(@"Updated");
}

3.2.3 HKAnchoredObectQuery

Anchor是你见的最后一条数据，当anchor为0时，表示还没有设置anchor，当每一次回调的时候会返回给你一个新的anchor

self.lastAnchor = 0
...
HKQuantityType *bloodSugar = ...
HKAnchoredObjectQuery *query;
query = [[HKAnchoredObjectQuery alloc] initWithType:bloodSugar perdicate:nilanchor:self.lastAnchorlimit:HKObjectQueryLimitcompletionHandler:^(HKAnchoredObjectQuery *query,NSArray *results, NSUInter newAnchor, NSError *error) { self.lastAnchor = newAnchor; }]; 

</br>

4. executeQuery

@interface HKHealthStore: NSObject
- (void)executeQuery:(HKQuery *)query; - (void)stopQuery:(HKQuery *)query; @end 

stopQuery方法可以在任何时候调用,他回取消当前的检索操作，并阻止其回调。你可以调用任意次数的stopQuery，但是只能在上一个query结束前，调用一次query。通常情况下，检索执行一次就会停止。但是像ObserverQuery这样的long runing query（这里还是原文比较有味道）需要手动去停止。
</br>

5.Asking for Statistics

HKStatistics
一个HKStatistics对象是各种统计数据的集合，比如sum、min、max 和 average。
你可以统计所有的数据，或者只统计特定来源的数据
⚠️注意，Statstics只对quantity类型的数据有效。
这里将数据分为离散数据(discrete)和聚合数据(cumulative)
离散数据：比如身高、体重、血压等
聚合数据：比如步数、燃烧的脂肪量

区别：前者是单次取样获取的有效数据，后者是持续取样的到一段时间的累加的数据

HKStatisticsQuery

HKQuantityType *stepCount = ...
NSPredicate *today = ...
HKStatisticsOptions sumOptions =       HKStaticsOptionCumulativeSum;
HKStatisticsQuery *query;
query = [HKStatisticsQuery alloc] initWithQuantityType:stepCountquantitySamplePerdicate:todayoptions:sumOptionscompletionHandler:^(HKStaticsQuery *query,HKStatics *result,NSError *error)
{HKQuantity  *sum = [result sumQuantity];
}

HKStaticsCollectiion

@interface HKStatisticsCollection:NSObject
- (NSArray *)statistics - (HKStatistics *)statisticsForDate:(NSDate *)date; - (void)enumberateStatisticsFromDate:(NSDate *)startDate toDate:(NSDate *)endDate block:(void(^)(HKStatistics *stats,BOOL *stop))block; @end 

</br>

6.Privacy and Permissions

//请求授权
- (void)requestAuthorizationToShareTypes:(NSSet *)typesToSharereadTypes:(NSSet *)typesToReadcompletion:(void(^)(BOOL success, NSError *error))completion; //监测授权情况 typedef NS_ENUM(NSInteger, HKAuthorizationStatus) { HKAuthorizationStatusNotDetermined = 0, HKAuthorizationStatusSharingDenied, HKAuthorizationStatusSharingAuthorized, } - (HKAuthrizationStatus)authorizationStatusForType: (HKObjectType *)type 

</br>

7.Localization

NSFormatter 能帮助开发者进行本地化处理

NSnumberFormatter
NSDateFormatter
NSByteCountFormatterNSMassFormatter
NSLengthFormatter NSEnergyFormatter //Code demo NSMassFormatter *formatter = [[NSMassFormatter alloc] init] formatter.forPersonMassUse = YES; HKQuantity * weight = ... double weightKg = [weight doubleValueForUnit:[HKUnit unitFromString:@"kg"]]; NSString *localizedString = [formatter stringFromKilograms:weightInKg];