获取系统通讯录

支持本文作者Mr_洛先森，请阅读原文
获取通讯录样式：

1176549-b5aa0acd402b2a56.png.jpeg

在ios中,有两个框架可以访问用户的通讯录

• AddressBookUI.framework
• 提供了联系人列表界面, 联系人详情界面, 添加联系人界面等
• 一般用于选择联系人
• AddressBook.framework
• 纯C语言的API, 仅仅能获取到联系人数据
• 没有提供UI界面展示, 需要自己搭建联系人展示界面
• 里面的数据类型大部分基于Core Foundation框架
• 从ios6开始, 需要得到用户的授权才能访问通讯录, 因此在使用之前需要检查用户是否已经授权(使用AddressBookUI默认已经授权)
• 获得通讯录的授权状态:ABAddressBookGetAuthorizationStatus()
  • kABAuthorizationStatusNotDetermined: 用户还没有决定是否授权你的应用程序进行访问
  • kABAuthorizationStatusRestricted: iOS设备上一些许可配置阻止程序与通讯录数据库进行交互
  • kABAuthorizationStatusDenied: 用户明确的拒绝了你的程序对通讯录的访问
  • kABAuthorizationStatusAuthorized: 用户已经授权给你的程序对通讯录进行访问
• 申请通讯录访问授权(一般在程序启动时的application:didFinishLaunchingWithOptions:代理里面写)

// 1.获取授权的状态
ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();

// 2.判断授权状态,如果是未决定状态,才需要请求
if (status == kABAuthorizationStatusNotDetermined) {
  // 2.1.创建通信录对象
  ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL);

  // 2.2.请求授权
  ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
            if (granted) {
                NSLog(@"授权成功");
            } else {
                NSLog(@"授权失败");
            }
        });
    }

1.使用<AddressBookUI.framework>访问通讯录

• 1. 导入框架import <AddressBookUI/AddressBookUI.h>
• 2. 创建通讯录界面

// 1.创建选择联系人的界面
ABPeoplePickerNavigationController *ppnc = [[ABPeoplePickerNavigationController alloc] init];

// 2.设置代理
ppnc.peoplePickerDelegate = self;

// 3.弹出选择联系人界面
[self presentViewController:ppnc animated:YES completion:nil];

• 3.实现代理方法

// 实现代理
@interface ViewController<ABPeoplePickerNavigationControllerDelegate>
@end
#pragma mark - 实现ABPeoplePickerNavigationController的代理方法
// 选中某一个联系人的时候,会执行该代理方法
// 如果实现了该方法,那么就不会进入联系人的详细界面
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person
{
/*
 __bridge NSString * : 将CoreFoundation框架的对象所有权交给Foundation框架来使用,但是Foundation框架中的对象并不能管理该对象内存
 __bridge_transfer NSString * : 将CoreFoundation框架的对象所有权交给Foundation来管理,如果Foundation中对象销毁,那么我们之前的对象(CoreFoundation)会一起销毁
 */
  // 1.获取选中联系人的姓名(姓lastname和名firstname)
  CFStringRef firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty);
  CFStringRef lastname = ABRecordCopyValue(person, kABPersonLastNameProperty);
  NSString *firstName = (__bridge_transfer NSString *)(firstname);
  NSString *lastName = (__bridge_transfer NSString *)(lastname);
  NSLog(@"%@ %@", firstName, lastName);
  // 2.获取联系人的电话号码
  ABMultiValueRef phones = ABRecordCopyValue(person, kABPersonPhoneProperty);
  CFIndex count = ABMultiValueGetCount(phones);
    for (CFIndex i = 0; i < count; i++) {
        NSString *phoneLabel = (__bridge_transfer NSString *)ABMultiValueCopyLabelAtIndex(phones, i);
        NSString *phoneValue = (__bridge_transfer NSString *)ABMultiValueCopyValueAtIndex(phones, i);
        NSLog(@"label : %@ value : %@", phoneLabel, phoneValue);
  }
  // 3.释放不再使用的对象
  CFRelease(phones);
}
// 选择某一个联系人的某一个属性时,会执行该方法
// property选中的属性
// identifier : 每一个属性都由一个对应标示
// 如果实现了该方法,那么选中一个联系人的属性时,就会推出控制器.不会进入下一个页面
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
{
NSLog(@"选择了某一个联系人的某一个属性");
}
// 点击了取消按钮会执行该方法
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker
{    
}

2.使用<AddressBook.framework>访问通讯录

• 1.导入框架import <AddressBook/AddressBook.h>
• 2.访问通讯录

// 1.获取授权的状态
ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();

// 2.如果用户已经授权
if (status != kABAuthorizationStatusAuthorized) return;

// 3.创建通信录对象
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL);

// 4.从通信录对象中,将所有的联系人拷贝出来
CFArrayRef peopleArray = ABAddressBookCopyArrayOfAllPeople(addressBook);

// 5.遍历所有的联系人(每一个联系人都是一条记录)
CFIndex peopleCount = CFArrayGetCount(peopleArray);
for (CFIndex i = 0; i < peopleCount; i++) {

    // 6.获取到联系人
    ABRecordRef person = CFArrayGetValueAtIndex(peopleArray, i);

    // 7.获取姓名
    NSString *lastname = (__bridge_transfer NSString *)ABRecordCopyValue(person, kABPersonLastNameProperty);
    NSString *firstName = (__bridge_transfer NSString *)ABRecordCopyValue(person, kABPersonFirstNameProperty);
    NSLog(@"%@ %@", lastname, firstName);
}

// 8.释放不再使用的对象
CFRelease(peopleArray);
CFRelease(addressBook);

3.使用第三方框架<RHAddressBook/AddressBook.h>访问通讯录

• 1.授权

#import  <RHAddressBook/AddressBook.h>
// 1.获取授权状态
RHAuthorizationStatus status = [RHAddressBook authorizationStatus];

// 2.判断授权状态,如果未决定状态,则请求授权
if (status == RHAuthorizationStatusNotDetermined) {
    // 3.创建通信录对象
    RHAddressBook *addressBook = [[RHAddressBook alloc] init];

    // 4.请求授权
    [addressBook requestAuthorizationWithCompletion:^(bool granted, NSError *error) {
        if (granted) {
            NSLog(@"授权成功");
        } else {
            NSLog(@"授权失败");
        }
    }];
}

• 2.访问通讯录

// 1.获取授权状态
RHAuthorizationStatus status = [RHAddressBook authorizationStatus];

// 2.判断如果是未授权,则直接返回
if (status != RHAuthorizationStatusAuthorized) return;

// 3.创建通信录
RHAddressBook *addressBook = [[RHAddressBook alloc] init];

// 4.获取所有的联系人
NSArray *peopleArray = addressBook.people;

// 5.遍历所有的联系人
for (RHPerson *person in peopleArray) {

    // 6.获取联系人的姓名
    NSLog(@"%@ %@", person.firstName, person.lastName);

    // 7.获取电话号码
    RHMultiValue *phones = person.phoneNumbers;
    for (int i = 0; i < phones.count; i++) {
        // 8.获取电话号码和对应的Label
        NSString *phoneLabel = [phones labelAtIndex:i];
        NSString *phoneValue = [phones valueAtIndex:i];

        NSLog(@"%@ %@", phoneLabel, phoneValue);
    }
}