1. 前情提要
在iOS9.0之后，系統(tǒng)的通訊錄改成了Contacts/Contacts.h，之前的AddressBook/AddressBook.h框架還可以用，而新的框架中采用的都是面向?qū)ο蟮乃枷耄奖恪?/p>
2. 首先導(dǎo)入頭文件
#import <Contacts/Contacts.h>
3. 獲取授權(quán)信息
// CNAuthorizationStatusNotDetermined = 0,
// CNAuthorizationStatusRestricted,
// CNAuthorizationStatusDenied,
// CNAuthorizationStatusAuthorized
// 獲取授權(quán)狀態(tài)
// [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
// ios 9
CNContactStore *contactStore = [[CNContactStore alloc] init]; // 創(chuàng)建通訊錄
// 請求授權(quán)
[contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
if (granted) {
NSLog(@"授權(quán)成功!");
// 添加聯(lián)系人
// 獲取所有聯(lián)系人
} else {
NSLog(@"授權(quán)失敗!");
}
}];
4. 獲取通訊錄
// 1.獲取授權(quán)狀態(tài)
CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
// 2.如果沒有授權(quán),先執(zhí)行授權(quán)失敗的block后return
if (status != CNAuthorizationStatusAuthorized)
{
failure ? failure() : nil;
return;
}
// 3.獲取聯(lián)系人
// 3.1.創(chuàng)建聯(lián)系人倉庫
CNContactStore *store = [[CNContactStore alloc] init];
// 3.2.創(chuàng)建聯(lián)系人的請求對象
// keys決定能獲取聯(lián)系人哪些信息,例:姓名,電話,頭像等
NSArray *fetchKeys = @[[CNContactFormatter descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName],CNContactPhoneNumbersKey,CNContactThumbnailImageDataKey];
CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:fetchKeys];
// 3.3.請求聯(lián)系人
[self.contactStore enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact,BOOL * _Nonnull stop) {
// 獲取聯(lián)系人全名
NSString *name = [CNContactFormatter stringFromContact:contact style:CNContactFormatterStyleFullName];
// 創(chuàng)建聯(lián)系人模型
PPPersonModel *model = [PPPersonModel new];
model.name = name.length > 0 ? name : @"無名氏" ;
// 聯(lián)系人頭像
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. 添加聯(lián)系人
- (void)creatContact{
CNMutableContact *contact = [[CNMutableContact alloc] init]; // 第一次運行的時候，會獲取通訊錄的授權(quán)（對通訊錄進(jìn)行操作，有權(quán)限設(shè)置）
// 1、添加姓名（姓＋名）
contact.givenName = @"san";
contact.familyName = @"wangg";
// 2、添加職位相關(guān)
contact.organizationName = @"公司名稱";
contact.departmentName = @"開發(fā)部門";
contact.jobTitle = @"工程師";
// 3、這一部分內(nèi)容會顯示在聯(lián)系人名字的下面，phoneticFamilyName屬性設(shè)置的話，會影響聯(lián)系人列表界面的排序
// 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:@"[bvbdsmv@icloud.com](mailto:bvbdsmv@icloud.com)"];
// 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]; // 添加聯(lián)系人操作（同一個聯(lián)系人可以重復(fù)添加）
// 獲取通訊錄
CNContactStore *store = [[CNContactStore alloc] init];
// 保存聯(lián)系人
[store executeSaveRequest:request error:nil]; // 通訊錄有變化之后，還可以監(jiān)聽是否改變（CNContactStoreDidChangeNotification）
}
6. 刪除聯(lián)系人
- (void)deleteContact:(CNMutableContact *)contact{
// 創(chuàng)建聯(lián)系人請求
CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
[saveRequest deleteContact:contact];
// 寫入操作
CNContactStore *store = [[CNContactStore alloc] init];
[store executeSaveRequest:saveRequest error:nil];
}
7. 修改聯(lián)系人
- (void)updateContact:(CNMutableContact *)contact{
// 創(chuàng)建聯(lián)系人請求
CNSaveRequest *saveRequest = [[CNSaveRequest alloc] init];
[saveRequest updateContact:contact];
// 重新寫入
CNContactStore *store = [[CNContactStore alloc] init];
[store executeSaveRequest:saveRequest error:nil];
}
8. 查找聯(lián)系人
- (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. 修改刪除遇到的坑
通過查找聯(lián)系人,然后,進(jìn)行更新,刪除操作,
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 要進(jìn)行一次 拷貝,并且, 在刪除或更新的項目, 查詢時候,一定要獲取到
NSArray *keysToFetch = @[CNContactPhoneNumbersKey,
[CNContactFormatter descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName]];
比如,我要修改聯(lián)系人名稱 跟 電話號碼, 就一定要寫查找的電話跟姓名的key. 否則會報錯
