Swift - 访问通讯录-使用AddressBook.framework和AddressBookUI.framework框架实现
1，通讯录访问介绍
通讯录（或叫地址簿，电话簿）是一个数据库，里面储存了联系人的相关信息。要实现访问通讯录有如下两种方式：
（1）AddressBook.framework框架 ： 没有界面，通过代码来获取所有联系人信息
（2）AddressBookUI.framework框架 ： 通过系统提供的通讯录交互界面来访问（本文样例使用此方式）
2，联系人记录的属性
在一条联系人记录中，有很多属性，而这些属性又分为单值属性和多值属性。
单值属性是只有一个值的属性：如姓氏、名字、部门、备注等。
多值属性是包含多个值的集合类型，如：电话号码、Email、地址等。
3，多值属性标签的本地名称
在多值属性中包含了label（标签）、value（值）和ID等部分，其中标签和值都是可以重复的，而ID是不能重复的。
对于标签，我们可以使用ABAddressBookCopyLocalizedLabel()方法转为本地标签名（即能看得懂的标签名，比如
work、home）。要不然打印出来的是_$!<Home>!$_，_$!<Work>!$_这样的数据。
4，使用通讯录交互界面样例
本文通过使用通讯录交互界面来访问联系人，并打印出选中联系人的姓名和所有电话。
（想使用代码获取联系人，或者想知道更多联系人属性如何读取可参考我另一篇文章“ Swift - 访问通讯录联系人（使用纯代码实现） ”）
5，效果图如下：
6，代码如下
import UIKitimport AddressBookUIclass ViewController: UIViewController ,ABPeoplePickerNavigationControllerDelegate{ override func viewDidLoad() { super.viewDidLoad() // Do any additional setup after loading the view, typically from a nib. //弹出通讯录联系人选择界面 var picker = ABPeoplePickerNavigationController() picker.peoplePickerDelegate = self self.presentViewController(picker, animated: true) { () -> Void in } } func peoplePickerNavigationController(peoplePicker: ABPeoplePickerNavigationController!, didSelectPerson person: ABRecord!) { //获取姓 var lastName = ABRecordCopyValue(person, kABPersonLastNameProperty).takeRetainedValue() as! String println("选中人的姓：\(lastName)") //获取名 var firstName = ABRecordCopyValue(person, kABPersonFirstNameProperty).takeRetainedValue() as! String println("选中人的名：\(firstName)") //获取电话 var phoneValues:ABMutableMultiValueRef? = ABRecordCopyValue(person, kABPersonPhoneProperty).takeRetainedValue() if phoneValues != nil { println("选中人电话：") for i in 0 ..< ABMultiValueGetCount(phoneValues){ // 获得标签名 var phoneLabel = ABMultiValueCopyLabelAtIndex(phoneValues, i).takeRetainedValue() as CFStringRef; // 转为本地标签名（能看得懂的标签名，比如work、home） var localizedPhoneLabel = ABAddressBookCopyLocalizedLabel(phoneLabel) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(phoneValues, i) var phone = value.takeRetainedValue() as! String println("\(localizedPhoneLabel):\(phone)") } } } func peoplePickerNavigationController(peoplePicker: ABPeoplePickerNavigationController!, didSelectPerson person: ABRecord!, property: ABPropertyID, identifier: ABMultiValueIdentifier) { } //取消按钮点击 func peoplePickerNavigationControllerDidCancel(peoplePicker: ABPeoplePickerNavigationController!) { //去除地址选择界面 peoplePicker.dismissViewControllerAnimated(true, completion: { () -> Void in }) } func peoplePickerNavigationController(peoplePicker: ABPeoplePickerNavigationController!, shouldContinueAfterSelectingPerson person: ABRecord!) -> Bool { return true } func peoplePickerNavigationController(peoplePicker: ABPeoplePickerNavigationController!, shouldContinueAfterSelectingPerson person: ABRecord!, property: ABPropertyID, identifier: ABMultiValueIdentifier) -> Bool { return true }}Swift - 访问通讯录联系人（使用纯代码实现）
1，通讯录访问介绍
通讯录（或叫地址簿，电话簿）是一个数据库，里面储存了联系人的相关信息。要实现访问通讯录有如下两种方式：
（1）AddressBook.framework框架 ： 没有界面，通过代码来获取所有联系人信息（本文样例使用此方式）
（2）AddressBookUI.framework框架 ： 通过系统提供的通讯录交互界面来访问
2，联系人记录的属性
在一条联系人记录中，有很多属性，而这些属性又分为单值属性和多值属性。
（1）单值属性是只有一个值的属性：
kABPersonLastNameProperty ：姓
kABPersonFirstNameProperty ：名
kABPersonMiddleNameProperty ：中间名
kABPersonPrefixProperty ：前缀
kABPersonSuffixProperty ：后缀
kABPersonLastNamePhoneticProperty ：姓氏汉语拼音或音标
kABPersonFirstNamePhoneticProperty ：名字汉语拼音或音标
kABPersonNicknameProperty ：昵称
kABPersonOrganizationProperty ：公司（组织）
kABPersonJobTitleProperty ：职位
kABPersonDepartmentProperty ：部门
kABPersonNoteProperty ：备注
（2）多值属性是包含多个值的集合类型：
kABPersonPhoneProperty ：电话
kABPersonEmailProperty ：Email
kABPersonAddressProperty ：地址
kABPersonURLProperty : URL属性
kABPersonDateProperty ：纪念日
kABPersonInstantMessageProperty ：获取即时通讯(IM)
kABPersonSocialProfileProperty ：社交账号
kABPersonRelatedNamesProperty ：亲属关系人
3，多值属性标签的本地名称
在多值属性中包含了label（标签）、value（值）和ID等部分，其中标签和值都是可以重复的，而ID是不能重复的。
对于标签，我们可以使用ABAddressBookCopyLocalizedLabel()方法转为本地标签名（即能看得懂的标签名，比如
work、home）。要不然打印出来的是_$!<Home>!$_，_$!<Work>!$_这样的数据。
4，下面样例使用代码遍历所有的联系人，并打印输出相关属性
import UIKitimport AddressBookimport AddressBookUIclass ViewController: UIViewController { //address Book对象，用来获取电话簿句柄 var addressBook:ABAddressBookRef? override func viewDidLoad() { super.viewDidLoad() //定义一个错误标记对象，判断是否成功 var error:Unmanaged<CFErrorRef>? addressBook = ABAddressBookCreateWithOptions(nil, &error).takeRetainedValue() //发出授权信息 let sysAddressBookStatus = ABAddressBookGetAuthorizationStatus() if (sysAddressBookStatus == ABAuthorizationStatus.NotDetermined) { println("requesting access...") var errorRef:Unmanaged<CFError>? = nil //addressBook = extractABAddressBookRef(ABAddressBookCreateWithOptions(nil, &errorRef)) ABAddressBookRequestAccessWithCompletion(addressBook, { success, error in if success { //获取并遍历所有联系人记录 self.readRecords(); } else { println("error") } }) } else if (sysAddressBookStatus == ABAuthorizationStatus.Denied || sysAddressBookStatus == ABAuthorizationStatus.Restricted) { println("access denied") } else if (sysAddressBookStatus == ABAuthorizationStatus.Authorized) { println("access granted") //获取并遍历所有联系人记录 self.readRecords(); } } //获取并遍历所有联系人记录 func readRecords(){ var sysContacts:NSArray = ABAddressBookCopyArrayOfAllPeople(addressBook) .takeRetainedValue() as NSArray for contact in sysContacts { //获取姓 var lastName = ABRecordCopyValue(contact, kABPersonLastNameProperty)? .takeRetainedValue() as! String? ?? "" println("姓：\(lastName)") //获取名 var firstName = ABRecordCopyValue(contact, kABPersonFirstNameProperty)? .takeRetainedValue() as! String? ?? "" println("名：\(firstName)") //昵称 var nikeName = ABRecordCopyValue(contact, kABPersonNicknameProperty)? .takeRetainedValue() as! String? ?? "" println("昵称：\(nikeName)") //公司（组织） var organization = ABRecordCopyValue(contact, kABPersonOrganizationProperty)? .takeRetainedValue() as! String? ?? "" println("公司（组织）：\(organization)") //职位 var jobTitle = ABRecordCopyValue(contact, kABPersonJobTitleProperty)? .takeRetainedValue() as! String? ?? "" println("职位：\(jobTitle)") //部门 var department = ABRecordCopyValue(contact, kABPersonDepartmentProperty)? .takeRetainedValue() as! String? ?? "" println("部门：\(department)") //备注 var note = ABRecordCopyValue(contact, kABPersonNoteProperty)? .takeRetainedValue() as! String? ?? "" println("备注：\(note)") //获取电话 var phoneValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonPhoneProperty).takeRetainedValue() if phoneValues != nil { println("电话：") for i in 0 ..< ABMultiValueGetCount(phoneValues){ // 获得标签名 var phoneLabel = ABMultiValueCopyLabelAtIndex(phoneValues, i).takeRetainedValue() as CFStringRef; // 转为本地标签名（能看得懂的标签名，比如work、home） var localizedPhoneLabel = ABAddressBookCopyLocalizedLabel(phoneLabel) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(phoneValues, i) var phone = value.takeRetainedValue() as! String println(" \(localizedPhoneLabel):\(phone)") } } //获取Email var emailValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonEmailProperty).takeRetainedValue() if emailValues != nil { println("Email：") for i in 0 ..< ABMultiValueGetCount(emailValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(emailValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(emailValues, i) var email = value.takeRetainedValue() as! String println(" \(localizedLabel):\(email)") } } //获取地址 var addressValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonAddressProperty).takeRetainedValue() if addressValues != nil { println("地址：") for i in 0 ..< ABMultiValueGetCount(addressValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(addressValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(addressValues, i) var addrNSDict:NSMutableDictionary = value.takeRetainedValue() as! NSMutableDictionary var country:String = addrNSDict.valueForKey(kABPersonAddressCountryKey as String) as? String ?? "" var state:String = addrNSDict.valueForKey(kABPersonAddressStateKey as String) as? String ?? "" var city:String = addrNSDict.valueForKey(kABPersonAddressCityKey as String) as? String ?? "" var street:String = addrNSDict.valueForKey(kABPersonAddressStreetKey as String) as? String ?? "" var contryCode:String = addrNSDict .valueForKey(kABPersonAddressCountryCodeKey as String) as? String ?? "" print(" \(localizedLabel): Contry:\(country) State:\(state) ") println("City:\(city) Street:\(street) ContryCode:\(contryCode) ") } } //获取纪念日 var dateValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonDateProperty).takeRetainedValue() if dateValues != nil { println("纪念日：") for i in 0 ..< ABMultiValueGetCount(dateValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(emailValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(dateValues, i) var date = (value.takeRetainedValue() as? NSDate)?.description ?? "" println(" \(localizedLabel):\(date)") } } //获取即时通讯(IM) var imValues:ABMutableMultiValueRef? = ABRecordCopyValue(contact, kABPersonInstantMessageProperty).takeRetainedValue() if imValues != nil { println("即时通讯(IM)：") for i in 0 ..< ABMultiValueGetCount(imValues){ // 获得标签名 var label = ABMultiValueCopyLabelAtIndex(imValues, i).takeRetainedValue() as CFStringRef; var localizedLabel = ABAddressBookCopyLocalizedLabel(label) .takeRetainedValue() as! String var value = ABMultiValueCopyValueAtIndex(imValues, i) var imNSDict:NSMutableDictionary = value.takeRetainedValue() as! NSMutableDictionary var serves:String = imNSDict .valueForKey(kABPersonInstantMessageServiceKey as String) as? String ?? "" var userName:String = imNSDict .valueForKey(kABPersonInstantMessageUsernameKey as String) as? String ?? "" println(" \(localizedLabel): Serves:\(serves) UserName:\(userName)") } } } } override func didReceiveMemoryWarning() { super.didReceiveMemoryWarning() }}Swift - 添加、修改、删除通讯录联系人
使用AddressBook.framework框架，我们除了可以很方便的获取通信录里的联系人。同时，还能对通讯录进行新增、修改、删除联系人操作。
（注意：这些操作同查询一样，首先需要发起授权请求）
1，添加新联系人
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
|
import UIKitimport AddressBookimport AddressBookUIclass ViewController: UIViewController { //address Book对象，用来获取电话簿句柄 var addressBook:ABAddressBookRef? override func viewDidLoad() { super.viewDidLoad() //定义一个错误标记对象，判断是否成功 var error:Unmanaged<CFErrorRef>? addressBook = ABAddressBookCreateWithOptions(nil, &error).takeRetainedValue() //发出授权信息 let sysAddressBookStatus = ABAddressBookGetAuthorizationStatus() if (sysAddressBookStatus == ABAuthorizationStatus.NotDetermined) { println("requesting access...") var errorRef:Unmanaged<CFError>? = nil //addressBook = extractABAddressBookRef(ABAddressBookCreateWithOptions(nil, &errorRef)) ABAddressBookRequestAccessWithCompletion(addressBook, { success, error in if success { //添加新联系人 self.addRecord(); } else { println("error") } }) } else if (sysAddressBookStatus == ABAuthorizationStatus.Denied || sysAddressBookStatus == ABAuthorizationStatus.Restricted) { println("access denied") } else if (sysAddressBookStatus == ABAuthorizationStatus.Authorized) { println("access granted") //添加新联系人 self.addRecord(); } } //添加新联系人 func addRecord(){ //定义一个错误标记对象，判断是否成功 var error:Unmanaged<CFErrorRef>? //创建一个联系人对象 var newContact:ABRecordRef! = ABPersonCreate().takeRetainedValue() var success:Bool = false //设置联系人对象昵称 success = ABRecordSetValue(newContact, kABPersonNicknameProperty, "小李", &error) println("设置昵称结果:\(success)") //设置联系人姓氏 success = ABRecordSetValue(newContact, kABPersonLastNameProperty, "李", &error) println("设置姓氏结果:\(success)") //设置联系人名字 success = ABRecordSetValue(newContact, kABPersonFirstNameProperty, "大木", &error) println("设置名字结果:\(success)") //设置联系人电话 let phones:ABMutableMultiValueRef = ABMultiValueCreateMutable( ABPropertyType(kABStringPropertyType)).takeRetainedValue() success = ABMultiValueAddValueAndLabel(phones, "123456", "公司", nil) println("设置电话条目:\(success)") success = ABRecordSetValue(newContact, kABPersonPhoneProperty, phones, nil) println("设置电话结果:\(success)") //设置联系人邮箱 let addr:ABMutableMultiValueRef = ABMultiValueCreateMutable( ABPropertyType(kABStringPropertyType)).takeRetainedValue() success = ABMultiValueAddValueAndLabel(addr, "ABG@hangge.com", "公司", nil) println("设置邮箱条目结果:\(success)") success = ABRecordSetValue(newContact, kABPersonEmailProperty, addr, nil) println("设置邮箱结果:\(success)") //保存联系人 success = ABAddressBookAddRecord(addressBook, newContact, &error) println("保存记录是否成功:\(success)") //修改数据库 success = ABAddressBookSave(addressBook, &error) println("修改数据库是否成功:\(success)") } override func didReceiveMemoryWarning() { super.didReceiveMemoryWarning() }} |
2，编辑修改联系人
先获取所有联系人遍历，根据联系人姓名或者电话来判断是否修改
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
import UIKitimport AddressBookimport AddressBookUIclass ViewController: UIViewController { //address Book对象，用来获取电话簿句柄 var addressBook:ABAddressBookRef? override func viewDidLoad() { super.viewDidLoad() //定义一个错误标记对象，判断是否成功 var error:Unmanaged<CFErrorRef>? addressBook = ABAddressBookCreateWithOptions(nil, &error).takeRetainedValue() //发出授权信息 let sysAddressBookStatus = ABAddressBookGetAuthorizationStatus() if (sysAddressBookStatus == ABAuthorizationStatus.NotDetermined) { println("requesting access...") var errorRef:Unmanaged<CFError>? = nil //addressBook = extractABAddressBookRef(ABAddressBookCreateWithOptions(nil, &errorRef)) ABAddressBookRequestAccessWithCompletion(addressBook, { success, error in if success { //编辑联系人 self.editRecord(); } else { println("error") } }) } else if (sysAddressBookStatus == ABAuthorizationStatus.Denied || sysAddressBookStatus == ABAuthorizationStatus.Restricted) { println("access denied") } else if (sysAddressBookStatus == ABAuthorizationStatus.Authorized) { println("access granted") //编辑联系人 self.editRecord(); } } //编辑联系人 func editRecord(){ //定义一个错误标记对象，判断是否成功 var error:Unmanaged<CFErrorRef>? var sysContacts:NSArray = ABAddressBookCopyArrayOfAllPeople(addressBook) .takeRetainedValue() as NSArray //遍历通讯录 for contact in sysContacts { //获取姓名 var lastName = ABRecordCopyValue(contact, kABPersonLastNameProperty)? .takeRetainedValue() as! String? ?? "" println("姓：\(lastName)") var firstName = ABRecordCopyValue(contact, kABPersonFirstNameProperty)? .takeRetainedValue() as! String? ?? "" println("名：\(firstName)") var success:Bool = false if lastName == "李" && firstName == "大木"{ //设置联系人新对象昵称 success = ABRecordSetValue(contact, kABPersonNicknameProperty, "小李子", &error) println("设置昵称结果:\(success)") } } //保存数据库 var success = ABAddressBookSave(addressBook, &error) println("修改数据库是否成功:\(success)") } override func didReceiveMemoryWarning() { super.didReceiveMemoryWarning() }} |
3，删除联系人
先获取所有联系人遍历，根据联系人姓名或者电话来判断是否删除
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
import UIKitimport AddressBookimport AddressBookUIclass ViewController: UIViewController { //address Book对象，用来获取电话簿句柄 var addressBook:ABAddressBookRef? override func viewDidLoad() { super.viewDidLoad() //定义一个错误标记对象，判断是否成功 var error:Unmanaged<CFErrorRef>? addressBook = ABAddressBookCreateWithOptions(nil, &error).takeRetainedValue() //发出授权信息 let sysAddressBookStatus = ABAddressBookGetAuthorizationStatus() if (sysAddressBookStatus == ABAuthorizationStatus.NotDetermined) { println("requesting access...") var errorRef:Unmanaged<CFError>? = nil //addressBook = extractABAddressBookRef(ABAddressBookCreateWithOptions(nil, &errorRef)) ABAddressBookRequestAccessWithCompletion(addressBook, { success, error in if success { //删除联系人 self.deleteRecord(); } else { println("error") } }) } else if (sysAddressBookStatus == ABAuthorizationStatus.Denied || sysAddressBookStatus == ABAuthorizationStatus.Restricted) { println("access denied") } else if (sysAddressBookStatus == ABAuthorizationStatus.Authorized) { println("access granted") //删除联系人 self.deleteRecord(); } } //删除联系人 func deleteRecord(){ //定义一个错误标记对象，判断是否成功 var error:Unmanaged<CFErrorRef>? var sysContacts:NSArray = ABAddressBookCopyArrayOfAllPeople(addressBook) .takeRetainedValue() as NSArray //遍历通讯录 for contact in sysContacts { //获取姓名 var lastName = ABRecordCopyValue(contact, kABPersonLastNameProperty)? .takeRetainedValue() as! String? ?? "" var firstName = ABRecordCopyValue(contact, kABPersonFirstNameProperty)? .takeRetainedValue() as! String? ?? "" var success:Bool = false if lastName == "李" && firstName == "大木"{ success = ABAddressBookRemoveRecord(addressBook, contact, nil) println("删除结果：\(success)") } } //保存数据库 var success = ABAddressBookSave(addressBook, &error) println("修改数据库是否成功:\(success)") } override func didReceiveMemoryWarning() { super.didReceiveMemoryWarning() }} |
.
