使用场景
一些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的替代品, 特点:面向对象,使用简单,五界面
方案一:AddressBookUI.framework
实现步骤:
- 创建选择联系人的控制器
- 设置代理:用来接收用户选择的联系人信息
- 弹出联系人控制器
- 实现代理方法
- 在对应的代理方法中获取联系人信息
AddressBook.frame
实现步骤:
- 请求授权
- 判断授权状态如果已授权则继续,如果未授权则提示用户
- 创建通讯录对象
- 从通讯录中获取所有的联系人
- 遍历所有的联系人
- 释放不再使用的对象
AddreesBook.framework具体实现:
1. AppDelegate 应用启动时请求授权
#import "AppDelegate.h"#import <AddressBook/AddressBook.h>@interface AppDelegate ()@end@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [self requestAuthorizationAddressBook]; return YES;}- (void)requestAuthorizationAddressBook { ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus(); if (authorizationStatus == kABAuthorizationStatusNotDetermined) { ABAddressBookRef addressBookRef = ABAddressBookCreate(); ABAddressBookRequestAccessWithCompletion(addressBookRef, ^(bool granted, 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
<key>NSContactsUsageDescription</key><string>请求访问通讯录</string>
3. ViewController
#import "ViewController.h"#import <AddressBook/AddressBook.h>@interface ViewController ()@end@implementation ViewController- (void)viewDidLoad { [super viewDidLoad];}- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event { ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus(); if (authorizationStatus != kABAuthorizationStatusAuthorized) { NSLog(@"没有授权"); return; } ABAddressBookRef addressBookRef = ABAddressBookCreate(); CFArrayRef arrayRef = ABAddressBookCopyArrayOfAllPeople(addressBookRef); long count = CFArrayGetCount(arrayRef); for (int i = 0; i < count; i++) { ABRecordRef people = CFArrayGetValueAtIndex(arrayRef, i); NSString *firstName=(__bridge NSString *)(ABRecordCopyValue(people, kABPersonFirstNameProperty)); NSString *lastName=(__bridge NSString *)(ABRecordCopyValue(people, kABPersonLastNameProperty)); NSLog(@"--------------------------------------------------"); NSLog(@"firstName=%@, lastName=%@", firstName, lastName); NSMutaleArray *phoneArray = [[NSMutableArray alloc]init]; ABMultiValueRef phones = ABRecordCopyValue(people, kABPersonPhoneProperty); for (NSInteger j=0; j<ABMultiValueGetCount(phones); j++) { NSString *phone = (__bridge NSString *)(ABMultiValueCopyValueAtIndex(phones, j)); NSLog(@"phone=%@", phone); [phoneArray addObject:phone]; } NSMutableArray *emailArray = [[NSMutableArray alloc]init]; ABMultiValueRef emails= ABRecordCopyValue(people, kABPersonEmailProperty); for (NSInteger j=0; j<ABMultiValueGetCount(emails); j++) { NSString *email = (__bridge NSString *)(ABMultiValueCopyValueAtIndex(emails, j)); NSLog(@"email=%@", email); [emailArray addObject:email]; } NSString *middleName=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonMiddleNameProperty)); NSString *prefix=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonPrefixProperty)); NSString *suffix=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonSuffixProperty)); NSString *nickName=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonNicknameProperty)); NSString *firstNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonFirstNamePhoneticProperty)); NSString *lastNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonLastNamePhoneticProperty)); NSString *middleNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonMiddleNamePhoneticProperty)); NSString *organization=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonOrganizationProperty)); NSString *job=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonJobTitleProperty)); NSString *department=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonDepartmentProperty)); NSString *birthday=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonBirthdayProperty)); NSString *notes=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonNoteProperty)); NSDate *creatTime=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonCreationDateProperty)); NSDate *alterTime=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonModificationDateProperty)); ABMultiValueRef address = ABRecordCopyValue(people, kABPersonAddressProperty); for (int j=0; j<ABMultiValueGetCount(address); j++) { NSString *type = (__bridge NSString *)(ABMultiValueCopyLabelAtIndex(address, j)); NSDictionary * tempDic = (__bridge NSDictionary *)(ABMultiValueCopyValueAtIndex(address, j)); NSString *adress = [NSString stringWithFormat:@"国家:%@\n省:%@\n市:%@\n街道:%@\n邮编:%@",[temDic valueForKey:(NSString*)kABPersonAddressCountryKey],[tempDic valueForKey:(NSString*)kABPersonAddressStateKey],[tempDic valueForKey:(NSString*)kABPersonAddressCityKey],[tempDic valueForKey:(NSString*)kABPersonAddressStreetKey],[tempDic valueForKey:(NSString*)kABPersonAddressZIPKey]]; } NSData *userImage=(__bridge NSData*)(ABPersonCopyImageData(people)); NSMutableArray *dateArr = [[NSMutableArray alloc]init]; ABMultiValueRef dates= ABRecordCopyValue(people, kABPersonDateProperty); for (NSInteger j=0; j<ABMultiValueGetCount(dates); j++) { NSDate *data =(__bridge NSDate*)(ABMultiValueCopyValueAtIndex(dates, j)); NSString *str =(__bridge NSString*)(ABMultiValueCopyLabelAtIndex(dates, j)); NSDictionary *tempDic = [NSDictionary dictionaryWithObject:data forKey:str]; [dateArr addObject:tempDic]; } }}@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
- 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
4. 运行结果
第三方框架:RHAddressBook
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
<key>NSContactsUsageDescription</key><string>请求访问通讯录</string>
- App启动时请求授权访问通讯录
#import "AppDelegate.h"#import <RHAddressBook/RHAddressBook.h>@interface AppDelegate ()@end@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [self requestAuthorizationForAddressBook]; return YES;}- (void)requestAuthorizationForAddressBook { RHAddressBook *ab = [[RHAddressBook alloc] init]; if ([RHAddressBook authorizationStatus] == RHAuthorizationStatusNotDetermined){ [ab requestAuthorizationWithCompletion:^(bool granted, 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 <RHAddressBook/RHAddressBook.h>#import <RHAddressBook/AddressBook.h>@interface ViewController ()@end@implementation ViewController- (void)viewDidLoad { [super viewDidLoad];}- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event { RHAddressBook *addressBook = [[RHAddressBook alloc] init]; if ([RHAddressBook authorizationStatus] != RHAuthorizationStatusAuthorized){ NSLog(@"没有授权"); return; } NSArray *peopleArray= addressBook.people; for (int i = 0; i < peopleArray.count; i++) { RHPerson *people = (RHPerson *)peopleArray[i]; NSLog(@"%@", people.name); RHMultiStringValue *phoneNumbers = people.phoneNumbers; for (int i = 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 <ContactsUI/ContactsUI.h>@interface ViewController () <CNContactPickerDelegate>@end@implementation ViewController- (void)viewDidLoad { [super viewDidLoad]; CNContactPickerViewController *contactPickerViewController = [[CNContactPickerViewController alloc] init]; contactPickerViewController.delegate = self; [self presentViewController:contactPickerViewController animated:YES completion:nil];}- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact { NSLog(@"选中某一个联系人时调用---------------------------------"); [self printContactInfo:contact];}- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContacts:(NSArray<CNContact *> *)contacts { for (CNContact *contact in contacts) { NSLog(@"================================================"); [self printContactInfo:contact]; }}- (void)printContactInfo:(CNContact *)contact { NSString *givenName = contact.givenName; NSString *familyName = contact.familyName; NSLog(@"givenName=%@, familyName=%@", givenName, familyName); NSArray * phoneNumbers = contact.phoneNumbers; for (CNLabeledValue<CNPhoneNumber*>*phone in phoneNumbers) { NSString *label = phone.label; CNPhoneNumber *phonNumber = (CNPhoneNumber *)phone.value; NSLog(@"label=%@, value=%@", label, phonNumber.stringValue); }}@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
<key>NSContactsUsageDescription</key><string>请求访问通讯录</string>
应用启动时请求授权:
#import "AppDelegate.h"#import <Contacts/Contacts.h>@interface AppDelegate ()@end@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [self requestAuthorizationForAddressBook]; return YES;}- (void)requestAuthorizationForAddressBook { CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts]; if (authorizationStatus == CNAuthorizationStatusNotDetermined) { CNContactStore *contactStore = [[CNContactStore alloc] init]; [contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, 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 <Contacts/Contacts.h>@interface ViewController ()@end@implementation ViewController- (void)viewDidLoad { [super viewDidLoad];}- (void)touchesBegan:(NSSet<UITouch *> *)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:nil usingBlock:^(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); } }];}@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
运行效果:
http://blog.csdn.net/vbirdbest/article/details/52880944