使用場景
一些App通過手機號碼來推薦好友,如 微博、支付寶
首先客戶端會獲取通訊錄中的所有手機號然后將這些手機號提交到App服務器中,服務器會查找每個手機號對應的App賬號如QQ號碼返回到客戶端,然后客戶端根據服務器返回的賬號列表來推薦好友。
方案一:AddressBookUI.framework框架
提供了聯系人列表界面、聯系人詳情界面、添加聯系人界面等
一般用于選擇聯系人
方案二:AddressBook.framework框架:
沒有提供UI界面,需要自己搭建聯系人界面
純C語言的API, 僅僅是獲得聯系人數據
大部分數據類型是Core Foundation
從iOS6 開始,需要得到用戶的授權才能訪問通訊錄
方案三:第三方框架:RHAddressBook
對 AddressBook.framework 進行封裝
方案四:iOS9.0最新通訊錄框架
ContactsUI.framework : 方案1的替代品,特點: 面向對象,使用簡單,有界面
Contacts.framework: 方案2的替代品, 特點:面向對象,使用簡單,五界面
創建選擇聯系人的控制器
設置代理:用來接收用戶選擇的聯系人信息
彈出聯系人控制器
實現代理方法
在對應的代理方法中獲取聯系人信息
請求授權
判斷授權狀態如果已授權則繼續,如果未授權則提示用戶
創建通訊錄對象
從通訊錄中獲取所有的聯系人
遍歷所有的聯系人
釋放不再使用的對象
#import"AppDelegate.h"#import@interfaceAppDelegate()@end@implementationAppDelegate- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {// Override point for customization after application launch.[selfrequestAuthorizationAddressBook];returnYES;}- (void)requestAuthorizationAddressBook {// 判斷是否授權ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();if(authorizationStatus == kABAuthorizationStatusNotDetermined) {// 請求授權ABAddressBookRef addressBookRef =? ABAddressBookCreate();? ? ? ? ABAddressBookRequestAccessWithCompletion(addressBookRef, ^(boolgranted, CFErrorRef error) {if(granted) {// 授權成功}else{// 授權失敗NSLog(@"授權失敗!");? ? ? ? ? ? }? ? ? ? });? ? }}@end
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
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
2. iOS10 需要在Info.plist配置NSContactsUsageDescription
NSContactsUsageDescription請求訪問通訊錄
1
2
1
2
#import"ViewController.h"#import@interfaceViewController()@end@implementationViewController- (void)viewDidLoad {? ? [superviewDidLoad];}- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {// 1. 判讀授權ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();if(authorizationStatus != kABAuthorizationStatusAuthorized) {NSLog(@"沒有授權");return;? ? }// 2. 獲取所有聯系人ABAddressBookRef addressBookRef = ABAddressBookCreate();? ? CFArrayRef arrayRef = ABAddressBookCopyArrayOfAllPeople(addressBookRef);longcount = CFArrayGetCount(arrayRef);for(inti =0; i < count; i++) {//獲取聯系人對象的引用ABRecordRef people = CFArrayGetValueAtIndex(arrayRef, i);//獲取當前聯系人名字NSString*firstName=(__bridgeNSString*)(ABRecordCopyValue(people, kABPersonFirstNameProperty));//獲取當前聯系人姓氏NSString*lastName=(__bridgeNSString*)(ABRecordCopyValue(people, kABPersonLastNameProperty));NSLog(@"--------------------------------------------------");NSLog(@"firstName=%@, lastName=%@", firstName, lastName);//獲取當前聯系人的電話 數組NSMutaleArray *phoneArray = [[NSMutableArrayalloc]init];? ? ? ? ABMultiValueRef phones = ABRecordCopyValue(people, kABPersonPhoneProperty);for(NSIntegerj=0; j
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
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
https://github.com/heardrwt/RHAddressBook
該框架使用的MRC來管理內存的,如果直接將源代碼拖入進去需要為每個文件設置編譯標記:-fno-objc-arc, 設置完還會報錯,該項目使用的一些方法過于古老,很多都不支持了,所以這種方式不采用; 可以將該項目打成靜態庫的方式;也可以直接將項目拖入到自己的工程中作為一個依賴
直接將RHAddressBook.xcodeproj拖入到工程中
添加Target Dependencies和Link Binary With Libraries
Build Settings—> Other Linker Flags : -ObjC
用于解決系統分類找不到方法的錯誤
iOS10 需要在Info.plist配置NSContactsUsageDescription
NSContactsUsageDescription請求訪問通訊錄
1
2
1
2
App啟動時請求授權訪問通訊錄
#import"AppDelegate.h"#import@interfaceAppDelegate()@end@implementationAppDelegate- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {// Override point for customization after application launch.[selfrequestAuthorizationForAddressBook];returnYES;}- (void)requestAuthorizationForAddressBook {? ? RHAddressBook *ab = [[RHAddressBook alloc] init];if([RHAddressBook authorizationStatus] == RHAuthorizationStatusNotDetermined){? ? ? ? [ab requestAuthorizationWithCompletion:^(boolgranted,NSError*error) {if(granted) {? ? ? ? ? ? }else{NSLog(@"請求授權拒絕");? ? ? ? ? ? }? ? ? ? }];? ? }}@end
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
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
獲取所有聯系人的信息:姓名、手機號等
#import"ViewController.h"#import#import@interfaceViewController()@end@implementationViewController- (void)viewDidLoad {? ? [superviewDidLoad];}- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {? ? RHAddressBook *addressBook = [[RHAddressBook alloc] init];if([RHAddressBook authorizationStatus] != RHAuthorizationStatusAuthorized){NSLog(@"沒有授權");return;? ? }NSArray*peopleArray= addressBook.people;for(inti =0; i < peopleArray.count; i++) {? ? ? ? RHPerson *people = (RHPerson *)peopleArray[i];NSLog(@"%@", people.name);? ? ? ? RHMultiStringValue *phoneNumbers = people.phoneNumbers;for(inti =0; i < phoneNumbers.count; i++) {NSString* label= [phoneNumbers labelAtIndex:i];NSString* value= [phoneNumbers valueAtIndex:i];NSLog(@"label=%@, value=%@", label, value);? ? ? ? }NSLog(@"----------------------------------------------");? ? }}@end
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
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
運行結果:
#import"ViewController.h"#import@interfaceViewController() @end@implementationViewController- (void)viewDidLoad {? ? [superviewDidLoad];? ? CNContactPickerViewController *contactPickerViewController = [[CNContactPickerViewController alloc] init];? ? contactPickerViewController.delegate=self;? ? [selfpresentViewController:contactPickerViewController animated:YEScompletion:nil];}// 如果實現該方法當選中聯系人時就不會再出現聯系人詳情界面, 如果需要看到聯系人詳情界面只能不實現這個方法,- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact {NSLog(@"選中某一個聯系人時調用---------------------------------");? ? [selfprintContactInfo:contact];}// 同時選中多個聯系人- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContacts:(NSArray *)contacts {for(CNContact *contact in contacts) {NSLog(@"================================================");? ? ? ? [selfprintContactInfo:contact];? ? }}- (void)printContactInfo:(CNContact *)contact {NSString*givenName = contact.givenName;NSString*familyName = contact.familyName;NSLog(@"givenName=%@, familyName=%@", givenName, familyName);NSArray* phoneNumbers = contact.phoneNumbers;for(CNLabeledValue*phone in phoneNumbers) {NSString*label = phone.label;? ? ? ? CNPhoneNumber *phonNumber = (CNPhoneNumber *)phone.value;NSLog(@"label=%@, value=%@", label, phonNumber.stringValue);? ? }}// 注意:如果實現該方法,上面那個方法就不能實現了,這兩個方法只能實現一個//- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty {//? ? NSLog(@"選中某個聯系人的某個屬性時調用");//}@end
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
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
選擇單個聯系人時運行效果:
選擇多個聯系人的界面:
iOS10 需要在Info.plist配置NSContactsUsageDescription
NSContactsUsageDescription請求訪問通訊錄
1
2
1
2
應用啟動時請求授權:
#import"AppDelegate.h"#import@interfaceAppDelegate()@end@implementationAppDelegate- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions {// Override point for customization after application launch.[selfrequestAuthorizationForAddressBook];returnYES;}- (void)requestAuthorizationForAddressBook {? ? CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];if(authorizationStatus == CNAuthorizationStatusNotDetermined) {? ? ? ? CNContactStore *contactStore = [[CNContactStore alloc] init];? ? ? ? [contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOLgranted,NSError* _Nullable error) {if(granted) {? ? ? ? ? ? }else{NSLog(@"授權失敗, error=%@", error);? ? ? ? ? ? }? ? ? ? }];? ? }}@end
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
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
獲取通訊錄信息
#import"ViewController.h"#import@interfaceViewController()@end@implementationViewController- (void)viewDidLoad {? ? [superviewDidLoad];}- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {? ? CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];if(authorizationStatus == CNAuthorizationStatusAuthorized) {NSLog(@"沒有授權...");? ? }// 獲取指定的字段,并不是要獲取所有字段,需要指定具體的字段NSArray*keysToFetch = @[CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey];? ? CNContactFetchRequest *fetchRequest = [[CNContactFetchRequest alloc] initWithKeysToFetch:keysToFetch];? ? CNContactStore *contactStore = [[CNContactStore alloc] init];? ? [contactStore enumerateContactsWithFetchRequest:fetchRequest error:nilusingBlock:^(CNContact * _Nonnull contact,BOOL* _Nonnull stop) {NSLog(@"-------------------------------------------------------");NSString*givenName = contact.givenName;NSString*familyName = contact.familyName;NSLog(@"givenName=%@, familyName=%@", givenName, familyName);NSArray*phoneNumbers = contact.phoneNumbers;for(CNLabeledValue *labelValue in phoneNumbers) {NSString*label = labelValue.label;? ? ? ? ? ? CNPhoneNumber *phoneNumber = labelValue.value;NSLog(@"label=%@, phone=%@", label, phoneNumber.stringValue);? ? ? ? }//? ? ? ? *stop = YES;? // 停止循環,相當于break;}];}@end
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
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
運行效果:
頂
0
踩
0
上