实用知识：<AddressBookUI/AddressBookUI.h>（获取手机通讯录）

#import "ViewController.h"

// 提供联系人查询, 添加的UI界面
#import <AddressBookUI/AddressBookUI.h>

@interface ViewController () <UINavigationControllerDelegate, ABPeoplePickerNavigationControllerDelegate>

// 联系人查询控制器
@property (strong, nonatomic) ABPeoplePickerNavigationController *peoplePicker;

@end

@implementation ViewController

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event
{
    // 1. 创建
    self.peoplePicker = [[ABPeoplePickerNavigationController alloc] init];

    // 2. 配置
//    self.peoplePicker.delegate = self;
    // 注意: 代理属性是peoplePickerDelegate, delegate属性是从UINavigationController继承过来的
    self.peoplePicker.peoplePickerDelegate = self;

    // 3. 弹出
    [self presentViewController:self.peoplePicker animated:YES completion:nil];
}

#pragma mark - ABPeoplePickerNavigationControllerDelegate

// 点击了右上解的取消按钮时触发
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker
{
    NSLog(@"取消");
}

// 选中了某个联系人时触发
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person
{
    // 如果实现了该代理方法, 那么不会进入联系人详情界面
    NSLog(@"选中了联系人");

    /*================= 获取联系人的姓名 =================*/
    // ABRecordRef : 表示通讯录数据库当中的一条记录
    // C 语言的方法通过以自己为方法名开头, 通常第一个参数都Ref是填自己

    // person 实际上是 ABPerson, Property ID 定义在 ABPerson 里面
    // 凡是create, retain, copy, 都需要手动的去Release

    // CFTypeRef 是通用类型, 类似于 id
    CFStringRef firstname = ABRecordCopyValue(person, kABPersonFirstNameProperty);  // 名
    CFStringRef lastname = ABRecordCopyValue(person, kABPersonLastNameProperty);   // 姓

    /*================= CoreFoundation 与 Foundation 之间的转换 =================*/
    // 方式1: 直接转换, 不转移对象所有权 (负责retainCount引用计数)
//    NSString *firstNameString = (__bridge NSString *)(f\irstname);
//    NSLog(@"%@", firstNameString);
//    
//    CFRelease(firstname);

    // 方式2: 将非OC转换成OC, 转移对象所有权 (ARC)
//    NSString *firstNameString = CFBridgingRelease(firstname);
    // 两者等价
    NSString *firstNameString = (__bridge_transfer NSString *)firstname;
    NSString *lastNameString = CFBridgingRelease(lastname);
    NSLog(@"%@ : %@", firstNameString,  lastNameString);


    /*================= 获取联系人电话 =================*/
    // kABPersonPhoneProperty 得到的是 ABMultiValueRef 的值
    // ABMultiValueRef 可以理解成是一个包装 字典(Label - Value) 的 数组(多个电话)
    ABMultiValueRef multiValue = ABRecordCopyValue(person, kABPersonPhoneProperty);

    // 获取MultiValue的值的个数
    CFIndex index = ABMultiValueGetCount(multiValue);
    for (CFIndex i = 0; i < index; i++) {
        // 获取每一个索引对应的label与value
        CFStringRef label = ABMultiValueCopyLabelAtIndex(multiValue, i);
        // 电话号码也是 CFStringRef
        CFStringRef value = ABMultiValueCopyValueAtIndex(multiValue, i);

        NSLog(@"%@ : %@", CFBridgingRelease(label), CFBridgingRelease(value));
    }

    CFRelease(multiValue);
}

@end