前言
产品需求，将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类包含以下几种关键字：
CNLabelPhoneNumberiPhoneiPhone
CNLabelPhoneNumberMobile手机
CNLabelPhoneNumberMain电话
CNLabelPhoneNumberHomeFax家庭传真
CNLabelPhoneNumberWorkFax工作传真
CNLabelPhoneNumberOtherFax其他传真
CNLabelPhoneNumberPager传呼机 -
emailAddresses邮件，该参数类型为NSArray<CNLabeledValue<NSString*>*>，故该邮件参数是CNLabeledValue包含的字符串类型。 -
postalAddresses该参数是邮政，类型NSArray<CNLabeledValue<CNPostalAddress*>*>,但目前为止不知怎么使用 -
urlAddressesURL，该参数类型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。
准备
- 引入头文件
#import <ContactsUI/CNContactViewController.h>； - 遵守协议
<CNContactViewControllerDelegate>； - 一份个人信息。
开始
检查是否有通讯录权限
/**
将名片保存至手机
*/
- (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及以上。
网友评论