Swift

来源：互联网发布：苹果anywhere软件编辑：程序博客网时间：2024/05/17 03:33

在 iOS9.0 之前, 我们只能通过 AddressBook 框架来获取通讯录联系人信息。但 AddressBook framework 语法很奇怪，同时也十分难用。所以苹果从 iOS9.0 开始推出的全新的联系人框架 Contacts FrameWork 作为替代，同时将原来的 AddressBook 给废弃掉。

Contacts FrameWork 同样包含两种访问通讯录的方式：

ContactsUI.framework 框架：通过系统提供的通讯录交互界面来访问（替代原先的 AddressBookUI.framework）
Contacts.framework 框架：没有界面，通过代码来获取所有联系人信息（替代原先的 AddressBook.framework）

前文中我介绍了 ContactsUI.framework 的使用，本文接着演示 Contacts.framework 框架的使用。

一、Contacts.framework介绍

1，Contacts使用步骤

（1）获取用户的授权，如果授权则往下继续进行。

（2）创建通讯录对象

（3）创建联系人请求对象

（4）遍历所有联系人，获取联系人信息

2，联系人记录的属性

每一条联系人记录中，都有很多属性，而这些属性又分为单值属性和多值属性。

（1）单值属性是只有一个值的属性：

familyName ：姓
givenName ：名
middleName ：中间名
previousFamilyName ：前缀
nameSuffix ：后缀
phoneticFamilyName ：姓氏汉语拼音或音标
phoneticGivenName ：名字汉语拼音或音标
nickname ：昵称
organizationName ：公司（组织）
jobTitle ：职位
departmentName ：部门
note ：备注

（2）多值属性是包含多个值的集合类型：

phoneNumbers ：电话
emailAddresses ：Email
postalAddresses ：地址
urlAddresses ：URL属性
dates ：纪念日
instantMessageAddresses ：获取即时通讯(IM)
socialProfiles ：社交账号
contactRelations ：亲属关系人

3，多值属性标签的本地名称

在多值属性中包含了 label（标签）、value（值）和 ID 等部分，其中标签和值都是可以重复的，而 ID 是不能重复的。

对于标签，我们可以使用 CNLabeledValue<NSString>.localizedString(forLabel:) 方法转为本地标签名（即能看得懂的标签名，比如 work、home）。要不然打印出来的是 _$!<Home>!$_，_$!<Work>!$_ 这样的数据。

二、获取所有联系人信息

1，效果图

（1）程序启动后自动开始请求并获取通讯录信息。

（2）同时将通讯录里的所有联系人信息输出到控制台中。（具体包括联系人的姓名、昵称、公司、职位、部门、备注、电话、email、地址、纪念日、即时通讯）

2，Info.plist配置

由于苹果安全策略更新，在使用 Xcode8 开发时，需要在 Info.plist 配置请求通讯录的相关描述字段（Privacy - Contacts Usage Description）

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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
import UIKit
import Contacts
 
class ViewController: UIViewController {
     
    override func viewDidLoad() {
        super.viewDidLoad()
        CNContactStore().requestAccess(for: .contacts) { (isRight, error) in
            if isRight {
                //授权成功加载数据。
                self.loadContactsData()
            }
        }
    }
     
    func loadContactsData() {
        //获取授权状态
        let status = CNContactStore.authorizationStatus(for: .contacts)
        //判断当前授权状态
        guard status == .authorized else { return }
         
        //创建通讯录对象
        let store = CNContactStore()
         
        //获取Fetch,并且指定要获取联系人中的什么属性
        let keys = [CNContactFamilyNameKey, CNContactGivenNameKey, CNContactNicknameKey,
                    CNContactOrganizationNameKey, CNContactJobTitleKey,
                    CNContactDepartmentNameKey, CNContactNoteKey, CNContactPhoneNumbersKey,
                    CNContactEmailAddressesKey, CNContactPostalAddressesKey,
                    CNContactDatesKey, CNContactInstantMessageAddressesKey
        ]
         
        //创建请求对象，需要传入一个(keysToFetch: [CNKeyDescriptor]) 包含'CNKeyDescriptor'类型的数组
        let request = CNContactFetchRequest(keysToFetch: keys as [CNKeyDescriptor])
         
        //遍历所有联系人
        do {
            try store.enumerateContacts(with: request, usingBlock: {
                (contact : CNContact, stop : UnsafeMutablePointer<ObjCBool>) -> Void in
                 
                //获取姓名
                let lastName = contact.familyName
                let firstName = contact.givenName
                print("姓名：\(lastName)\(firstName)")
                 
                //获取昵称
                let nikeName = contact.nickname
                print("昵称：\(nikeName)")
                 
                //获取公司（组织）
                let organization = contact.organizationName
                print("公司（组织）：\(organization)")
                 
                //获取职位
                let jobTitle = contact.jobTitle
                print("职位：\(jobTitle)")
                 
                //获取部门
                let department = contact.departmentName
                print("部门：\(department)")
                 
                //获取备注
                let note = contact.note
                print("备注：\(note)")
                 
                //获取电话号码
                print("电话：")
                for phone in contact.phoneNumbers {
                    //获得标签名（转为能看得懂的本地标签名，比如work、home）
                    let label = CNLabeledValue<NSString>.localizedString(forLabel: phone.label!)
                    //获取号码
                    let value = phone.value.stringValue
                    print("\t\(label)：\(value)")
                }
                 
                //获取Email
                print("Email：")
                for email in contact.emailAddresses {
                    //获得标签名（转为能看得懂的本地标签名）
                    let label = CNLabeledValue<NSString>.localizedString(forLabel: email.label!)
                    //获取值
                    let value = email.value
                    print("\t\(label)：\(value)")
                }
                 
                //获取地址
                print("地址：")
                for address in contact.postalAddresses {
                    //获得标签名（转为能看得懂的本地标签名）
                    let label = CNLabeledValue<NSString>.localizedString(forLabel: address.label!)
                    //获取值
                    let detail = address.value
                    let contry = detail.value(forKey: CNPostalAddressCountryKey) ?? ""
                    let state = detail.value(forKey: CNPostalAddressStateKey) ?? ""
                    let city = detail.value(forKey: CNPostalAddressCityKey) ?? ""
                    let street = detail.value(forKey: CNPostalAddressStreetKey) ?? ""
                    let code = detail.value(forKey: CNPostalAddressPostalCodeKey) ?? ""
                    let str = "国家:\(contry) 省:\(state) 城市:\(city) 街道:\(street) 邮编:\(code)"
                    print("\t\(label)：\(str)")
                }
                 
                //获取纪念日
                print("纪念日：")
                for date in contact.dates {
                    //获得标签名（转为能看得懂的本地标签名）
                    let label = CNLabeledValue<NSString>.localizedString(forLabel: date.label!)
                    //获取值
                    let dateComponents = date.value as DateComponents
                    let value = NSCalendar.current.date(from: dateComponents)
                    let dateFormatter = DateFormatter()
                    dateFormatter.dateFormat = "yyyy年MM月dd日 HH:mm:ss"
                    print("\t\(label)：\(dateFormatter.string(from: value!))")
                }
                 
                //获取即时通讯(IM)
                print("即时通讯(IM)：")
                for im in contact.instantMessageAddresses {
                    //获得标签名（转为能看得懂的本地标签名）
                    let label = CNLabeledValue<NSString>.localizedString(forLabel: im.label!)
                    //获取值
                    let detail = im.value
                    let username = detail.value(forKey: CNInstantMessageAddressUsernameKey) ?? ""
                    let service = detail.value(forKey: CNInstantMessageAddressServiceKey) ?? ""
                    print("\t\(label)：\(username) 服务:\(service)")
                }
                 
                print("----------------")
                 
            })
        } catch {
            print(error)
        }
    }
 
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

阅读全文

1 0