1. 前情提要
在iOS9.0之后,系统的通讯录改成了Contacts/Contacts.h,之前的AddressBook/AddressBook.h框架还可以用,而新的框架中采用的都是面向对象的思想,更方便。
2. 首先导入头文件
#import
3. 获取授权信息
// CNAuthorizationStatusNotDetermined = 0,
// CNAuthorizationStatusRestricted,
// CNAuthorizationStatusDenied,
// CNAuthorizationStatusAuthorized
// 获取授权状态
// [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
// ios 9
CNContactStore *contactStore = [[CNContactStore alloc] init]; // 创建通讯录
// 请求授权
[contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
if (granted) {
NSLog(@"授权成功!");
// 添加联系人
// 获取所有联系人
} else {
NSLog(@"授权失败!");
}
}];
4. 获取通讯录
// 1.获取授权状态
CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
// 2.如果没有授权,先执行授权失败的block后return
if (status != CNAuthorizationStatusAuthorized)
{
failure ? failure() : nil;
return;
}
// 3.获取联系人
// 3.1.创建联系人仓库
CNContactStore *store = [[CNContactStore alloc] init];
// 3.2.创建联系人的请求对象
// keys决定能获取联系人哪些信息,例:姓名,电话,头像等
NSArray *fetchKeys = @[[CNContactFormatter descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName],CNContactPhoneNumbersKey,CNContactThumbnailImageDataKey];
CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:fetchKeys];
// 3.3.请求联系人
[self.contactStore enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact,BOOL * _Nonnull stop) {
// 获取联系人全名
NSString *name = [CNContactFormatter stringFromContact:contact style:CNContactFormatterStyleFullName];
// 创建联系人模型
PPPersonModel *model = [PPPersonModel new];
model.name = name.length > 0 ? name : @"无名氏" ;
// 联系人头像
model.headerImage = [UIImage imageWithData:contact.thumbnailImageData];
// 获取一个人的所有电话号码
NSArray *phones = contact.phoneNumbers;
for (CNLabeledValue *labelValue in phones)
{
CNPhoneNumber *phoneNumber = labelValue.value;
NSString *mobile = [self removeSpecialSubString:phoneNumber.stringValue];
[model.mobileArray addObject: mobile ? mobile : @"空号"];
}
}];
5. 添加联系人
- (void)creatContact{
CNMutableContact *contact = [[CNMutableContact alloc] init]; // 第一次运行的时候,会获取通讯录的授权(对通讯录进行操作,有权限设置)
// 1、添加姓名(姓+名)
contact.givenName = @"san";
contact.familyName = @"wangg";
// 2、添加职位相关
contact.organizationName = @"公司名称";
contact.departmentName = @"开发部门";
contact.jobTitle = @"工程师";
// 3、这一部分内容会显示在联系人名字的下面,phoneticFamilyName属性设置的话,会影响联系人列表界面的排序
// contact.phoneticGivenName = @"GivenName";
// contact.phoneticFamilyName = @"FamilyName";
// contact.phoneticMiddleName = @"MiddleName";
// 4、备注
contact.note = @"同事";
// 5、头像
contact.imageData = UIImagePNGRepresentation([UIImage imageNamed:@"1"]);
// 6、添加生日
NSDateComponents *birthday = [[NSDateComponents alloc] init];
birthday.year = 1990;
birthday.month = 6;
birthday.day = 6;
contact.birthday = birthday;
// 7、添加邮箱
CNLabeledValue *homeEmail = [CNLabeledValue labeledValueWithLabel:CNLabelEmailiCloud value:@"[[email protected]](mailto:[email protected])"];
// CNLabeledValue *workEmail = [CNLabeledValue labeledValueWithLabel:CNLabelWork value:@"11111888888"];
// CNLabeledValue *iCloudEmail = [CNLabeledValue labeledValueWithLabel:CNLabelHome value:@"34454554"];
// CNLabeledValue *otherEmail = [CNLabeledValue labeledValueWithLabel:CNLabelOther value:@"6565448"];
contact.emailAddresses = @[homeEmail];
// 8、添加电话
CNLabeledValue *homePhone = [CNLabeledValue labeledValueWithLabel:CNLabelPhoneNumberiPhone value:[CNPhoneNumber phoneNumberWithStringValue:@"11122233344"]];
contact.phoneNumbers = @[homePhone];
// 9、添加urlAddresses,
CNLabeledValue *homeurl = [CNLabeledValue labeledValueWithLabel:CNLabelURLAddressHomePage value:@"[http://baidu.com](http://baidu.com)"];
contact.urlAddresses = @[homeurl];
// 10、添加邮政地址
CNMutablePostalAddress *postal = [[CNMutablePostalAddress alloc] init];
postal.city = @"北京";
postal.country = @"中国";
CNLabeledValue *homePostal = [CNLabeledValue labeledValueWithLabel:CNLabelHome value:postal];
contact.postalAddresses = @[homePostal];
// 获取通讯录操作请求对象
CNSaveRequest *request = [[CNSaveRequest alloc] init];
[request addContact:contact toContainerWithIdentifier:nil]; // 添加联系人操作(同一个联系人可以重复添加)
// 获取通讯录
CNContactStore *store = [[CNContactStore alloc] init];
// 保存联系人
[store executeSaveRequest:request error:nil]; // 通讯录有变化之后,还可以监听是否改变(CNContactStoreDidChangeNotification)
}
6. 删除联系人
- (void)deleteContact:(CNMutableContact *)contact{
// 创建联系人请求
CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
[saveRequest deleteContact:contact];
// 写入操作
CNContactStore *store = [[CNContactStore alloc] init];
[store executeSaveRequest:saveRequest error:nil];
}
7. 修改联系人
- (void)updateContact:(CNMutableContact *)contact{
// 创建联系人请求
CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
[saveRequest updateContact:contact];
// 重新写入
CNContactStore *store = [[CNContactStore alloc] init];
[store executeSaveRequest:saveRequest error:nil];
}
8. 查找联系人
- (NSArray *)queryContactWithName:(NSString *)name{
CNContactStore *store = [[CNContactStore alloc] init];
//检索条件
NSPredicate *predicate = [CNContact predicateForContactsMatchingName:name];
//过滤的条件,也可以过滤时候格式化
NSArray *keysToFetch = @[CNContactEmailAddressesKey, [CNContactFormatter descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName]];
NSArray *contact = [store unifiedContactsMatchingPredicate:predicate keysToFetch:keysToFetch error:nil];
return contact;
}
9. 修改删除遇到的坑
通过查找联系人,然后,进行更新,删除操作,
NSArray *contact = [store unifiedContactsMatchingPredicate:predicate keysToFetch:keysToFetch error:nil];
这一步获得的是CNContact, 而 操作需要CNMutableContact,如直接修改会报错
NSPredicate *predicate = [CNContact predicateForContactsMatchingName:name];
NSArray *keysToFetch = @[CNContactPhoneNumbersKey,[CNContactFormatter descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName]];
NSArray *contacts = [self.contactStore unifiedContactsMatchingPredicate:predicate keysToFetch:keysToFetch error:nil];
if (contacts.count < 1) {
[self addContactiOS9LaterName:name nums:nums];
return;
}
CNContact *contact = contacts.firstObject;
CNMutableContact *contactM = (CNMutableContact *)[contact mutableCopy];
NSMutableArray *phoneNums = [NSMutableArray array];
for (NSString *num in nums) {
CNPhoneNumber *number = [CNPhoneNumber phoneNumberWithStringValue:num];
CNLabeledValue *phone = [[CNLabeledValue alloc]initWithLabel:CNLabelPhoneNumberiPhone value:number];
[phoneNums addObject:phone];
}
contactM.phoneNumbers = [NSArray arrayWithArray:phoneNums];
CNSaveRequest *request = [[CNSaveRequest alloc]init];
[request updateContact:contactM];
NSError *error = nil;
[self.contactStore executeSaveRequest:request error:&error];
CNContact 要进行一次 拷贝,并且, 在删除或更新的项目, 查询时候,一定要获取到
NSArray *keysToFetch = @[CNContactPhoneNumbersKey,
[CNContactFormatter descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName]];
比如,我要修改联系人名称 跟 电话号码, 就一定要写查找的电话跟姓名的key. 否则会报错