简单的iOS通讯录操作封装（添加联系人、检查号码是否存在）

SJABHelper.h

#import <Foundation/Foundation.h>

enum {
ABHelperCanNotConncetToAddressBook, /**< 连接通讯录失败（iOS6之后访问通讯录需要用户许可） */
ABHelperExistSpecificContact, /**< 号码已存在 */
ABHelperNotExistSpecificContact /**< 号码不存在 */
};
typedef NSUInteger ABHelperCheckExistResultType;

@interface SJABHelper : NSObject

/**
*    添加联系人
*
*    @param     name     联系人姓名
*    @param     num     电话号码
*    @param     label     电话号码的标签备注
*
*    @return    是否添加成功
*/
+ (BOOL)addContactName:(NSString*)name phoneNum:(NSString*)num withLabel:(NSString*)label;

/**
*    查询指定号码是否已存在于通讯录中
*
*    @param     phoneNum     电话号码
*
*    @return    返回查询结果，详见枚举类型注释
*/
+ (ABHelperCheckExistResultType)existPhone:(NSString*)phoneNum;

@end

SJABHelper.m

需要引入 AddressBook framework。

#import "SJABHelper.h"
#import <AddressBook/AddressBook.h>

@implementation SJABHelper

+ (SJABHelper*)shareControl
{
static SJABHelper *instance;

static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
instance = [[SJABHelper alloc] init];
});

return instance;
}

- (id)init
{
self = [super init];
if (self) {

}
return self;
}

+ (BOOL)addContactName:(NSString *)name phoneNum:(NSString *)num withLabel:(NSString *)label
{
return [[SJABHelper shareControl] addContactName:name phoneNum:num withLabel:label];
}

- (BOOL)addContactName:(NSString*)name phoneNum:(NSString*)num withLabel:(NSString*)label
{
ABRecordRef record = ABPersonCreate();
CFErrorRef error;

// 使用 __bridge_retained 关键字将 NSString 转换为 CFString 类型并将内存管理权从 ARC 移交出来
CFStringRef cf_name = (__bridge_retained CFTypeRef)name;
CFStringRef cf_num = (__bridge_retained CFTypeRef)num;
CFStringRef cf_label = (__bridge_retained CFTypeRef)label;
ABRecordSetValue(record, kABPersonFirstNameProperty, cf_name, &error);
ABMutableMultiValueRef multi = ABMultiValueCreateMutable(kABPersonPhoneProperty);
ABMultiValueAddValueAndLabel(multi, cf_num, cf_label, NULL);
ABRecordSetValue(record, kABPersonPhoneProperty, multi, &error);
CFRelease(multi);

ABAddressBookRef addressBook = nil;

if ([[UIDevice currentDevice].systemVersion floatValue] >= 6.0)
{
addressBook = ABAddressBookCreateWithOptions(NULL, NULL);

//等待同意后向下执行
dispatch_semaphore_t sema = dispatch_semaphore_create(0);
ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error)
{
dispatch_semaphore_signal(sema);
});

dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
dispatch_release(sema);
}
else
{
addressBook = ABAddressBookCreate();
}
BOOL success = ABAddressBookAddRecord(addressBook, record, &error);
if (!success) {
CFRelease(record);
CFRelease(addressBook);
return NO;
}else{
success = ABAddressBookSave(addressBook, &error);
CFRelease(record);
CFRelease(addressBook);
return success ? YES : NO;
}
}

+ (ABHelperCheckExistResultType)existPhone:(NSString *)phoneNum
{
return [[SJABHelper shareControl] existPhone:phoneNum];
}

- (ABHelperCheckExistResultType)existPhone:(NSString*)phoneNum
{
ABAddressBookRef addressBook = nil;

if ([[UIDevice currentDevice].systemVersion floatValue] >= 6.0)
{
addressBook = ABAddressBookCreateWithOptions(NULL, NULL);

//等待同意后向下执行
dispatch_semaphore_t sema = dispatch_semaphore_create(0);
ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error)
{
dispatch_semaphore_signal(sema);
});

dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
dispatch_release(sema);
}
else
{
addressBook = ABAddressBookCreate();
}

CFArrayRef records;
if (addressBook) {
records = ABAddressBookCopyArrayOfAllPeople(addressBook);

}else{
#ifdef DEBUG
NSLog(@"can not connect to address book");
#endif
return ABHelperCanNotConncetToAddressBook;
}

for (int i=0; i<CFArrayGetCount(records); i++) {
ABRecordRef record = CFArrayGetValueAtIndex(records, i);
CFTypeRef items = ABRecordCopyValue(record, kABPersonPhoneProperty);
CFArrayRef phoneNums = ABMultiValueCopyArrayOfAllValues(items);
if (phoneNums) {
for (int j=0; j<CFArrayGetCount(phoneNums); j++) {
CFStringRef cf_phone = CFArrayGetValueAtIndex(phoneNums, j);
NSString *phone = (__bridge NSString *)cf_phone;
if ([phoneNum isEqualToString:phone]) {
CFRelease(phoneNums);
CFRelease(items);
CFRelease(records);
CFRelease(addressBook);
return ABHelperExistSpecificContact;
}
}
CFRelease(phoneNums);
}
CFRelease(items);
}

CFRelease(records);
CFRelease(addressBook);

return ABHelperNotExistSpecificContact;
}

@end

需要注意的就是iOS6中新的用户隐私保护使得调用 ABAddressBookCreate() 时会弹出alert让用户确认是否允许，需要加上代码：

　　// 如果为iOS6以上系统，需要等待用户确认是否允许访问通讯录。
if ([[UIDevice currentDevice].systemVersion floatValue] >= 6.0)
{
addressBook = ABAddressBookCreateWithOptions(NULL, NULL);
//等待同意后向下执行
dispatch_semaphore_t sema = dispatch_semaphore_create(0);
ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error)
{
dispatch_semaphore_signal(sema);
});
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
dispatch_release(sema);
}

不然addressBook在用户确认操作前是NULL，调用会导致程序crash。