操作系统通讯录实现添加与读取联系人

引言：这是我之前写在博客园的一篇记录笔记，因个人比较喜欢的书写环境与阅读气氛，所以统一整理到这里，做个备忘吧O(∩_∩)O哈哈~！

苹果提供了访问系统通讯录的框架，以便开发者对系统通讯录进行操作。想要访问通讯录，需要添加AddressBookUI.framework和AddressBook.framework两个框架,添加的地点这里就不在赘述了。在控制器内部首先import两个头文件，和，如下所示：

//  ZBSampleViewController.m
//  ZBAddressBookDemo
//
//  Created by zhangb on 16/02/04.
//  Copyright (c) 2016年 mbp. All rights reserved.
//

#import "ZBSampleViewController.h"
#import 
#import

首先为了方便演示与操作，这里就以两个按钮的操作代替具体的访问过程，当然具体操作要具体分析，这里只是记录访问通讯录，包括：

1. 查看联系人
1. 向通讯录内添加联系人。
  下面是代码示例：ABPeoplePickerNavigationController为展示系统通讯录的控制器，并且需要遵循其代理方法。

#define IS_iOS8 [[UIDevice currentDevice].systemVersion floatValue] >= 8.0f
#define IS_iOS6 [[UIDevice currentDevice].systemVersion floatValue] >= 6.0f

@interface ZBSampleViewController (){

    ABPeoplePickerNavigationController *_abPeoplePickerVc;
    NSMutableDictionary                *_infoDictionary;
    
}
@end

- (void)viewDidLoad {
    [super viewDidLoad];
    
    //1.打开通讯录
    UIButton *openAddressBook = [UIButton buttonWithType:UIButtonTypeCustom];
    openAddressBook.frame = CGRectMake(100, 50, 100, 50);
    [openAddressBook setTitle:@"打开通讯录" forState:UIControlStateNormal];
    openAddressBook.backgroundColor = [UIColor greenColor];
    [openAddressBook setTitleColor:[UIColor blackColor] forState:UIControlStateNormal];
    [openAddressBook addTarget:self action:@selector(gotoAddressBook) forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:openAddressBook];
    
    //2.添加联系人
    UIButton *addContacts = [UIButton buttonWithType:UIButtonTypeCustom];
    addContacts.frame = CGRectMake(100, 150, 100, 50);
    [addContacts setTitle:@"添加联系人" forState:UIControlStateNormal];
    addContacts.backgroundColor = [UIColor greenColor];
    [addContacts setTitleColor:[UIColor blackColor] forState:UIControlStateNormal];
    [addContacts addTarget:self action:@selector(gotoAddContacts) forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:addContacts];

}

打开系统通讯录方法为openAddressBook按钮的点击事件，请忽略按钮的样式O(∩_∩)O~；
下面的IS_iOS8为我定义的宏，判断系统的版本（上面有代码示例）。

/**
 打开通讯录
 */
- (void)gotoAddressBook{
    
    _abPeoplePickerVc = [[ABPeoplePickerNavigationController alloc] init];
    _abPeoplePickerVc.peoplePickerDelegate = self;
    
    //下面的判断是ios8之后才需要加的，不然会自动返回app内部
    if(IS_iOS8){
        
        //predicateForSelectionOfPerson默认是true （当你点击某个联系人查看详情的时候会返回app），如果你默认为true 但是实现-peoplePickerNavigationController:didSelectPerson:property:identifier:代理方法也是可以的，与此同时不能实现peoplePickerNavigationController: didSelectPerson:不然还是会返回app。
        //总之在ios8之后加上此句比较稳妥
        _abPeoplePickerVc.predicateForSelectionOfPerson = [NSPredicate predicateWithValue:false];
        
//        predicateForSelectionOfProperty默认是true （当你点击某个联系人的某个属性的时候会返回app），此方法只要是默认值，无论你代理方法实现与否都会返回app。
        _abPeoplePickerVc.predicateForSelectionOfProperty = [NSPredicate predicateWithValue:false];
        
        //predicateForEnablingPerson默认是true，当设置为false时，所有的联系人都不能被点击。
//        _abPeoplePickerVc.predicateForEnablingPerson = [NSPredicate predicateWithValue:true];
    }
    [self presentViewController:_abPeoplePickerVc animated:YES completion:nil];
    
}

这里需要注意的是：
在iOS8之后需要加_abPeoplePickerVc.predicateForSelectionOfPerson = [NSPredicate predicateWithValue:false];这句代码，不然当你选择通讯录中的某个联系人的时候会直接返回app内部（类似crash）。predicateForSelectionOfPerson默认是true （当你点击某个联系人查看详情的时候会返回app），如果你默认为true 但是实现-peoplePickerNavigationController:didSelectPerson:property:identifier:代理方法也是可以的，与此同时不能实现peoplePickerNavigationController: didSelectPerson:不然还是会返回app。_abPeoplePickerVc.predicateForSelectionOfProperty = [NSPredicate predicateWithValue:false];
作用同上。但是_abPeoplePickerVc.predicateForEnablingPerson 的断言语句必须为true，否则任何联系人你都不能选择。上面的代码中也有详细描述。

#pragma mark - ABPeoplePickerNavigationController的代理方法

- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier {
    
    ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
    
    long index = ABMultiValueGetIndexForIdentifier(phone,identifier);
    
    NSString *phoneNO = (__bridge NSString *)ABMultiValueCopyValueAtIndex(phone, index);
    [phoneNO stringByReplacingOccurrencesOfString:@"-" withString:@""];
    if (phone && phoneNO.length == 11) {
        //TODO：获取电话号码要做的事情
         
        [peoplePicker dismissViewControllerAnimated:YES completion:nil];
        return;
    }else{
        if (IS_iOS8){
            UIAlertController *tipVc = [UIAlertController alertControllerWithTitle:nil message:@"请选择正确手机号" preferredStyle:UIAlertControllerStyleAlert];
            UIAlertAction *cancleAction = [UIAlertAction actionWithTitle:@"确定" style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {
                [self dismissViewControllerAnimated:YES completion:nil];
            }];
            [tipVc addAction:cancleAction];
            [self presentViewController:tipVc animated:YES completion:nil];
            
        }else{
            UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:nil message:@"请选择正确手机号" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil];
            [alertView show];
        }
        //非ARC模式需要释放对象
//        [alertView release];
    }
}

- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController*)peoplePicker didSelectPerson:(ABRecordRef)person NS_AVAILABLE_IOS(8_0)
{
    ABPersonViewController *personViewController = [[ABPersonViewController alloc] init];
    personViewController.displayedPerson = person;
    
    [peoplePicker pushViewController:personViewController animated:YES];
    //非ARC模式需要释放对象
//    [personViewController release];
}

/**
 peoplePickerNavigationController点击取消按钮时调用
 */
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker
{
    [peoplePicker dismissViewControllerAnimated:YES completion:nil];
}

/**
 iOS8被废弃了，iOS8前查看联系人必须实现（点击联系人可以继续操作）
 */
- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef)person NS_DEPRECATED_IOS(2_0, 8_0)
{
    return YES;
}

/**
 iOS8被废弃了，iOS8前查看联系人属性必须实现（点击联系人属性可以继续操作）
 */
- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker shouldContinueAfterSelectingPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier NS_DEPRECATED_IOS(2_0, 8_0)
{
    ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
    
    long index = ABMultiValueGetIndexForIdentifier(phone,identifier);
    
    NSString *phoneNO = (__bridge NSString *)ABMultiValueCopyValueAtIndex(phone, index);
    phoneNO = [phoneNO stringByReplacingOccurrencesOfString:@"-" withString:@""];
    NSLog(@"%@", phoneNO);
    if (phone && phoneNO.length == 11) {
        //TODO：获取电话号码要做的事情
        
        [peoplePicker dismissViewControllerAnimated:YES completion:nil];
        return NO;
    }else{
        if (IS_iOS8){
            UIAlertController *tipVc = [UIAlertController alertControllerWithTitle:nil message:@"请选择正确手机号" preferredStyle:UIAlertControllerStyleAlert];
            UIAlertAction *cancleAction = [UIAlertAction actionWithTitle:@"确定" style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {
                [self dismissViewControllerAnimated:YES completion:nil];
            }];
            [tipVc addAction:cancleAction];
            [self presentViewController:tipVc animated:YES completion:nil];
            
        }else{
            UIAlertView *alertView = [[UIAlertView alloc] initWithTitle:nil message:@"请选择正确手机号" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil];
            [alertView show];
        }
    }
    return YES;
}

ABPeoplePickerNavigationController的代理方法也很好理解，看字面意思就能够猜出代理方法的执行时间与能够做什么。拿第一个代理方法说明一下，也就是- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier；第一个参数就不用说了，第二个参数ABRecordRef 这是一个联系人的引用也可以说是一个记录，你可以理解为一个联系人。第三个参数是联系人附带属性的ID，其实ABPropertyID是个int类型值。第四个参数是多值属性的标签。

ABRecordCopyValue(ABRecordRef record, ABPropertyID property)返回一个CFTypeRef类型。此方法是从系统的通讯录内，copy出用户所选择的某个联系人数据。返回类型要看参数传递的是什么，第一个参数是联系人记录，第二个参数是参数ID，也就是用户选择的联系人的某个属性的ID。kABPersonPhoneProperty代表的是手机号码属性的ID，假如上面的ABRecordCopyValue的第二个参数传递kABPersonAddressProperty，则返回的是联系人的地址属性。下面是效果图（因为是模拟器和真机有些差异）。

读取联系人.gif

下面介绍下，向系统通讯录内添加联系人。这里我只设置了联系人的三个属性：名字，电话，邮件，并将属性存在了字典里。

-(instancetype)init{
    if (self = [super init]) {
        _infoDictionary = [NSMutableDictionary dictionaryWithCapacity:0];
        [_infoDictionary setObject:@"张三" forKey:@"name"];
        [_infoDictionary setObject:@"13000000000" forKey:@"phone"];
        [_infoDictionary setObject:@"[email protected]" forKey:@"email"];
    }
    return self;
}

因为苹果越来越注重保护用户的隐私，现在需要修改系统通讯录内的联系人信息时，必须要用户授权才可以进行。授权鉴定代码为:

ABAddressBookRequestAccessWith
Completion
(ABAddressBookRef addressBook,
ABAddressBookRequestAccessCompletionHandler completion)__OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_6_0);

下面的代码中都有详细描述。

/**
 添加联系人
 */
- (void)gotoAddContacts{
    
    //添加到通讯录,判断通讯录是否存在
    if ([self isExistContactPerson]) {//存在，返回
        //提示
        if (IS_iOS8) {
            UIAlertController *tipVc  = [UIAlertController alertControllerWithTitle:@"提示" message:@"联系人已存在..." preferredStyle:UIAlertControllerStyleAlert];
            UIAlertAction *cancleAction = [UIAlertAction actionWithTitle:@"确定" style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {
                [self dismissViewControllerAnimated:YES completion:nil];
            }];
            [tipVc addAction:cancleAction];
            [self presentViewController:tipVc animated:YES completion:nil];
        }else{
            UIAlertView *tip = [[UIAlertView alloc] initWithTitle:@"提示" message:@"联系人已存在..." delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
            [tip show];
            //        [tip release];
        }
        return;
    }else{//不存在  添加
        [self creatNewRecord];
    }
}

- (BOOL)isExistContactPerson{
    //这个变量用于记录授权是否成功，即用户是否允许我们访问通讯录
    int __block tip=0;
    
    BOOL __block isExist = NO;
    //声明一个通讯簿的引用
    ABAddressBookRef addBook =nil;
    //因为在IOS6.0之后和之前的权限申请方式有所差别，这里做个判断
    if (IS_iOS6) {
        //创建通讯簿的引用，第一个参数暂时写NULL，官方文档就是这么说的，后续会有用，第二个参数是error参数
        CFErrorRef error = NULL;
        addBook=ABAddressBookCreateWithOptions(NULL, &error);
        //创建一个初始信号量为0的信号
        dispatch_semaphore_t sema=dispatch_semaphore_create(0);
        //申请访问权限
        ABAddressBookRequestAccessWithCompletion(addBook, ^(bool greanted, CFErrorRef error)        {
            //greanted为YES是表示用户允许，否则为不允许
            if (!greanted) {
                tip=1;
                
            }else{
                //获取所有联系人的数组
                CFArrayRef allLinkPeople = ABAddressBookCopyArrayOfAllPeople(addBook);
                //获取联系人总数
                CFIndex number = ABAddressBookGetPersonCount(addBook);
                //进行遍历
                for (NSInteger i=0; iGeneral>Privacy" preferredStyle:UIAlertControllerStyleAlert];
            UIAlertAction *cancleAction = [UIAlertAction actionWithTitle:@"确定" style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {
                [self dismissViewControllerAnimated:YES completion:nil];
            }];
            [tipVc addAction:cancleAction];
            [tipVc presentViewController:tipVc animated:YES completion:nil];
        }else{
            UIAlertView * alart = [[UIAlertView alloc]initWithTitle:@"友情提示" message:@"请您设置允许APP访问您的通讯录\nSettings>General>Privacy" delegate:self cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
            [alart show];
            //非ARC
//            [alart release];
        }
    }
    return isExist;
}

//创建新的联系人
- (void)creatNewRecord
{
    CFErrorRef error = NULL;
    
    //创建一个通讯录操作对象
    ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, &error);
    
    //创建一条新的联系人纪录
    ABRecordRef newRecord = ABPersonCreate();
    
    //为新联系人记录添加属性值
    ABRecordSetValue(newRecord, kABPersonFirstNameProperty, (__bridge CFTypeRef)[_infoDictionary objectForKey:@"name"], &error);
    
    //创建一个多值属性(电话)
    ABMutableMultiValueRef multi = ABMultiValueCreateMutable(kABMultiStringPropertyType);
    ABMultiValueAddValueAndLabel(multi, (__bridge CFTypeRef)[_infoDictionary objectForKey:@"phone"], kABPersonPhoneMobileLabel, NULL);
    ABRecordSetValue(newRecord, kABPersonPhoneProperty, multi, &error);
    
    //添加email
    ABMutableMultiValueRef multiEmail = ABMultiValueCreateMutable(kABMultiStringPropertyType);
    ABMultiValueAddValueAndLabel(multiEmail, (__bridge CFTypeRef)([_infoDictionary objectForKey:@"email"]), kABWorkLabel, NULL);
    ABRecordSetValue(newRecord, kABPersonEmailProperty, multiEmail, &error);
    
    
    //添加记录到通讯录操作对象
    ABAddressBookAddRecord(addressBook, newRecord, &error);
    
    //保存通讯录操作对象
    ABAddressBookSave(addressBook, &error);
    
    //通过此接口访问系统通讯录
    ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
        
        if (granted) {
            //显示提示
            if (IS_iOS8) {
                UIAlertController *alertVc = [UIAlertController alertControllerWithTitle:@"添加成功" message:nil preferredStyle:UIAlertControllerStyleAlert];
                UIAlertAction *alertAction = [UIAlertAction actionWithTitle:@"知道了" style:UIAlertActionStyleCancel handler:^(UIAlertAction *action) {
                    [self dismissViewControllerAnimated:YES completion:nil];
                    
                }];
                [alertVc addAction:alertAction];
                [self presentViewController:alertVc animated:YES completion:nil];
            }else{
            
                UIAlertView *tipView = [[UIAlertView alloc] initWithTitle:nil message:@"添加成功" delegate:self cancelButtonTitle:@"知道了" otherButtonTitles:nil, nil];
                [tipView show];
                //非ARC
//                [tipView release];
            }
        }
    });
    
    CFRelease(multiEmail);
    CFRelease(multi);
    CFRelease(newRecord);
    CFRelease(addressBook);
}

代码中有每个步骤都有对应的注释，对应看起来会容易一些！下面是效果图：

添加联系人.gif

如果需要添加联系人的其他属性，方法类似，只是属性名不同。慢慢挖掘吧，伙伴们！

声明：此文仅为了记录本人开发中的遇到并解决的问题，权当是一篇笔记，并不是教学blog，不免会有错误，如有烦请指正，大家共同学习！谢谢！

下面列举一些参考blog：（再次感谢无私分享的coder）
http://m.open-open.com/m/code/view/1432302834146
http://supershll.blog.163.com/blog/static/37070436201272821810474/
http://www.tuicool.com/articles/Mvuu6z

注意：iOS10以及Xcode8的缘故，需要适配，需要添加访问权限设置，也就是在info.plist中添加key：Privacy - Contacts Usage Description value：对应的value值可以随便写，不然程序会崩溃！

操作系统通讯录实现添加与读取联系人

你可能感兴趣的:(操作系统通讯录实现添加与读取联系人)