IOS9新特性之Contacts联系人

　　在以前iOS开发中，涉及联系人相关的编程，代码都非常繁琐，并且框架的设计也不是Objective-C风格的，这使开发者用起来非常的难受。在iOS9中，apple终于解决了这个问题，全新的Contacts Framework将完全替代AddressBookFramework，AddressBookFramework也将成为历史被弃用。

Contacts Framework这一新的框架是iOS9新特性中十分受欢迎的一个。apple的Objective—C体系也更加完善与强大。

一、ContactsUI的使用

1.创建选择联系人的控制器：

 1 - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
 2 {
 3     // 1.创建选择联系人的控制器
 4     CNContactPickerViewController *contactVc = [[CNContactPickerViewController alloc] init];
 5 
 6     // 2.设置代理
 7     contactVc.delegate = self;
 8 
 9     // 3.弹出控制器
10     [self presentViewController:contactVc animated:YES completion:nil];
11 }

2.实现代理方法：

 1 // 当选中某一个联系人时会执行该方法
 2 - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact
 3 {
 4     // 1.获取联系人的姓名
 5     NSString *lastname = contact.familyName;
 6     NSString *firstname = contact.givenName;
 7     NSLog(@"%@ %@", lastname, firstname);
 8 
 9     // 2.获取联系人的电话号码
10     NSArray *phoneNums = contact.phoneNumbers;
11     for (CNLabeledValue *labeledValue in phoneNums) {
12         // 2.1.获取电话号码的KEY
13         NSString *phoneLabel = labeledValue.label;
14 
15         // 2.2.获取电话号码
16         CNPhoneNumber *phoneNumer = labeledValue.value;
17         NSString *phoneValue = phoneNumer.stringValue;
18 
19         NSLog(@"%@ %@", phoneLabel, phoneValue);
20     }
21 }
22 
23 // 当选中某一个联系人的某一个属性时会执行该方法
24 - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty
25 {
26 }
27 
28 // 点击了取消按钮会执行该方法
29 - (void)contactPickerDidCancel:(CNContactPickerViewController *)picker
30 {  
31 }

二、Contacts的使用

1、先引用头文件：（使用@import更高效而且不用写路径）

1 @import Contacts;

2、具体细节：（红色部分非常关键，作用是遍历联系人列表）

 1 - (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
 2 {
 3     // 1.获取授权状态
 4     CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
 5 
 6     // 2.判断授权状态,如果不是已经授权,则直接返回
 7     if (status != CNAuthorizationStatusAuthorized) return;
 8 
 9     // 3.创建通信录对象
10     CNContactStore *contactStore = [[CNContactStore alloc] init];
11 
12     // 4.创建获取通信录的请求对象
13     // 4.1.拿到所有打算获取的属性对应的key,如果想使用联系人的头像，就需要添加CNContactImageDataKey这个关键的属性
14     NSArray *keys = @[CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey];
15 
16     // 4.2.创建CNContactFetchRequest对象
17     CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:keys];
18 
19     // 5.遍历所有的联系人
20     [contactStore enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
21         // 1.获取联系人的姓名
22         NSString *lastname = contact.familyName;
23         NSString *firstname = contact.givenName;
24         NSLog(@"%@ %@", lastname, firstname);
25 
26         // 2.获取联系人的电话号码
27         NSArray *phoneNums = contact.phoneNumbers;
28         for (CNLabeledValue *labeledValue in phoneNums) {
29             // 2.1.获取电话号码的KEY
30             NSString *phoneLabel = labeledValue.label;
31 
32             // 2.2.获取电话号码
33             CNPhoneNumber *phoneNumer = labeledValue.value;
34             NSString *phoneValue = phoneNumer.stringValue;
35 
36             NSLog(@"%@ %@", phoneLabel, phoneValue);
37         }
38     }];
39 }

 

注意，想拿到联系人的某个属性必须在 

1      // 4.创建获取通信录的请求对象
2      // 4.1.拿到所有打算获取的属性对应的key,如果想使用联系人的头像，就需要添加CNContactImageDataKey这个关键的属性
3      NSArray *keys = @[CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey];

上面的key实例中加入这个属性，例如想拿到联系人的头像，就要加入CNContactImageDataKey。

 

 

 

 

 

 

 

以下复制自博客：http://my.oschina.net/u/2340880/blog/511995?p={{totalPage}}

文章名：iOS9系列专题五——全新的联系人与联系人UI框架

 

iOS9全新的联系人相关框架——Contacts Framework

一、引言

        在以前iOS开发中，涉及联系人相关的编程，代码都非常繁琐，并且框架的设计也不是Objective-C风格的，这使开发者用起来非常的难受。在iOS9中，apple终于解决了这个问题，全新的Contacts Framework将完全替代AddressBookFramework，AddressBookFramework也将成为历史被弃用。至于AddressBookFramework的相关api如何繁琐，在以前的博客中有记录，地址如下：

联系人信息相关编程：http://my.oschina.net/u/2340880/blog/407347。

联系人UI界面相关编程：http://my.oschina.net/u/2340880/blog/407973。

        这一新的框架是iOS9新特性中十分受欢迎的一个。apple的Objective—C体系也更加完善与强大。

二、让我们来添加一个联系人

        新的框架的整体思路是通过配置与请求来管理联系人，这样做有一个非常大的好处，逻辑简单，代码层次清晰。如下，通过添加一个联系人来向大家做演示：

1、联系人对象：CNContact

这个对象是用来配置联系人信息的，有可变的CNMutaleContact和CNContact，区别用来读取和创建联系人。CNContact对象中有许多属性，对应联系人的一些信息。

首先，创建CNMutableContact对象：

?

1	CNMutableContact * contact = [[CNMutableContact alloc]init];

 

设置联系人头像：

?

1	contact.imageData = UIImagePNGRepresentation([UIImage imageNamed:@ "Icon-114.png" ]);

 

设置联系人姓名：

?

1 2 3 4

//设置名字      contact.givenName = @ "jaki" ;      //设置姓氏      contact.familyName = @ "zhang" ;

 

设置联系人邮箱：

?

1 2 3

CNLabeledValue *homeEmail = [CNLabeledValue labeledValueWithLabel:CNLabelHome value:@ "316045346@qq.com" ];       CNLabeledValue *workEmail =[CNLabeledValue labeledValueWithLabel:CNLabelWork value:@ "316045346@qq.com" ];       contact.emailAddresses = @[homeEmail,workEmail];

 

这里需要注意，emailAddresses属性是一个数组，数组中是才CNLabeledValue对象，CNLabeledValue对象主要用于创建一些联系人属性的键值对应，通过这些对应，系统会帮我们进行数据的格式化，例如CNLabelHome，就会将号码格式成家庭邮箱的格式，相应的其他键如下：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

//家庭 CONTACTS_EXTERN NSString *  const  CNLabelHome                             NS_AVAILABLE(10_11, 9_0); //工作 CONTACTS_EXTERN NSString *  const  CNLabelWork                             NS_AVAILABLE(10_11, 9_0); //其他 CONTACTS_EXTERN NSString *  const  CNLabelOther                            NS_AVAILABLE(10_11, 9_0);   // 邮箱地址 CONTACTS_EXTERN NSString *  const  CNLabelEmailiCloud                      NS_AVAILABLE(10_11, 9_0);   // url地址 CONTACTS_EXTERN NSString *  const  CNLabelURLAddressHomePage               NS_AVAILABLE(10_11, 9_0);   // 日期 CONTACTS_EXTERN NSString *  const  CNLabelDateAnniversary                  NS_AVAILABLE(10_11, 9_0);

 

设置联系人电话：

?

1	contact.phoneNumbers = @[[CNLabeledValue labeledValueWithLabel:CNLabelPhoneNumberiPhone value:[CNPhoneNumber phoneNumberWithStringValue:@ "12344312321" ]]];

 

联系人电话的配置方式和邮箱类似，键值如下：

?

1 2 3 4 5 6 7

CONTACTS_EXTERN NSString *  const  CNLabelPhoneNumberiPhone                NS_AVAILABLE(10_11, 9_0); CONTACTS_EXTERN NSString *  const  CNLabelPhoneNumberMobile                NS_AVAILABLE(10_11, 9_0); CONTACTS_EXTERN NSString *  const  CNLabelPhoneNumberMain                  NS_AVAILABLE(10_11, 9_0); CONTACTS_EXTERN NSString *  const  CNLabelPhoneNumberHomeFax               NS_AVAILABLE(10_11, 9_0); CONTACTS_EXTERN NSString *  const  CNLabelPhoneNumberWorkFax               NS_AVAILABLE(10_11, 9_0); CONTACTS_EXTERN NSString *  const  CNLabelPhoneNumberOtherFax              NS_AVAILABLE(10_11, 9_0); CONTACTS_EXTERN NSString *  const  CNLabelPhoneNumberPager                 NS_AVAILABLE(10_11, 9_0);

 

这里的CNPhoneNumber对象也是iOS9中的一个新的类，专门用来创建电话号码，之中方法如下：

?

1 2 3 4 5 6 7 8 9 10

@interface CNPhoneNumber : NSObject <NSCopying, NSSecureCoding>   //通过类方法创建 + (instancetype)phoneNumberWithStringValue:(NSString *)stringValue; //通过初始化方法创建 - (instancetype)initWithStringValue:(NSString *)string;   @property (readonly, copy, NS_NONATOMIC_IOSONLY) NSString *stringValue;   @end

 

设置联系人地址：

?

1 2 3 4 5 6

CNMutablePostalAddress * homeAdress = [[CNMutablePostalAddress alloc]init];      homeAdress.street = @ "贝克街" ;      homeAdress.city = @ "伦敦" ;      homeAdress.state = @ "英国" ;      homeAdress.postalCode = @ "221B" ;      contact.postalAddresses = @[[CNLabeledValue labeledValueWithLabel:CNLabelHome value:homeAdress]];

 

设置生日：

?

1 2 3 4 5

NSDateComponents * birthday = [[NSDateComponents  alloc]init];      birthday.day=7;      birthday.month=5;      birthday.year=1992;      contact.birthday=birthday;

 

2、创建添加联系人请求：CNSaveRequest

CNSaveRequest是用于存储联系人的请求类，通过这个类，我们可以创建批量添加、修改或者删除联系人的请求，例如添加上面我们创建的联系人对象：

?

1 2 3 4

//初始化方法      CNSaveRequest * saveRequest = [[CNSaveRequest alloc]init];      //添加联系人      [saveRequest addContact:contact toContainerWithIdentifier:nil];

 

这个类中还有许多方便我们操作的方法：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

@interface CNSaveRequest : NSObject //添加一个联系人 - ( void )addContact:(CNMutableContact *)contact toContainerWithIdentifier:(nullable NSString *)identifier;   //更新一个联系人 - ( void )updateContact:(CNMutableContact *)contact; //删除一个联系人 - ( void )deleteContact:(CNMutableContact *)contact; //添加一组联系人 - ( void )addGroup:(CNMutableGroup *)group toContainerWithIdentifier:(nullable NSString *)identifier; //更新一组联系人 - ( void )updateGroup:(CNMutableGroup *)group; //删除一组联系人 - ( void )deleteGroup:(CNMutableGroup *)group; //向组中添加子组 - ( void )addSubgroup:(CNGroup *)subgroup toGroup:(CNGroup *)group NS_AVAILABLE(10_11, NA); //在组中删除子组 - ( void )removeSubgroup:(CNGroup *)subgroup fromGroup:(CNGroup *)group NS_AVAILABLE(10_11, NA); //向组中添加成员 - ( void )addMember:(CNContact *)contact toGroup:(CNGroup *)group; //向组中移除成员 - ( void )removeMember:(CNContact *)contact fromGroup:(CNGroup *)group;   @end

 

3、进行联系人的写入操作:CNContactStore

CNContactStore是一个用于存取联系人的上下文桥梁，现在，把我们创建的添加联系人的请求写入：

?

1 2	CNContactStore * store = [[CNContactStore alloc]init];      [store executeSaveRequest:saveRequest error:nil];

 

在模拟器上运行程序，打开联系人，效果如下：

联系人界面：

 

联系人详情：

三、获取格式化的联系人信息

iOS9中，ContactFramework也为开发者提供了非常方便的格式化信息的方法，还拿我们上面创建的联系人对象举例：

1、获取格式化的联系人姓名

?

1 2	NSString * foematter =[CNContactFormatter stringFromContact:contact style:CNContactFormatterStyleFullName];      NSLog(@ "%@" ,foematter);

 

这个运行后会打印出jaki zhang，其中style风格枚举如下：

?

1 2 3 4 5 6 7

typedef  NS_ENUM(NSInteger, CNContactFormatterStyle) {      //获取全名      CNContactFormatterStyleFullName,     //获取拼音全名      CNContactFormatterStylePhoneticFullName, } NS_ENUM_AVAILABLE(10_11, 9_0);

 

2、获取格式化的联系人地址

?

1 2	NSString * foematter =[CNPostalAddressFormatter stringFromPostalAddress:homeAdress style:CNPostalAddressFormatterStyleMailingAddress];      NSLog(@ "%@" ,foematter);

 

打印如下：

四、提取联系人

        在开发中，提取联系人的使用率要远远高于创建联系人，ContactFramework提取联系人的方式，类似于数据库的检索方式，通过配置条件，提取出我们需要的数据，例如：

?

1 2 3 4 5

CNContactStore * stroe = [[CNContactStore alloc]init];      //检索条件，检索所有名字中有zhang的联系人      NSPredicate * predicate = [CNContact predicateForContactsMatchingName:@ "zhang" ];      //提取数据      NSArray * contacts = [stroe unifiedContactsMatchingPredicate:predicate keysToFetch:@[CNContactGivenNameKey] error:nil];

 

keysToFetch是设置提取联系人的哪些数据，如上则只提取出检索联系人的名字。

同样，也可以通过请求的方式来对联系人进行遍历：

?

1 2 3 4 5

CNContactStore * stroe = [[CNContactStore alloc]init];      CNContactFetchRequest * request = [[CNContactFetchRequest alloc]initWithKeysToFetch:@[CNContactPhoneticFamilyNameKey]];      [stroe enumerateContactsWithFetchRequest:request error:nil usingBlock:^(CNContact * _Nonnull contact,  BOOL  * _Nonnull stop) {          NSLog(@ "%@" ,contact);      }];

 

五、ContactFramework UI相关

iOS9中，系统也为我们封装好了一套联系人的UI界面，用起来也十分方便，主要新增的controller有两个：

CNContactPickerViewController：展示联系人列表的controller

 

CNContactViewController：展示联系人详细信息的controller

示例如下：

弹出联系人列表：

?

1 2	CNContactPickerViewController * con = [[CNContactPickerViewController alloc]init];      [self presentViewController:con animated:YES completion:nil];

 

效果如下：

联系人逻辑的相关处理主要在CNContactPickerDelegate中完成：

?

1 2 3 4 5 6 7

//视图取消时 调用的方法 - ( void )contactPickerDidCancel:(CNContactPickerViewController *)picker; //选中与取消选中时调用的方法 - ( void )contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact; - ( void )contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty; - ( void )contactPicker:(CNContactPickerViewController *)picker didSelectContacts:(NSArray<CNContact*> *)contacts; - ( void )contactPicker:(CNContactPickerViewController *)picker didSelectContactProperties:(NSArray<CNContactProperty*> *)contactProperties;

 

CNContactViewController则是用来显示具体联系人的详细信息的，比如：

?

1 2	CNContactViewController * con = [CNContactViewController viewControllerForContact:contact];      [self presentViewController:con animated:YES completion:nil];

 

相关代理回调函数如下：

?

1 2 3

//将要展示联系人信息与已经展示联系人信息的回调 - ( BOOL )contactViewController:(CNContactViewController *)viewController shouldPerformDefaultActionForContactProperty:(CNContactProperty *)property; - ( void )contactViewController:(CNContactViewController *)viewController didCompleteWithContact:(nullable CNContact *)contact;

转载于:https://www.cnblogs.com/jiwangbujiu/p/5458498.html