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

àì夳堔傛蜴生んèń 2023-06-13 04:55 3阅读 0赞

## 前言 ##

> 产品需求，将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<CNLabeledValue<CNPhoneNumber*>*> *phoneNumbers;`该CNLabeledValue里面数据类型是`CNPhoneNumber`；

*  `phoneNumbers`电话，该参数类型为`NSArray<CNLabeledValue<CNPhoneNumber*>*>`,其中`CNPhoneNumber`类包含以下几种关键字：  
    `CNLabelPhoneNumberiPhone`iPhone  
    `CNLabelPhoneNumberMobile`手机  
    `CNLabelPhoneNumberMain`电话  
    `CNLabelPhoneNumberHomeFax`家庭传真  
    `CNLabelPhoneNumberWorkFax`工作传真  
    `CNLabelPhoneNumberOtherFax`其他传真  
    `CNLabelPhoneNumberPager`传呼机
 *  `emailAddresses`邮件，该参数类型为`NSArray<CNLabeledValue<NSString*>*>`，故该邮件参数是CNLabeledValue包含的字符串类型。
 *  `postalAddresses`该参数是邮政，类型`NSArray<CNLabeledValue<CNPostalAddress*>*>`,但目前为止不知怎么使用
 *  `urlAddresses`URL，该参数类型`NSArray<CNLabeledValue<NSString*>*>`和邮件一样
 *  `contactRelations`亲属关系，参数类型`NSArray<CNLabeledValue<CNContactRelation*>*>`，其中`CNContactRelation`包含如下关键类型  
    `CNLabelContactRelationFather`父亲  
    `CNLabelContactRelationMother`母亲  
    `CNLabelContactRelationParent`父母  
    `CNLabelContactRelationBrother`兄弟  
    `CNLabelContactRelationSister`姐妹  
    `CNLabelContactRelationSon`儿子,该关键字iOS11可以使用  
    `CNLabelContactRelationDaughter`女儿,该关键字iOS11可以使用  
    `CNLabelContactRelationChild`子女  
    `CNLabelContactRelationFriend`朋友  
    `CNLabelContactRelationSpouse`配偶  
    `CNLabelContactRelationPartner`伴侣  
    `CNLabelContactRelationAssistant`助理  
    `CNLabelContactRelationManager`上司
 *  `socialProfiles`社交，该参数类型`NSArray<CNLabeledValue<CNSocialProfile*>*>`，该参数用的极少，其中`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 <ContactsUI/CNContactViewController.h>`；
2.  遵守协议`<CNContactViewControllerDelegate>`；
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及以上。***

作者：差不多先生\_\_  
链接：https://www.jianshu.com/p/c79fbaf1c108  
来源：简书  
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。