iOS 保存联系人到手机通讯录(CNMutableContact\CNContactViewController)

前言

产品需求，将App内的个人信息，保存到手机通讯录，故了解到iOS9以后可以使用CNMutableContact和CNContactViewController,其中CNMutableContact是隶属于Contacts的Framework，CNContactViewController是隶属于ContactsUI的Framework，这里这两个Framework不作详解，有兴趣自己可以看看，这里只记录个人信息怎么保存到手机通讯录。

了解相应的Class

• CNMutableContact类，该类是一个可变的联系人对象，可以写入电话、邮箱等信息。
• CNContactViewController类，CNContactViewController类可以直接显示一个联系人界面，这个界面显示的可以是一个新的联系人、不存在的联系人和现有的联系人，初始化该类必须使用一个初始值viewControllerForNewContact:即，一个CNMutableContact对象。
• CNLabeledValue类，官方定义是一个线程安全的类,定义了一个不可变的值对象,结合接触属性值标签,譬如一个联系人的电话号码加上一个标签：家里、工作、或者iPhone。即设置联系人属性时需要使用该类设置一个标签和一个值。

CNMutableContact详解

枚举属性

• contactType，该参数是一个枚举值，该枚举值有两个定义，分别是CNContactTypePerson和CNContactTypeOrganization，
  CNContactTypePerson表示人
  CNContactTypeOrganization表示组织或者机构

字符串属性

• namePrefix联系人
• namePrefix称谓（姓名前）
• givenName名字
• middleName中间名
• familyName姓氏
• previousFamilyName婚前姓姓
• nameSuffix称谓（姓名后）
• nickname 昵称
• organizationName公司
• departmentName 部门
• jobTitle职位
• phoneticGivenName名字拼音或音标
• phoneticMiddleName中间名拼音或音标
• phoneticFamilyName姓氏拼音或音标
• phoneticOrganizationName公司名称拼音或音标
• note备注

NSData属性

• imageData头像——将头像的图片转换成data格式

NSArray属性

此类属性数组里面统一指定的是CNLabeledValue类型数据，CNLabeledValue里面又指定其它类型数据,譬如NSArray*> *phoneNumbers;该CNLabeledValue里面数据类型是CNPhoneNumber；

• phoneNumbers电话，该参数类型为NSArray*>,其中CNPhoneNumber类包含以下几种关键字：
  CNLabelPhoneNumberiPhoneiPhone
  CNLabelPhoneNumberMobile手机
  CNLabelPhoneNumberMain电话
  CNLabelPhoneNumberHomeFax家庭传真
  CNLabelPhoneNumberWorkFax工作传真
  CNLabelPhoneNumberOtherFax其他传真
  CNLabelPhoneNumberPager传呼机

• emailAddresses邮件，该参数类型为NSArray*>，故该邮件参数是CNLabeledValue包含的字符串类型。

• postalAddresses该参数是邮政，类型NSArray*>,但目前为止不知怎么使用

• urlAddressesURL，该参数类型NSArray*>和邮件一样

• contactRelations亲属关系，参数类型NSArray*>，其中CNContactRelation包含如下关键类型
  CNLabelContactRelationFather父亲
  CNLabelContactRelationMother母亲
  CNLabelContactRelationParent父母
  CNLabelContactRelationBrother兄弟
  CNLabelContactRelationSister姐妹
  CNLabelContactRelationSon儿子,该关键字iOS11可以使用
  CNLabelContactRelationDaughter女儿,该关键字iOS11可以使用
  CNLabelContactRelationChild子女
  CNLabelContactRelationFriend朋友
  CNLabelContactRelationSpouse配偶
  CNLabelContactRelationPartner伴侣
  CNLabelContactRelationAssistant助理
  CNLabelContactRelationManager上司

• socialProfiles社交，该参数类型NSArray*>，该参数用的极少，其中CNSocialProfile许讲解一个方法,这里是添加了一个叫小明的新浪微博

[[CNSocialProfile alloc] initWithUrlString:@"www.baidu.com" username:@"小明" userIdentifier:@"hello" service:[CNSocialProfile localizedStringForService:CNSocialProfileServiceSinaWeibo]]

• instantMessageAddresses即时通讯相关账户，该参数用的也很少

说一个方法的属性API_AVAILABLE(ios(9.0))如果一个方法带有此后缀，说明该方法执行的最低iOS系统版本为9.0。

准备

1. 引入头文件#import ；
2. 遵守协议；
3. 一份个人信息。

开始

检查是否有通讯录权限

/**
 将名片保存至手机
 */
- (void)addToMobilePhone API_AVAILABLE(ios(9.0)){
    /*
     查看是否有权限，没有获取权限*/
    CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
    if (status != CNAuthorizationStatusAuthorized) {
        CNContactStore *contactStore = [[CNContactStore alloc] init];
        [contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
            if (granted) {
                // 授权成功
                [self addNewContact];
            } else {
                // 授权失败
            }
        }];
    } else {
        //已经授权过
        [self addNewContact];
    }
    // 1. 创建选择联系人控制器
}

创建可变的Contact对象，并对Contact赋值，在创建新建好友页面并跳转，我这里对赋值是比较简单的，如果你的比较复杂，请查看CNMutableContact详解

- (void)addNewContact API_AVAILABLE(ios(9.0)) {
    //1.创建Contact对象，必须是可变的
    CNMutableContact *contact = [[CNMutableContact alloc] init];
    //2.为contact赋值，我这里是最简单的，setValueWithContact中会给出常用值的对应关系
    [self setValueWithContact:contact];
    //3.创建新建好友页面
    CNContactViewController *controller = [CNContactViewController viewControllerForNewContact:contact];
    //代理内容根据自己需要实现
    controller.delegate = self;
    //4.跳转
    UINavigationController *navigation = [[UINavigationController alloc] initWithRootViewController:controller];
    
    navigation.navigationBar.tintColor = [UIColor blackColor];
    
    [self presentViewController:navigation animated:YES completion:nil];
}

对CNMutableContact的赋值，这里self.dataModel是我的个人信息模型

// 设置要保存的contact对象
- (void)setValueWithContact:(CNMutableContact *)contact API_AVAILABLE(ios(9.0)) {
    // 名字
    contact.familyName = self.dataModel.name;
    
    // 通讯录头像
    UIImage *img = [self.tableView getAvatar];
    NSData *data = UIImageJPEGRepresentation(img, 1.0);
    contact.imageData = data;
    
    // 手机 办公电话
    CNLabeledValue *phoneNumber = [CNLabeledValue labeledValueWithLabel:CNLabelPhoneNumberMobile value:[CNPhoneNumber phoneNumberWithStringValue:self.dataModel.phoneNum]];
    CNLabeledValue *tel = [CNLabeledValue labeledValueWithLabel:CNLabelPhoneNumberMain value:[CNPhoneNumber phoneNumberWithStringValue:self.dataModel.officeTel]];
    contact.phoneNumbers = @[phoneNumber, tel];
    
    // 邮箱
    CNLabeledValue *mail = [CNLabeledValue labeledValueWithLabel:@"邮箱" value:self.dataModel.email];
    contact.emailAddresses = @[mail];
}

实现代理

//该协议是在创建新的名片界面点击取消或者确定后的回调
- (void)contactViewController:(CNContactViewController *)viewController didCompleteWithContact:(nullable CNContact *)contact  API_AVAILABLE(ios(9.0)) {
    [viewController dismissViewControllerAnimated:YES completion:nil];
}

这篇文章，因为是两次书写，间隔时间较长，中间时间很忙，如果有什么问题以及建议请及时留言，我会及时改正，但这篇文章中代码我已经亲测可行，这篇文章适用于iOS9.0及以上。