iOS开发------获取系统联系人(AddressBook篇)

AddressBook是Apple提供给我们获取系统联系人的一个很方便类库，与其说方便，其实刚开始还是比较崩溃的，从开发文档来看，它还是偏向于C语言，并且不在ARC的控制之下，虽然在iOS9.0之后会被Contacts.framework替代，但在工作中要对最低版本进行兼容，了解一下这个类库还是很有必要的。这里就介绍一下获取联系人信息的那些方法，对于修改，添加删除等操作，想留在下一篇介绍AddressBookUI这个类库的时候来写一下。

代码GitHub:https://github.com/YRunIntoLove/YAdressBookDemo

获取权限

iOS6.0之后，苹果对于用户隐私就加强了，所有调用系统权限都需要用户授权才可以进行之后的操作，因此在获取通讯录的时候要检测一下有没有权限(这一点在定位，相机等操作上也都看出)：

/***  检测权限并作响应的操作*/
- (void)checkAuthorizationStatus
{switch (ABAddressBookGetAuthorizationStatus()){//存在权限case kABAuthorizationStatusAuthorized://获取通讯录[self obtainContacts:self.addressBook];break;//权限未知case kABAuthorizationStatusNotDetermined://请求权限[self requestAuthorizationStatus];break;//如果没有权限case kABAuthorizationStatusDenied:case kABAuthorizationStatusRestricted://需要提示//弹窗提醒[self showAlertController];break;default:break;}
}

请求权限的方法如下:

/***  请求通讯录的权限*/
- (void)requestAuthorizationStatus
{//避免强引用__weak typeof(self) copy_self = self;ABAddressBookRequestAccessWithCompletion(self.addressBook, ^(bool granted, CFErrorRef error) {//权限得到允许if (granted == true){//主线程获取联系人dispatch_async(dispatch_get_main_queue(), ^{[copy_self obtainContacts:self.addressBook];});}});
}

请求联系人列表

为Demo中是楼主自行构建的Model，因此代码就显得简略了好多，后面会附上CFRecord转模型的代码:

/***  获取通讯录中的联系人*/
- (void)obtainContacts:(ABAddressBookRef)addressBook
{//按照添加时间请求所有的联系人CFArrayRef contants = ABAddressBookCopyArrayOfAllPeople(addressBook);//按照排序规则请求所有的联系人
//    ABRecordRef recordRef = ABAddressBookCopyDefaultSource(addressBook);//这里的firstName是按照姓名属性中的firstName来排序的，并不是按照全称来排序
//    CFArrayRef contants = ABAddressBookCopyArrayOfAllPeopleInSourceWithSortOrdering(addressBook, recordRef, kABPersonSortByFirstName);//存放所有联系人的数组NSMutableArray <YContactObject *> * contacts = [NSMutableArray arrayWithCapacity:0];//遍历获取所有的数据for (NSInteger i = 0; i < CFArrayGetCount(contants); i++){//获得People对象ABRecordRef recordRef = CFArrayGetValueAtIndex(contants, i);//获得contact对象YContactObject * contactObject = [YContactObjectManager contantObject:recordRef];//添加对象[contacts addObject:contactObject];}//释放资源，因为不在ARC下，retain或者copy之后记得releaseCFRelease(contants);//进行回调赋值ContactDidObatinBlock copyBlock  = self.contactsDidObtainBlockHandle;//进行数据回调copyBlock([NSArray arrayWithArray:contacts]);
}

获取联系人的姓名属性

为了让代码可读性更好一点，在进行转型的时候写了如下方法，是为了方便将CFStringRef通过桥接__bridge转型成NSString对象:

/***  根据属性key获得NSString**  @param property 属性key*/
+ (NSString *)contactProperty:(ABPropertyID) property
{return (__bridge NSString *)(ABRecordCopyValue(self.recordRef, property));
}

获取姓名相关属性方法如下:

/***  获得姓名的相关属性*/
+ (YContactNameObject *)contactNameProperty
{//初始化对象YContactNameObject * nameObject = [[YContactNameObject alloc]init];nameObject.givenName = [self contactProperty:kABPersonFirstNameProperty];                   //名字nameObject.familyName = [self contactProperty:kABPersonLastNameProperty];                   //姓氏nameObject.middleName = [self contactProperty:kABPersonMiddleNameProperty];                 //名字中的信仰名称（比如Jane·K·Frank中的K）nameObject.namePrefix = [self contactProperty:kABPersonPrefixProperty];                     //名字前缀nameObject.nameSuffix = [self contactProperty:kABPersonSuffixProperty];                     //名字后缀nameObject.nickName = [self contactProperty:kABPersonNicknameProperty];                     //名字昵称nameObject.phoneticGivenName = [self contactProperty:kABPersonFirstNamePhoneticProperty];   //名字的拼音音标nameObject.phoneticFamilyName = [self contactProperty:kABPersonLastNamePhoneticProperty];   //姓氏的拼音音标nameObject.phoneticMiddleName = [self contactProperty:kABPersonMiddleNamePhoneticProperty]; //英文信仰缩写字母的拼音音标return nameObject;
}

获取联系人的类型

/***  获得联系人类型信息*/
+ (YContactType)contactTypeProperty
{//获得类型属性CFNumberRef typeIndex = ABRecordCopyValue(self.recordRef, kABPersonKindProperty);//表示是公司联系人if (CFNumberCompare(typeIndex, kABPersonKindOrganization, nil) == kCFCompareEqualTo){//释放资源CFRelease(typeIndex);return YContactTypeOrigination;}return YContactTypePerson;
}

获取联系人的头像图片

/***  获得联系人的头像图片*/
+ (UIImage *)contactHeadImagePropery
{//首先判断是否存在头像if (ABPersonHasImageData(self.recordRef) == false)//没有头像，返回nil{return nil;}//开始获得头像信息NSData * imageData = (__bridge NSData *)(ABPersonCopyImageData(self.recordRef));//获得头像原图
//    NSData * imageData = CFBridgingRelease(ABPersonCopyImageDataWithFormat(self.recordRef, kABPersonImageFormatOriginalSize));return [UIImage imageWithData:imageData];
}

获取联系人的电话信息

/***  获得电话号码对象数组*/
+ (NSArray <YContactPhoneObject *> *)contactPhoneProperty
{//外传数组NSMutableArray <YContactPhoneObject *> * phones = [NSMutableArray arrayWithCapacity:0];//获得电话号码的多值属性ABMultiValueRef values = ABRecordCopyValue(self.recordRef, kABPersonPhoneProperty);for (NSInteger i = 0; i < ABMultiValueGetCount(values); i++){YContactPhoneObject * phoneObject = [[YContactPhoneObject alloc]init];//开始赋值phoneObject.phoneTitle = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(values, i)); //电话描述(如住宅、工作..)phoneObject.phoneNumber = (__bridge NSString *)ABMultiValueCopyValueAtIndex(values, i);                                 //电话号码//添加数据[phones addObject:phoneObject];}//释放资源CFRelease(values);return [NSArray arrayWithArray:phones];
}

获取联系人的工作信息

/***  获得工作的相关属性*/
+ (YContactJobObject *)contactJobProperty
{YContactJobObject * jobObject = [[ YContactJobObject alloc]init];jobObject.organizationName = [self contactProperty:kABPersonOrganizationProperty]; //公司(组织)名称jobObject.departmentName = [self contactProperty:kABPersonDepartmentProperty];     //部门jobObject.jobTitle = [self contactProperty:kABPersonJobTitleProperty];             //职位return jobObject;
}

获取联系人的邮件信息

/***  获得Email对象的数组*/
+ (NSArray <YContactEmailObject *> *)contactEmailProperty
{//外传数组NSMutableArray <YContactEmailObject *> * emails = [NSMutableArray arrayWithCapacity:0];//获取多值属性ABMultiValueRef values = ABRecordCopyValue(self.recordRef, kABPersonEmailProperty);//遍历添加for (NSInteger i = 0; i < ABMultiValueGetCount(values); i++){YContactEmailObject * emailObject = [[YContactEmailObject alloc]init];emailObject.emailTitle = (__bridge NSString *)(ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(values, i)));  //邮件描述emailObject.emailAddress = (__bridge NSString *)(ABMultiValueCopyValueAtIndex(values, i));                                 //邮件地址//添加[emails addObject:emailObject];}//释放资源CFRelease(values);return [NSArray arrayWithArray:emails];
}

获取联系人的地址信息

/***  获得Address对象的数组*/
+ (NSArray <YContactAddressObject *> *)contactAddressProperty
{//外传数组NSMutableArray <YContactAddressObject *> * addresses = [NSMutableArray arrayWithCapacity:0];//获取多指属性ABMultiValueRef values = ABRecordCopyValue(self.recordRef, kABPersonAddressProperty);//遍历添加for (NSInteger i = 0; i < ABMultiValueGetCount(values); i++){YContactAddressObject * addressObject = [[YContactAddressObject alloc]init];//赋值addressObject.addressTitle = (__bridge NSString *)ABAddressBookCopyLocalizedLabel((ABMultiValueCopyLabelAtIndex(values, i)));                    //地址标签//获得属性字典NSDictionary * dictionary = (__bridge NSDictionary *)ABMultiValueCopyValueAtIndex(values, i);//开始赋值addressObject.country = [dictionary valueForKey:(__bridge NSString *)kABPersonAddressCountryKey];               //国家addressObject.city = [dictionary valueForKey:(__bridge NSString *)kABPersonAddressCityKey];                     //城市addressObject.state = [dictionary valueForKey:(__bridge NSString *)kABPersonAddressStateKey];                   //省(州)addressObject.street = [dictionary valueForKey:(__bridge NSString *)kABPersonAddressStreetKey];                 //街道addressObject.postalCode = [dictionary valueForKey:(__bridge NSString *)kABPersonAddressZIPKey];                //邮编addressObject.ISOCountryCode = [dictionary valueForKey:(__bridge NSString *)kABPersonAddressCountryCodeKey];    //ISO国家编号//添加数据[addresses addObject:addressObject];}//释放资源CFRelease(values);return [NSArray arrayWithArray:addresses];}

获取联系人的生日信息

/***  根据属性key获得NSDate**  @param property 属性key**  @return NSDate对象*/
+ (NSDate *)contactDateProperty:(ABPropertyID) property
{return (__bridge NSDate *)(ABRecordCopyValue(self.recordRef, property));
}/***  获得生日的相关属性*/
+ (YContactBrithdayObject *)contactBrithdayProperty
{//实例化对象YContactBrithdayObject * brithdayObject = [[YContactBrithdayObject alloc]init];//生日的日历brithdayObject.brithdayDate = [self contactDateProperty:kABPersonBirthdayProperty];         //生日的时间对象//获得农历日历属性的字典NSDictionary * brithdayDictionary = (__bridge NSDictionary *)(ABRecordCopyValue(self.recordRef, kABPersonAlternateBirthdayProperty));//农历日历的属性，设置为农历属性的时候，此字典存在数值if (brithdayDictionary != nil){brithdayObject.calendar = [brithdayDictionary valueForKey:@"calendar"];                                 //农历生日的标志位,比如“chinese”//农历生日的相关存储属性brithdayObject.era = [(NSNumber *)[brithdayDictionary valueForKey:@"era"] integerValue];                //纪元,六十组干支纪年的索引数，比如12年为壬辰年，为循环的29,此数字为29brithdayObject.year = [(NSNumber *)[brithdayDictionary valueForKey:@"year"] integerValue];              //年份brithdayObject.month = [(NSNumber *)[brithdayDictionary valueForKey:@"month"] integerValue];            //月份brithdayObject.leapMonth = [(NSNumber *)[brithdayDictionary valueForKey:@"isLeapMonth"] boolValue];     //是否是闰月brithdayObject.day = [(NSNumber *)[brithdayDictionary valueForKey:@"day"] integerValue];                //日期}//返回对象return brithdayObject;
}

获取联系人的即时通信信息

/***  获得即时通信账号相关信息*/
+ (NSArray <YContactInstantMessageObject *> *)contactMessageProperty
{//存放数组NSMutableArray <YContactInstantMessageObject *> * instantMessages = [NSMutableArray arrayWithCapacity:0];//获取数据字典ABMultiValueRef messages = ABRecordCopyValue(self.recordRef, kABPersonInstantMessageProperty);//遍历获取值for (NSInteger i = 0; i < ABMultiValueGetCount(messages); i++){//获取属性字典NSDictionary * messageDictionary = CFBridgingRelease(ABMultiValueCopyValueAtIndex(messages, i));//实例化YContactInstantMessageObject * instantMessageObject = [[YContactInstantMessageObject alloc]init];instantMessageObject.service = [messageDictionary valueForKey:@"service"];          //服务名称(如QQ)instantMessageObject.userName = [messageDictionary valueForKey:@"username"];        //服务账号(如QQ号)//添加[instantMessages addObject:instantMessageObject];}return [NSArray arrayWithArray:instantMessages];
}

获得联系人的关联人信息

/***  获得联系人的关联人信息*/
+ (NSArray <YContactRelatedNamesObject *> *)contactRelatedNamesProperty
{//存放数组NSMutableArray <YContactRelatedNamesObject *> * relatedNames = [NSMutableArray arrayWithCapacity:0];//获得多值属性ABMultiValueRef names = ABRecordCopyValue(self.recordRef, kABPersonRelatedNamesProperty);//遍历赋值for (NSInteger i = 0; i < ABMultiValueGetCount(names); i++){//初始化YContactRelatedNamesObject * relatedName = [[YContactRelatedNamesObject alloc]init];//赋值relatedName.relatedTitle = CFBridgingRelease(ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(names, i))); //关联的标签(如friend)relatedName.relatedName = CFBridgingRelease(ABMultiValueCopyValueAtIndex(names, i));                                    //关联的名称(如联系人姓名)//添加[relatedNames addObject:relatedName];}return [NSArray arrayWithArray:relatedNames];
}

获取联系人的社交简介信息

/***  获得联系人的社交简介信息*/
+ (NSArray <YContactSocialProfileObject *> *)contactSocialProfilesProperty
{//外传数组NSMutableArray <YContactSocialProfileObject *> * socialProfiles = [NSMutableArray arrayWithCapacity:0];//获得多值属性ABMultiValueRef profiles = ABRecordCopyValue(self.recordRef, kABPersonSocialProfileProperty);//遍历取值for (NSInteger i = 0; i < ABMultiValueGetCount(profiles); i++){//初始化对象YContactSocialProfileObject * socialProfileObject = [[YContactSocialProfileObject alloc]init];//获取属性值NSDictionary * profileDictionary = CFBridgingRelease(ABMultiValueCopyValueAtIndex(profiles, i));//开始赋值socialProfileObject.socialProfileTitle = [profileDictionary valueForKey:@"service"];    //社交简介(如sinaweibo)socialProfileObject.socialProFileAccount = [profileDictionary valueForKey:@"username"]; //社交地址(如123456)socialProfileObject.socialProFileUrl = [profileDictionary valueForKey:@"url"];          //社交链接的地址(按照上面两项自动为http://weibo.com/n/123456)//添加[socialProfiles addObject:socialProfileObject];   }return [NSArray arrayWithArray:socialProfiles];
}

获取联系人的备注信息

//备注
contactObject.note = [self contactProperty:kABPersonNoteProperty];

获取联系人的创建时间

//创建时间
contactObject.creationDate = [self contactDateProperty:kABPersonCreationDateProperty];

获取联系人的最近修改时间

//最近一次修改的时间
contactObject.modificationDate = [self contactDateProperty:kABPersonModificationDateProperty];

接收外界通讯录发生变化的方法

在初始化AddressBook的时候为它注册一个通知

//创建一个AddressBook
self.addressBook = ABAddressBookCreate();/***  注册通讯录变动的回调**  @param self.addressBook          注册的addressBook*  @param addressBookChangeCallBack 变动之后进行的回调方法*  @param void                      传参，这里是将自己作为参数传到方法中,*  将自己传过去的时候，一定要用__bridge_retained一下，如果不retained，会发生内存泄露，计数器不正确，导致程序崩溃*/
ABAddressBookRegisterExternalChangeCallback(self.addressBook,  addressBookChangeCallBack, (__bridge_retained void *)(self));

在外面自己写回调的方法，这个方法是外界的通讯录发生增删改查之后，再次回到此App的时候才会触发的方法

void addressBookChangeCallBack(ABAddressBookRef addressBook, CFDictionaryRef info, void *context)
{//coding when addressBook did changedNSLog(@"通讯录发生变化啦");//初始化对象，这里是将参数转成对象的方法YContactsManager * contactManager = CFBridgingRelease(context);}