iOS通讯录（纯纯的干货）

一、iOS8.0

1、访问用户通讯录的两个框架

（1）AddressBookUI.framework

提供了联系人列表界面、联系人详情界面、添加联系人界面等，一般用于选择联系人

（2）AddressBook.framework

　　<1>纯C语言的API，仅仅是获得联系人数据

　　<2>没有提供UI界面展示，需要自己搭建联系人展示界面

　　<3>里面的数据类型大部分基于Core Foundation框架，使用起来非常不方便

（3）从iOS6开始，需要得到用户的授权才能访问通讯录（没UI界面的），因此在使用之前，需要检查用户是否已经授权

获得通讯录的授权状态：ABAddressBookGetAuthorizationStatus()

2、使用AddressBookUI.framework示例

#import "ViewController.h"
#import <AddressBookUI/AddressBookUI.h>
@interface ViewController () <ABPeoplePickerNavigationControllerDelegate>

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

}

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    //创建通讯录控制器
    //弹出控制器
    ABPeoplePickerNavigationController *picker  = [[ABPeoplePickerNavigationController alloc]init];

    //设置代理
    picker.peoplePickerDelegate = self;

    //展示通讯录界面
    [self presentViewController:picker animated:YES completion:nil];

}

//选中一个人的基本信息就会调用
//参数1：控制器  参数2：选择的person的信息
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person
{
    /*
    1、关于内存的管理：静态分析工具

    2、因为是C语言的API（CoreFoundation），所有使用了create、copy等获取的对象都需要释放 -> CFRelease

    3、桥接
    __bridge  默认桥接
    __bridge_transfer  桥接 coreF  -> ocF   转让对象的所有权（释放权）
    __bridge_retained  桥接 ocF  -> coreF   转让对象的所有权
    */

    //返回的ABRecordRef是一条记录，包括了一个人的所有信息字段
    //通过“函数”获得姓名
    CFStringRef strfirst =   ABRecordCopyValue(person, kABPersonFirstNameProperty);
    CFStringRef strlast =   ABRecordCopyValue(person, kABPersonLastNameProperty);

    //在桥接时，转让了对象的所有权，转给了OC来管理（自动释放了）
    NSString *strF = (__bridge_transfer NSString *)(strfirst);
    NSString *strL = (__bridge_transfer NSString *)(strlast);
    NSLog(@"%@  %@",strF,strL);

    //电话号码：ABMultiValueRef 封装一个保存了很多电话的一个类型，类似OC中的数组
    ABMultiValueRef  multiValues =   ABRecordCopyValue(person, kABPersonPhoneProperty);
    //获得这个集合的数量（电话号码的数量）
    CFIndex index = ABMultiValueGetCount(multiValues);
    //遍历集合，打印电话
    for (CFIndex i = 0; i < index; i++) {

        CFStringRef strPhone = ABMultiValueCopyValueAtIndex(multiValues, i);
        NSString *phoneStr = (__bridge_transfer  NSString *)(strPhone);
        NSLog(@"%@",phoneStr);
    }

    //释放内存前，先判断该字段存在
    if (multiValues != NULL) {
        CFRelease(multiValues);
    }

}

//选择中一个人信息的属性才会调用
//注意点：如果实现“选中个人信息的代理方法” 当前方法不执行，因为属性界面不会显示
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier
{
        NSLog(@"property %zd",property);
}

//点击取消了 就会调用
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker
{
    NSLog(@"peoplePickerNavigationControllerDidCancel");
}

3、使用AddressBook.framework框架示例

#import "ViewController.h"
#import <AddressBook/AddressBook.h>
@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    //获取用户的授权：授权状态
    /*
     kABAuthorizationStatusNotDetermined = 0,    // deprecated, use CNAuthorizationStatusNotDetermined
     kABAuthorizationStatusRestricted,           // deprecated, use CNAuthorizationStatusRestricted
     kABAuthorizationStatusDenied,               // deprecated, use CNAuthorizationStatusDenied
     kABAuthorizationStatusAuthorized            // 已经授权
     */

    //通过函数获得授权状态
    ABAuthorizationStatus status = ABAddressBookGetAuthorizationStatus();

    if (status ==  kABAuthorizationStatusNotDetermined) {

        ABAddressBookRef book =  ABAddressBookCreateWithOptions(NULL, NULL);
        //申请授权
        //参数1 通讯录对象   参数2block 回调
        ABAddressBookRequestAccessWithCompletion(book, ^(bool granted, CFErrorRef error) {
            if (granted) {
                NSLog(@"授权成功!");
            }else{
                NSLog(@"授权失败!");
            }
        });
    }
}

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    //获取联系人信息
    //获得姓名

    //通讯录是单例，在哪里获取都是一样的
    ABAddressBookRef book = ABAddressBookCreateWithOptions(NULL, NULL);

    //获取所有人的信息
    CFArrayRef allpeople =  ABAddressBookCopyArrayOfAllPeople(book);

    //数量
    CFIndex count =  CFArrayGetCount(allpeople);

    for (CFIndex i = 0; i <count ; i++) {

        //获得没一条记录
        ABRecordRef record =  CFArrayGetValueAtIndex(allpeople, i);

        //获得姓名
        CFStringRef strFirst =  ABRecordCopyValue(record, kABPersonFirstNameProperty);
        NSString *str =  (__bridge_transfer NSString *)strFirst;
        NSLog(@"%@",str);

        //获得电话号码
        ABMultiValueRef multivalue =  ABRecordCopyValue(record, kABPersonPhoneProperty);

        for (CFIndex i = 0; i < ABMultiValueGetCount(multivalue); i++) {
           CFStringRef phoneStr =   ABMultiValueCopyValueAtIndex(multivalue, i);
            NSString *phone = (__bridge_transfer  NSString *)(phoneStr);

            NSLog(@"%@",phone);
        }

        CFRelease(multivalue);

    }

    CFRelease(allpeople);
    CFRelease(book);

}
@end

二、iOS9.0

1、访问用户通讯录的两个框架

（1）ContactsUI

　　<1>AddressBookUI的升级，不需要授权

　　<2>通过代理返回需要的数据

（2）Contacts

　　AddressBook.framework 的升级

2、ContactsUI示例

#import "ViewController.h"
#import <ContactsUI/ContactsUI.h>
@interface ViewController ()<CNContactPickerDelegate>

@end

@implementation ViewController

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    //不需要授权
    //创建通讯录控制器
    CNContactPickerViewController *picker = [[CNContactPickerViewController alloc]init];
    //设置代理拿到数据本身
    picker.delegate = self;
    //展示通讯录
    [self presentViewController:picker animated:YES completion:nil];
}

//实现代理方法
//选择一个联系人的基本信息
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact;
{

    //重点注意contact的类型和属性

   NSArray *allArray = contact.phoneNumbers;
    for (CNLabeledValue * labeledValue in allArray) {
        CNPhoneNumber *num = labeledValue.value;
        NSLog(@"num = %@",num.stringValue);
        NSLog(@"===%@ ===%@",labeledValue.value,labeledValue.label);
    }
}
//选择一个联系人属性信息
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty;
{
    NSLog(@"didSelectContactProperty");
}

@end

3、Contacts示例

#import "ViewController.h"
#import <Contacts/Contacts.h>
@interface ViewController ()
@property (nonatomic, strong) CNContactStore *store;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    //获取授权状态
    CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];

    //如果没有授权过需要请求用户的授权
    CNContactStore *store = [[CNContactStore alloc]init];
    self.store = store;

    if (status == CNAuthorizationStatusNotDetermined) {
        //请求授权
        [store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {

            if (granted) {
                NSLog(@"授权成功!");
            }else{
                NSLog(@"授权失败!");
            }

        }];
    }

}
- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    //name  phone
    CNContactFetchRequest *request = [[CNContactFetchRequest alloc]initWithKeysToFetch:@[CNContactGivenNameKey,CNContactPhoneNumbersKey]];

    //参数1  封装查询请求
   [self.store enumerateContactsWithFetchRequest: request error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
       //返回的数据 CNContact
       NSLog(@"%@",contact.givenName);

       NSLog(@"%@",contact.phoneNumbers);

   }];
}
@end