本文整理兩個常見的通訊錄場景:一是直接調起系統界面讓用戶挑一個電話號碼,二是把整個通訊錄讀出來自己做界面。
這個需求完全不需要自己獲取全部聯繫人、再手寫一份通訊錄列表,直接用系統提供的 AddressBookUI/ABPeoplePickerNavigationController.h 就好。
首先引入三個頭文件:
#import <AddressBookUI/ABPeoplePickerNavigationController.h> #import <AddressBook/ABPerson.h> #import <AddressBookUI/ABPersonViewController.h>
接著初始化並呈現 ABPeoplePickerNavigationController:
ABPeoplePickerNavigationController *nav = [[ABPeoplePickerNavigationController alloc] init];
nav.peoplePickerDelegate = self;
if (IOS8_OR_LATER) {
nav.predicateForSelectionOfPerson = [NSPredicate predicateWithValue:false];
}
[self presentViewController:nav animated:YES completion:nil];
這裡有個 iOS 8 的關鍵差異:必須加上 nav.predicateForSelectionOfPerson = [NSPredicate predicateWithValue:false];,否則選中聯繫人之後會直接 dismiss,根本進不到選擇具體電話號碼的詳情頁。
最後實現代理方法。取消選擇時:
// 取消選擇
- (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker {
[peoplePicker dismissViewControllerAnimated:YES completion:nil];
}
iOS 8 下的代理實現
- (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);
if ([phoneNO hasPrefix:@"+"]) {
phoneNO = [phoneNO substringFromIndex:3];
}
phoneNO = [phoneNO stringByReplacingOccurrencesOfString:@"-" withString:@""];
NSLog(@"%@", phoneNO);
if (phone && [ZXValidateHelper checkTel:phoneNO]) {
phoneNum = phoneNO;
[self.tableView reloadData];
[peoplePicker dismissViewControllerAnimated:YES completion:nil];
return;
}
}
- (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker
didSelectPerson:(ABRecordRef)person {
ABPersonViewController *personViewController = [[ABPersonViewController alloc] init];
personViewController.displayedPerson = person;
[peoplePicker pushViewController:personViewController animated:YES];
}
iOS 7 下的代理實現
的差別在於返回值是 BOOL:返回 YES 表示讓系統繼續前進,返回 NO 表示事件已被你處理掉。
- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker
shouldContinueAfterSelectingPerson:(ABRecordRef)person {
return YES;
}
- (BOOL)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker
shouldContinueAfterSelectingPerson:(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);
if ([phoneNO hasPrefix:@"+"]) {
phoneNO = [phoneNO substringFromIndex:3];
}
phoneNO = [phoneNO stringByReplacingOccurrencesOfString:@"-" withString:@""];
NSLog(@"%@", phoneNO);
if (phone && [ZXValidateHelper checkTel:phoneNO]) {
phoneNum = phoneNO;
[self.tableView reloadData];
[peoplePicker dismissViewControllerAnimated:YES completion:nil];
return NO;
}
return YES;
}
效果演示:

實務上有幾點值得注意:号码取出後通常要做清洗(去掉國際碼前綴與分隔符)再校驗;CF 系列 API 遵循「Create Rule」,凡是帶 Copy / Create 的調用完都要相應地 CFRelease 或利用 ARC 的橋接,否則在大量數據場景下容易洩漏。
這裡需要自己拿到全部數據。首先引入頭文件:
#import <AddressBook/AddressBook.h>
然後依據權限狀態決定如何取得通訊錄引用:
- (void)loadPerson {
ABAddressBookRef addressBookRef = ABAddressBookCreateWithOptions(NULL, NULL);
if (ABAddressBookGetAuthorizationStatus() == kABAuthorizationStatusNotDetermined) {
ABAddressBookRequestAccessWithCompletion(addressBookRef, ^(bool granted, CFErrorRef error) {
CFErrorRef *error1 = NULL;
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, error1);
[self copyAddressBook:addressBook];
});
} else if (ABAddressBookGetAuthorizationStatus() == kABAuthorizationStatusAuthorized) {
CFErrorRef *error = NULL;
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, error);
[self copyAddressBook:addressBook];
} else {
dispatch_async(dispatch_get_main_queue(), ^{
// 更新界面
[hud turnToError:@"沒有獲取通訊錄權限"];
});
}
}
這段代碼覆蓋了三種授權狀態:尚未決定(主動向用戶請求)、已授權(直接讀取)、以及被拒絕(提示用戶)。記得在 Info.plist 中配置 NSContactsUsageDescription 這類用途說明,否則請求授權時 App 會直接崩潰。
接著遍歷每個聯繫人,把字段讀出來。建議自己定義一個 model 來存,而不是到處傳 ABRecordRef:
- (void)copyAddressBook:(ABAddressBookRef)addressBook {
CFIndex numberOfPeople = ABAddressBookGetPersonCount(addressBook);
CFArrayRef people = ABAddressBookCopyArrayOfAllPeople(addressBook);
for (int i = 0; i < numberOfPeople; i++) {
ABRecordRef person = CFArrayGetValueAtIndex(people, i);
// 單值字段
NSString *firstName = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonFirstNameProperty));
NSString *lastName = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonLastNameProperty));
NSString *middleName = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonMiddleNameProperty));
NSString *prefix = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonPrefixProperty));
NSString *suffix = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonSuffixProperty));
NSString *nickname = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonNicknameProperty));
// 拼音音標
NSString *firstNamePhonetic = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonFirstNamePhoneticProperty));
NSString *lastNamePhonetic = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonLastNamePhoneticProperty));
NSString *middleNamePhonetic = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonMiddleNamePhoneticProperty));
// 組織信息
NSString *organization = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonOrganizationProperty));
NSString *jobTitle = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonJobTitleProperty));
NSString *department = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonDepartmentProperty));
NSDate *birthday = (__bridge NSDate *)(ABRecordCopyValue(person, kABPersonBirthdayProperty));
NSString *note = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonNoteProperty));
NSString *firstKnow = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonCreationDateProperty));
NSString *lastKnow = (__bridge NSString *)(ABRecordCopyValue(person, kABPersonModificationDateProperty));
// 郵箱(多值)
ABMultiValueRef email = ABRecordCopyValue(person, kABPersonEmailProperty);
int emailCount = ABMultiValueGetCount(email);
for (int x = 0; x < emailCount; x++) {
NSString *emailLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(email, x));
NSString *emailContent = (__bridge NSString *)ABMultiValueCopyValueAtIndex(email, x);
}
// 地址(多值,每項是字典)
ABMultiValueRef address = ABRecordCopyValue(person, kABPersonAddressProperty);
int addressCount = ABMultiValueGetCount(address);
for (int j = 0; j < addressCount; j++) {
NSString *addressLabel = (__bridge NSString *)ABMultiValueCopyLabelAtIndex(address, j);
NSDictionary *personAddress = (__bridge NSDictionary *)ABMultiValueCopyValueAtIndex(address, j);
NSString *country = [personAddress valueForKey:(NSString *)kABPersonAddressCountryKey];
NSString *city = [personAddress valueForKey:(NSString *)kABPersonAddressCityKey];
NSString *state = [personAddress valueForKey:(NSString *)kABPersonAddressStateKey];
NSString *street = [personAddress valueForKey:(NSString *)kABPersonAddressStreetKey];
NSString *zip = [personAddress valueForKey:(NSString *)kABPersonAddressZIPKey];
NSString *countryCode = [personAddress valueForKey:(NSString *)kABPersonAddressCountryCodeKey];
}
// 日期(多值,如週年紀念)
ABMultiValueRef dates = ABRecordCopyValue(person, kABPersonDateProperty);
int datesCount = ABMultiValueGetCount(dates);
for (int y = 0; y < datesCount; y++) {
NSString *datesLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(dates, y));
NSString *datesContent = (__bridge NSString *)ABMultiValueCopyValueAtIndex(dates, y);
}
// 類型:個人 or 公司
CFNumberRef recordType = ABRecordCopyValue(person, kABPersonKindProperty);
if (recordType == kABPersonKindOrganization) {
NSLog(@"it's a company");
} else {
NSLog(@"it's a person, resource, or room");
}
// 即時通訊賬號(多值)
ABMultiValueRef instantMessage = ABRecordCopyValue(person, kABPersonInstantMessageProperty);
for (int l = 0; l < ABMultiValueGetCount(instantMessage); l++) {
NSString *imLabel = (__bridge NSString *)ABMultiValueCopyLabelAtIndex(instantMessage, l);
NSDictionary *imContent = (__bridge NSDictionary *)ABMultiValueCopyValueAtIndex(instantMessage, l);
NSString *username = [imContent valueForKey:(NSString *)kABPersonInstantMessageUsernameKey];
NSString *service = [imContent valueForKey:(NSString *)kABPersonInstantMessageServiceKey];
}
// 電話(多值)
ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
for (int k = 0; k < ABMultiValueGetCount(phone); k++) {
NSString *phoneLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(phone, k));
NSString *phoneNumber = (__bridge NSString *)ABMultiValueCopyValueAtIndex(phone, k);
}
// 網址(多值)
ABMultiValueRef url = ABRecordCopyValue(person, kABPersonURLProperty);
for (int m = 0; m < ABMultiValueGetCount(url); m++) {
NSString *urlLabel = (__bridge NSString *)ABAddressBookCopyLocalizedLabel(ABMultiValueCopyLabelAtIndex(url, m));
NSString *urlContent = (__bridge NSString *)ABMultiValueCopyValueAtIndex(url, m);
}
// 頭像
NSData *image = (__bridge NSData *)ABPersonCopyImageData(person);
}
}

讀取通訊錄時,實務上最容易踩的三個坑:
ABRecordCopyValue 返回的對象都由 Core Foundation 持有所有權,正式代碼裡應逐一 CFRelease,或統一用 ARC 橋接管理,避免大量重複讀取時內存持續攀升。ABAddressBook 這套 C API 從 iOS 9 起已被 Contacts 框架(CNContactStore、CNContact)取代。新項目應直接採用 Contacts 框架,接口更清晰、內存管理也更友好;只有在需要兼容 iOS 8 及更早系統時,才需要繼續使用這套 AddressBook API。