通讯录开发主要是获取用户手机中的联系人,进而可以在应用中添加好友
一 .如何访问通讯录
(1)在iOS9之前,有两个框架可以访问用户的通讯录
AddressBookUI.framework: 提供了联系人列表界面,联系人详情界面,添加练习人界面等,一般用于选择联系人
AddressBook.framework: 纯C语言的API,仅仅是获的联系人数据,没有提供UI界面展示,需要自己搭建联系人展示界面,里面的数据类型大部分基于Core Foundation框架，使用起来极其蛋疼
(2)在iOS9开始,也有两个框架可以访问用户的通讯录
ContactsUI.framework: 对应AddressBookUI.framework
Contacts.framework: 对应AddressBook.framework
二.代码演示
(1)AddressBookUI的使用
使用步骤
1)创建选择联系人控制器
2)设置代理
3)实现代理方法(在代理方法中拿到用户选择的联系人)
4)弹出控制器
代码如下:
import UIKit
import AddressBookUI class ViewController: UIViewController { override func viewDidLoad() {
super.viewDidLoad()
} override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
// 1.创建联系人选择的控制器
let ppnc = ABPeoplePickerNavigationController() // 2.设置代理
ppnc.peoplePickerDelegate = self // 3.弹出控制器
present(ppnc, animated: true, completion: nil)
}
} extension ViewController : ABPeoplePickerNavigationControllerDelegate {
// 用户选中了某一个联系人
func peoplePickerNavigationController(_ peoplePicker: ABPeoplePickerNavigationController, didSelectPerson person: ABRecord) {
// 1.获取联系人的姓名
/*
Unmanaged<CFTypeRef>? : 非托管对象
* 在Swift和C语言进行混编的过程中,产生的一个临时对象,真正使用的时候需要将非托管对象,转成真正的对象才能进行使用
* takeUnretainedValue : 表示在转化的过程中,不会对对象进行一次retain操作
* takeRetainedValue : 表示在转化的过程中,有对对象进行一次retain操作
注意:一旦使用takeRetainedValue,那么必须对之前的非托管对象进行一次release(),否则就会产生内存泄漏
let UnManageObjc = ABRecordCopyValue(person, kABPersonLastNameProperty)
let lastname = UnManageObjc?.takeRetainedValue() as? String
UnManageObjc?.release()
*/
guard let lastname = ABRecordCopyValue(person, kABPersonLastNameProperty).takeUnretainedValue() as? String else { return }
guard let firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty).takeUnretainedValue() as? String else { return }
print("姓名:\(firstname) \(lastname)") // 2.获取联系人的电话号码
// ABMultiValue 类似于一个字典,里面有key/value
// 2.1.从person中拷贝出来所有的电话号码
let phones = ABRecordCopyValue(person, kABPersonPhoneProperty).takeUnretainedValue() as ABMultiValue
// 2.2.遍历ABMultiValue中的所有电话
// guard let count = phones.count else { return } 错误写法
let count = ABMultiValueGetCount(phones) for i in ..<count {
let phoneLabel = ABMultiValueCopyLabelAtIndex(phones, i).takeUnretainedValue() as String
guard let phoneValue = ABMultiValueCopyValueAtIndex(phones, i).takeUnretainedValue() as? String else { continue }
print("phoneLabel:\(phoneLabel) phoneValue:\(phoneValue)")
}
}
}
注意: 这里有一种对象 :Unmanaged<CFTypeRef>? : 非托管对象,这种对象是在Swift和C语言进行混编的过程中,出现的.需要用takeUnretainedValue() 或者 takeRetainedValue()进行转化.
运行结果如下图:
(2)AddressBook的使用
1)获取用户的授权
获取授权状态
如果用户是未决定状态,则请求授权
2)获取联系人信息
获取授权状态
如果是已经授权,则获取联系人信息
创建通讯录对象
获取通信录中所有的联系人
遍历所有的联系人,获取联系人信息
获取用户授权的代码实现,通常在应用启动时就询问用户授权
AppDelegate中代码如下所示:
import UIKit
import AddressBook @UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool { // 1.获取用户的授权状态
let status = ABAddressBookGetAuthorizationStatus() // 2.判断授权状态是否未决定
if status == .notDetermined {
// 2.1.创建通信录对象
let addressBook = ABAddressBookCreate().takeUnretainedValue() // 2.2.请求授权
ABAddressBookRequestAccessWithCompletion(addressBook, { (isFlag : Bool, error : CFError?) in
if isFlag {
print("授权成功")
} else {
print("授权失败")
}
})
} return true
}
}
ViewController中代码如下所示:
import UIKit
import AddressBook class ViewController: UIViewController { override func viewDidLoad() {
super.viewDidLoad()
} override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
// 1.获取用户授权状态
let status = ABAddressBookGetAuthorizationStatus() // 2.判断是否是已经授权
guard status == .authorized else {
return
} // 3.创建通信录对象
let addressBook = ABAddressBookCreate().takeUnretainedValue() // 4.从对象中,拷贝出来所有的联系人
let peopleArray = ABAddressBookCopyArrayOfAllPeople(addressBook).takeUnretainedValue() // 5.遍历数组,获取每一个联系人
let count = CFArrayGetCount(peopleArray)
for i in ..<count {
// 5.1.获取指针
let pointer = CFArrayGetValueAtIndex(peopleArray, i) // 5.2.获取指针指向的对象
// unsafeBitCast : 将指针转成某一个对象
let person = unsafeBitCast(pointer, to: ABRecord.self) // 5.3.获取该联系人的姓名
guard let lastname = ABRecordCopyValue(person, kABPersonLastNameProperty).takeUnretainedValue() as? String else { continue }
guard let firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty).takeUnretainedValue() as? String else { continue }
print("姓名:\(firstname) \(lastname)") // 5.4.获取电话号码
let phones = ABRecordCopyValue(person, kABPersonPhoneProperty).takeUnretainedValue() as ABMultiValue
let phoneCount = ABMultiValueGetCount(phones)
for i in ..<phoneCount {
// let phoneLabel = ABMultiValueCopyLabelAtIndex(phones, i).takeUnretainedValue() as String
guard let phoneValue = ABMultiValueCopyValueAtIndex(phones, i).takeUnretainedValue() as? String else { continue }
print(phoneValue)
}
}
}
}
注意: 由于需要访问请求授权,需要在info.plist配置NSContactsUsageDescription这个key
(3)ContactsUI的使用
1)使用步骤
创建选择联系人控制器
设置代理
实现代理方法(在代理中拿到用户选择的联系人)
弹出控制器
2)代码实现
import UIKit
import ContactsUI class ViewController: UIViewController { override func viewDidLoad() {
super.viewDidLoad()
} override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
// 1.创建联系人选择的控制器
let cpvc = CNContactPickerViewController() // 2.设置代理
cpvc.delegate = self // 3.弹出控制器
present(cpvc, animated: true, completion: nil)
}
} extension ViewController : CNContactPickerDelegate {
func contactPicker(_ picker: CNContactPickerViewController, didSelect contact: CNContact) {
// 1.获取用户的姓名
// lastname --> familyName
// firstname --> givenname
let lastname = contact.familyName
let firstname = contact.givenName
print("姓名:\(firstname) \(lastname)") // 2.获取用户电话号码(ABMultivalue)
let phones = contact.phoneNumbers
for phone in phones {
let phoneLabel = phone.label
let phoneValue = phone.value.stringValue
print("phoneLabel:\(phoneLabel). phoneValue:\(phoneValue)")
}
} }
输出结果和AddressBookUI.framework中的输出结果类似
4)Contacts
1)获取用户的授权
获取授权状态
如果用户是未决定状态,则请求授权
2)获取联系人信息
获取授权状态
如果是已经授权,则获取联系人信息
创建通讯录对象
获取通信录中所有的联系人
遍历所有的联系人,获取联系人信息
获取用户授权的代码实现,通常在应用启动时就询问用户授权,请求授权需要在info.plist配置NSContactsUsageDescription这个key
AppDelegate代码如下所示:
import UIKit
import Contacts @UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool { // 1.获取授权状态
// CNContactStore --> 通信录对象
let status = CNContactStore.authorizationStatus(for: .contacts) // 2.判断如果是未决定状态,请求授权
if status == .notDetermined {
// 2.1.创建通信录对象
let store = CNContactStore() // 2.2.请求授权
store.requestAccess(for: .contacts, completionHandler: { (isFlag : Bool, error : Error?) in
if isFlag {
print("授权成功")
} else {
print("授权失败")
}
})
} return true
}
}
ViewController中代码如下:
import UIKit
import Contacts class ViewController: UIViewController { override func viewDidLoad() {
super.viewDidLoad()
} override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
// 1.获取授权状态
let status = CNContactStore.authorizationStatus(for: .contacts) // 2.判断是否是已经授权
guard status == .authorized else {
return
} // 3.创建通信录对象
let store = CNContactStore() // 4.从通信录中获取所有的联系人
// 4.1.获取fetch,并且指定之后要获取联系人中的什么属性
let keys = [CNContactFamilyNameKey as NSString, CNContactGivenNameKey as NSString, CNContactPhoneNumbersKey as NSString] // 4.2.创建请求对象
let request = CNContactFetchRequest(keysToFetch: keys) // 4.3.遍历所有的联系人
do {
try store.enumerateContacts(with: request, usingBlock: { (contact : CNContact, stop : UnsafeMutablePointer<ObjCBool>) -> Void in
// 1.获取姓名
let lastname = contact.familyName
let firstname = contact.givenName
print(lastname, firstname) // 2.获取电话号码
let phoneNumers = contact.phoneNumbers
for phone in phoneNumers {
print(phone.label ?? "没有Label")
print(phone.value.stringValue)
}
})
} catch {
print(error)
} }
}
