Swift iOS 9通讯录访问

原创Blog，转载请注明出处

http://blog.csdn.net/hello_hwc?viewmode=list

我的stackoverflow





前言：在iOS 9之前，一直使用AddressBook这个framework来访问用户通讯录。但是在iOS 9中，AddressBook被废弃了，转而使用Contacts Framework。

文档

Contacts Framework

Contacts UI Framework

Demo效果

下载链接

请求访问权限

相关类

CNContactStore（线程安全）

CNContactStore代表了实际设备上存储,通过这个类可以

- 检查当前的通讯录访问权限

- 请求访问通讯录权限

- fetch通讯录内容（支持按条件fetch，和core data 类似）

- 保存到通讯录

CNContact（线程安全）

表示通讯录中一位联系人的Model类，和NSDictionary类似，他有一个子类是可变的CNMutableContact

示例代码

保存一个store对象，Demo中采用单例

注意，Swift中单例这么写是线程安全的

class ContactsStore{
static let sharedStore = CNContactStore()
}

请求权限

let authStatus = CNContactStore.authorizationStatusForEntityType(CNEntityType.Contacts)
let authStatus = ContactsStore.sharedStore.authorizationStatusForEntityType(CNEntityType.Contacts)
if authStatus == CNAuthorizationStatus.Denied || authStatus == CNAuthorizationStatus.NotDetermined{
self.contactsStore.requestAccessForEntityType(CNEntityType.Contacts,
completionHandler: { (result, error) -> Void in
if result == false{
let alert = UIAlertController(title: "警告", message: "请在设置中允许通讯录访问，否则App无法正常使用", preferredStyle: UIAlertControllerStyle.Alert)
alert.addAction(UIAlertAction(title: "确定", style: UIAlertActionStyle.Cancel , handler: nil))
self.presentViewController(alert, animated: true, completion: nil)
}
})
}

调用系统的ContactsPickerViewController

让ViewController实现CNContactPickerDelegate协议

实现如下方法，处理选中的结果

func contactPicker(picker: CNContactPickerViewController, didSelectContact contact: CNContact) {
if let phoneNumber =  contact.phoneNumbers.first?.value as? CNPhoneNumber{
self.textfield.text = phoneNumber.stringValue
}
}

然后，模态展示

let contactsVC = CNContactPickerViewController()
contactsVC.delegate = self;
presentViewController(contactsVC, animated:true, completion: nil)

查询全部通讯录

注意，要先指明需要fetch的属性，

因为

enumerateContactsWithFetchRequest

这个函数会抛出异常，所以要用do-try-catch包括起来

let keys = [CNContactGivenNameKey, CNContactPhoneNumbersKey, CNContactThumbnailImageDataKey]
let fetchAllRequest = CNContactFetchRequest(keysToFetch:keys)
do{
try ContactsStore.sharedStore.enumerateContactsWithFetchRequest(fetchAllRequest) { (contact, pointer) -> Void in
self.contacts.append(contact)
}
}catch{

}

条件查询

条件查询在示例工程中未列出，按照如下步骤查询

使用如下CNContact方法创建NSPredicate对象

＋ predicateForContactsMatchingName:
＋ predicateForContactsWithIdentifiers:
...

使用CNContactStore的

- unifiedContactsMatchingPredicate:keysToFetch:error:

来查询

添加

摘自Swift2.1文档

import Contacts

// Creating a mutable object to add to the contact
let contact = CNMutableContact()

contact.imageData = NSData() // The profile picture as a NSData object

contact.givenName = "John"
contact.familyName = "Appleseed"

let homeEmail = CNLabeledValue(label:CNLabelHome, value:"john@example.com")
let workEmail = CNLabeledValue(label:CNLabelWork, value:"j.appleseed@icloud.com")
contact.emailAddresses = [homeEmail, workEmail]

contact.phoneNumbers = [CNLabeledValue(
label:CNLabelPhoneNumberiPhone,
value:CNPhoneNumber(stringValue:"(408) 555-0126"))]

let homeAddress = CNMutablePostalAddress()
homeAddress.street = "1 Infinite Loop"
homeAddress.city = "Cupertino"
homeAddress.state = "CA"
homeAddress.postalCode = "95014"
contact.postalAddresses = [CNLabeledValue(label:CNLabelHome, value:homeAddress)]

let birthday = NSDateComponents()
birthday.day = 1
birthday.month = 4
birthday.year = 1988  // You can omit the year value for a yearless birthday
contact.birthday = birthday

// Saving the newly created contact
let store = CNContactStore()
let saveRequest = CNSaveRequest()
saveRequest.addContact(contact, toContainerWithIdentifier:nil)
try store.executeSaveRequest(saveRequest)

本地化/格式化

几个常用的类

CNContactFormatter

CNPostalAddressFormatter

CNContact.localizedStringForKey

CNLabeledValue.localizedStringForLabel

举例

从Contact中拼接出全名

let fullName = CNContactFormatter.stringFromContact(contact, style: .FullName)
print(fullName)
// John Appleseed

邮政地址

let postalString = CNPostalAddressFormatter.stringFromPostalAddress(homeAddress)
print(postalString)
// 1 Infinite Loop
// Cupertino
// CA
// 95014

对通讯录的内置Key获取

let displayName = CNContact.localizedStringForKey(CNContactNicknameKey)
print(displayName)
// 昵称，在中文条件下

最后

欢迎关注我的CSDN博客，在我每个月都会更新10篇左右的iOS 文章，源码都是Swift的。