需求:
1.最近需要在APP当中增加记步功能,提升用户的活跃率。并且希望能够保留用户的健康数据。
2.根据苹果健康的数据,查询用户最近今天的步行和运动距离。
3.用户在页面当中开始记步,记录用户的步行数据,存入本地数据库。
前期:
1.查看计步器开发,常用的技术。了解到iOS当中,针对用户运动健康数据以及计步器功能主要涉及两个框架HealthKit,CoreMotion(最低支持到iOS8.0,硬件5S及以上)。
参考:http://www.jianshu.com/p/1dd6ad5b1520 (包括在应用中打开HealthKit,Info.plist增加权限)
有一点需要特别注意:当打开HealthKit过后,会在info.plist的字段Required device capabilities 当中增加healthkit,这个字段的存在会在打包上传到itunes connect的时候报错,信息如下:
ERROR ITMS-90098: "This bundle is invalid. The key UIRequiredDeviceCapabilities contains value 'healthkit' which is incompatible with the MinimumOSVersion value of '7.0'."
WARNING ITMS-90109: "This bundle is invalid. The key UIRequiredDeviceCapabilities in the Info.plist may not contain values that would prevent this application from running on devices that were supported by previous versions. Refer to QA1623 for additional information: https://developer.apple.com/library/ios/#qa/qa1623/_index.html"
因为我们线上的APP 版本包含7.0系统以及IPAD的支持,参考stack overflow的解答,删除info.plist当中的字段即可重新打包上传。
2.查阅APPLE官方文档关于HealthKit,CoreMotion的说明。
https://developer.apple.com/documentation/healthkit (官方HealthKit说明)
https://developer.apple.com/documentation/coremotion(官方CoreMotion说明)
3.看如下的代码处理过程(有什么使用不当的欢迎指出):
(1)框架导入:
#import
#import
(2)添加记步管理分类
@interface KKPedometerManager : NSObject
+ (instancetype)sharedManager;
//查询Health kit 计步数据
- (BOOL)checkHealthKitStepCountDataWithDate:(NSDate *)date Completion:(void(^)(NSString *result,NSString *timeValue))completion;
//查询Health kit 跑步+走路里程
- (BOOL)checkHealthKitMilesDataCompletion:(void(^)(NSString *result,NSString *timeValue))completion;
//计步器查询当天的计步数据
- (void)quereSportsDataforTodayCompltion:(void(^)(NSString *stepCount,NSString *milesCount,NSError *error))completion;
//开始计步器计步
- (void)startPedometerCountWithModelData:(KKSportsModel *)model Compltion:(void(^)(NSString *stepCount,NSString *milesCount))completion;
//停止计步
- (void)stopPedomertCount;
@end
(3)实现数据查询及开启记步数据
+(instancetype)sharedManager
{
static KKPedometerManager *manager;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
manager = [[self alloc] init];
});
return manager;
}
- (instancetype)init
{
if (self = [super init]) {
self.healthStore =[[HKHealthStore alloc] init];
}
return self;
}
- (BOOL)checkHealthKitStepCountDataWithDate:(NSDate *)date Completion:(void (^)(NSString *, NSString *))completion
{
BOOL isSupport = [HKHealthStore isHealthDataAvailable];
if (isSupport) {
self.quereDate = date;
HKQuantityType *stepType = [HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount];
HKQuantityType *walkType = [HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierDistanceWalkingRunning];
// HKQuantityType *energy = [HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierActiveEnergyBurned];
NSSet *readType = [NSSet setWithObjects:stepType, walkType,nil];
[self.healthStore requestAuthorizationToShareTypes:nil readTypes:readType completion:^(BOOL success, NSError * _Nullable error) {
if (success) {
HKSampleType *sampletype = [HKSampleType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount];
[self requestSportSDataType:sampletype Completion:completion];
}else{
if (completion) {
completion(nil,error.localizedDescription);
}
[[UIApplication sharedApplication].keyWindow makeToast:@"健康数据不允许访问,请在设置-隐私-健康中打开" duration:3.0 position:@"center"];
}
}];
}else{
[[UIApplication sharedApplication].keyWindow makeToast:@"设备不支持数据" duration:2.0 position:@"center"];
}
return isSupport;
}
- (BOOL)checkHealthKitMilesDataCompletion:(void(^)(NSString *result,NSString *timeValue))completion
{
BOOL isSupport = [HKHealthStore isHealthDataAvailable];
if (isSupport) {
HKQuantityType *stepType = [HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierStepCount];
HKQuantityType *walkType = [HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierDistanceWalkingRunning];
// HKQuantityType *energy = [HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierActiveEnergyBurned];
NSSet *readType = [NSSet setWithObjects:stepType, walkType,nil];
[self.healthStore requestAuthorizationToShareTypes:nil readTypes:readType completion:^(BOOL success, NSError * _Nullable error) {
if (success) {
HKSampleType *sampletype = [HKSampleType quantityTypeForIdentifier:HKQuantityTypeIdentifierDistanceWalkingRunning];
[self requestSportSDataType:sampletype Completion:completion];
}else{
[[UIApplication sharedApplication].keyWindow makeToast:@"健康数据不允许访问,请在设置-隐私-健康中打开" duration:3.0 position:@"center"];
}
}];
}else{
[[UIApplication sharedApplication].keyWindow makeToast:@"设备不支持记步数据" duration:2.0 position:@"center"];
}
return isSupport;
}
- (void)requestSportSDataType:(HKSampleType *)sampletype Completion:(void(^)(NSString *result,NSString *timeValue))completion
{
//NSSortDescriptors用来告诉healthStore怎么样将结果排序。
NSSortDescriptor *start = [NSSortDescriptor sortDescriptorWithKey:HKSampleSortIdentifierStartDate ascending:NO];
NSSortDescriptor *end = [NSSortDescriptor sortDescriptorWithKey:HKSampleSortIdentifierEndDate ascending:NO];
HKSampleQuery *sampleQuerey = [[HKSampleQuery alloc] initWithSampleType:sampletype predicate:[self predicateForSamplesToday] limit:HKObjectQueryNoLimit sortDescriptors:@[start,end] resultsHandler:^(HKSampleQuery * _Nonnull query, NSArray<__kindof HKSample *> * _Nullable results, NSError * _Nullable error) {
if(!error && results) {
NSInteger totalNumbers = 0;
NSInteger minutes = 0;
if ([sampletype.identifier isEqualToString:HKQuantityTypeIdentifierStepCount]) {
HKUnit *stepUnit = [HKUnit countUnit];
for(HKQuantitySample *quantitySample in results) {
HKQuantity *quantity = quantitySample.quantity;
minutes += [[KKDateHandleTool sharedDateHandler] dealMinuteNumbersFromStartDate:quantitySample.startDate endDate:quantitySample.endDate];
NSInteger usersHeight = (NSInteger)[quantity doubleValueForUnit:stepUnit];
totalNumbers += usersHeight;
}
NSString *totalSteps = [NSString stringWithFormat:@"%ld",(long)totalNumbers];
NSString *totalMinutes = [NSString stringWithFormat:@"%.0f",roundf(minutes/60.0)];
if (completion) {
completion(totalSteps,totalMinutes);
}
}else if ([sampletype.identifier isEqualToString:HKQuantityTypeIdentifierDistanceWalkingRunning] ){
HKUnit *stepUnit = [HKUnit meterUnit];
//记录查询的日期
NSString * quereDateString = [[KKDateHandleTool sharedDateHandler] stringFromDate:self.quereDate];
for(HKQuantitySample *quantitySample in results) {
HKQuantity *quantity = quantitySample.quantity;
NSInteger usersHeight = (NSInteger)[quantity doubleValueForUnit:stepUnit];
totalNumbers += usersHeight;
}
NSString *totalMilesMeter = [NSString stringWithFormat:@"%.2f",(totalNumbers /1000.0)];
if (completion) {
completion(totalMilesMeter,quereDateString);
}
}
}else{
if (completion) {
completion(@"",@"");
}
}
}];
[self.healthStore executeQuery:sampleQuerey];
}
- (NSPredicate *)predicateForSamplesToday {
NSDate *today = self.quereDate;
NSDate *fromDate = [self dateWithYear:[NSDate currentYear:today] month:[NSDate currentMonth:today] day:[NSDate currentDay:today] hour:0 minute:0 second:0];
NSDate *endDate = [self dateWithYear:[NSDate currentYear:today] month:[NSDate currentMonth:today] day:[NSDate currentDay:today] hour:23 minute:59 second:59];
NSPredicate *predicate = [HKQuery predicateForSamplesWithStartDate:fromDate endDate:endDate options:HKQueryOptionNone];
return predicate;
}
- (NSDate *)dateWithYear:(NSInteger)year
month:(NSInteger)month
day:(NSInteger)day
hour:(NSInteger)hour
minute:(NSInteger)minute
second:(NSInteger)second{
NSCalendar *gregorian = [[NSCalendar alloc] initWithCalendarIdentifier:NSCalendarIdentifierGregorian];
NSTimeZone *systemTimeZone = [NSTimeZone systemTimeZone];
NSDateComponents *dateComps = [[NSDateComponents alloc] init];
[dateComps setCalendar:gregorian];
[dateComps setYear:year];
[dateComps setMonth:month];
[dateComps setDay:day];
[dateComps setTimeZone:systemTimeZone];
[dateComps setHour:hour];
[dateComps setMinute:minute];
[dateComps setSecond:second];
return [dateComps date];
}
- (void)quereSportsDataforTodayCompltion:(void (^)(NSString *, NSString *, NSError *))completion
{
if ([CMPedometer isStepCountingAvailable]) {
if (!self.pedometer) {
self.pedometer = [[CMPedometer alloc] init];
}
NSDate *today = [NSDate date];
NSInteger currentYear = [NSDate currentYear:today];
NSInteger currentMonth = [NSDate currentMonth:today];
NSInteger currentDay = [NSDate currentDay:today];
NSDate *fromDate =[NSDate dateWithYear:currentYear month:currentMonth day:currentDay hour:0 minute:0 second:0];
NSDate *endDate = [NSDate dateWithYear:currentYear month:currentMonth day:currentDay hour:23 minute:59 second:59];
//能够查询出来当天的步数统计数据
[self.pedometer queryPedometerDataFromDate:fromDate toDate:endDate withHandler:^(CMPedometerData * _Nullable pedometerData, NSError * _Nullable error) {
if (error) {
dispatch_async(dispatch_get_main_queue(), ^{
if (completion) {
completion(nil,nil,error);
}
});
}else {
dispatch_async(dispatch_get_main_queue(), ^{
NSString *numberOfSteps = [NSString stringWithFormat:@"%@",pedometerData.numberOfSteps];
NSString *distance = [NSString stringWithFormat:@"%.2f",[pedometerData.distance floatValue]/1000.0];
if (completion) {
completion(numberOfSteps,distance,nil);
}
});
}
}];
}else{
// [[UIApplication sharedApplication].keyWindow makeToast:@"" duration:2.0 position:@"center"];
}
}
- (void)startPedometerCountWithModelData:(KKSportsModel *)model Compltion:(void (^)(NSString *, NSString *))completion
{
NSDate *startCountDate = [NSDate dateWithTimeIntervalSinceNow:0];
__block CGFloat last = [model.stepCount doubleValue];
__block CGFloat lastDistance = [model.distance doubleValue];
[self.pedometer startPedometerUpdatesFromDate:startCountDate withHandler:^(CMPedometerData * _Nullable pedometerData, NSError * _Nullable error) {
dispatch_async(dispatch_get_main_queue(), ^{
if (error && completion) {
if (completion) {
completion(@"0",@"0");
}
return ;
}
CGFloat newStep = [pedometerData.numberOfSteps doubleValue] + last;
NSString *newDistance = [NSString stringWithFormat:@"%.2f",([pedometerData.distance floatValue] + lastDistance*1000)/1000.0];
NSString *newStepCount = [NSString stringWithFormat:@"%.0f",newStep];
if (completion) {
completion(newStepCount,newDistance);
}
});
}];
}
- (void)stopPedomertCount
{
[self.pedometer stopPedometerUpdates];
}
其他:审核注意事项
审核出现了以下的被拒问题:
Guideline 4.2.1 - Design - Minimum Functionality
Your app uses the HealthKit or CareKit APIs but does not indicate integration with the Health app in your app description and clearly identify the HealthKit and CareKit functionality in your app's user interface.
Next Steps
To resolve this issue, please revise your app description to specify that your app integrates with the Health app.
查阅审核开发文档:
https://developer.apple.com/app-store/review/guidelines/#developer-information
然后APP信息描述当中加入了以下说明:
温馨提示:
-XXXX已接入HealthKit,可同步数据到【健康】。
-持续使用跑步GPS在后台会影响电池续航时间。
Note:
Continued use of GPS running in the background can dramatically decrease battery life.