一些 App 透過手機號碼推薦好友,如微博、支付寶。流程是:客戶端先獲取通訊錄中的所有手機號並提交到服務器,服務器查找每個手機號對應的 App 帳號後返回客戶端,客戶端再根據帳號列表推薦好友。
方案一:AddressBookUI.framework——提供聯繫人列表、詳情、添加等界面,通常用於選擇聯繫人。
方案二:AddressBook.framework——不提供 UI,需自行搭建界面;純 C 語言 API,僅獲得聯繫人數據;大部分數據類型是 Core Foundation;從 iOS 6 開始需獲得用戶授權才能訪問通訊錄。
方案三:第三方框架 RHAddressBook——對 AddressBook.framework 進行封裝。
方案四:iOS 9.0 最新通訊錄框架。ContactsUI.framework 是方案一的替代品,特點是面向對象、使用簡單、有界面;Contacts.framework 是方案二的替代品,特點是面向對象、使用簡單、無界面。
1. 創建選擇聯繫人的控制器;2. 設置代理以接收用戶選擇的聯繫人資訊;3. 彈出聯繫人控制器;4. 實現代理方法;5. 在代理方法中獲取聯繫人資訊。
1. 請求授權;2. 判斷授權狀態,已授權則繼續,未授權則提示用戶;3. 創建通訊錄對象;4. 獲取所有聯繫人;5. 遍歷所有聯繫人;6. 釋放不再使用的對象。
#import "AppDelegate.h"
#import <AddressBook/AddressBook.h>
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[self requestAuthorizationAddressBook];
return YES;
}
- (void)requestAuthorizationAddressBook {
// 判斷是否授權
ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();
if (authorizationStatus == kABAuthorizationStatusNotDetermined) {
// 請求授權
ABAddressBookRef addressBookRef = ABAddressBookCreate();
ABAddressBookRequestAccessWithCompletion(addressBookRef, ^(bool granted, CFErrorRef error) {
if (granted) {
// 授權成功
} else {
NSLog(@"授權失敗!");
}
});
}
}
@end
<key>NSContactsUsageDescription</key> <string>請求訪問通訊錄</string>
#import "ViewController.h"
#import <AddressBook/AddressBook.h>
@implementation ViewController
- (void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
// 1. 判斷授權
ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();
if (authorizationStatus != kABAuthorizationStatusAuthorized) {
NSLog(@"沒有授權");
return;
}
// 2. 獲取所有聯繫人
ABAddressBookRef addressBookRef = ABAddressBookCreate();
CFArrayRef arrayRef = ABAddressBookCopyArrayOfAllPeople(addressBookRef);
long count = CFArrayGetCount(arrayRef);
for (int i = 0; i < count; i++) {
// 獲取聯繫人對象的引用
ABRecordRef people = CFArrayGetValueAtIndex(arrayRef, i);
// 獲取當前聯繫人名字
NSString *firstName = (__bridge NSString *)(ABRecordCopyValue(people, kABPersonFirstNameProperty));
// 獲取當前聯繫人姓氏
NSString *lastName = (__bridge NSString *)(ABRecordCopyValue(people, kABPersonLastNameProperty));
NSLog(@"firstName=%@, lastName=%@", firstName, lastName);
// 獲取當前聯繫人的電話數組
NSMutableArray *phoneArray = [[NSMutableArray alloc] init];
ABMultiValueRef phones = ABRecordCopyValue(people, kABPersonPhoneProperty);
// 遍歷電話號碼...
}
}
@end


https://github.com/heardrwt/RHAddressBook
該框架使用 MRC 管理內存,直接拖入源碼需為每個文件設置編譯標記 -fno-objc-arc,設置後仍可能報錯(部分方法過於古老、多已不支援),因此不建議此方式;可將項目打成靜態庫,或直接把項目拖入工程作為依賴。
直接將 RHAddressBook.xcodeproj 拖入工程:
添加 Target Dependencies 和 Link Binary With Libraries:
Build Settings → Other Linker Flags 添加 -ObjC,用於解決系統分類找不到方法的錯誤:
iOS 10 需在 Info.plist 配置 NSContactsUsageDescription:
<key>NSContactsUsageDescription</key> <string>請求訪問通訊錄</string>
App 啟動時請求授權訪問通訊錄:
#import "AppDelegate.h"
#import <RHAddressBook/RHAddressBook.h>
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[self requestAuthorizationForAddressBook];
return YES;
}
- (void)requestAuthorizationForAddressBook {
RHAddressBook *ab = [[RHAddressBook alloc] init];
if ([RHAddressBook authorizationStatus] == RHAuthorizationStatusNotDetermined){
[ab requestAuthorizationWithCompletion:^(bool granted, NSError *error) {
if (granted) {
} else {
NSLog(@"請求授權拒絕");
}
}];
}
}
@end
獲取所有聯繫人資訊(姓名、手機號等):
#import "ViewController.h"
#import <RHAddressBook/RHAddressBook.h>
#import <RHAddressBook/RHAddressBook.h>
@implementation ViewController
- (void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
RHAddressBook *addressBook = [[RHAddressBook alloc] init];
if ([RHAddressBook authorizationStatus] != RHAuthorizationStatusAuthorized){
NSLog(@"沒有授權");
return;
}
NSArray *peopleArray = addressBook.people;
for (int i = 0; i < peopleArray.count; i++) {
RHPerson *people = (RHPerson *)peopleArray[i];
NSLog(@"%@", people.name);
RHMultiStringValue *phoneNumbers = people.phoneNumbers;
for (int i = 0; i < phoneNumbers.count; i++) {
NSString *label = [phoneNumbers labelAtIndex:i];
NSString *value = [phoneNumbers valueAtIndex:i];
NSLog(@"label=%@, value=%@", label, value);
}
NSLog(@"----------------------------------------------");
}
}
@end
運行結果:
#import "ViewController.h"
#import <ContactsUI/ContactsUI.h>
@interface ViewController () <CNContactPickerDelegate>
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
CNContactPickerViewController *contactPickerViewController = [[CNContactPickerViewController alloc] init];
contactPickerViewController.delegate = self;
[self presentViewController:contactPickerViewController animated:YES completion:nil];
}
// 選中單個聯繫人時調用(實現此方法後不再出現詳情界面)
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact {
NSLog(@"選中某一個聯繫人時調用-----------------");
[self printContactInfo:contact];
}
// 同時選中多個聯繫人
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContacts:(NSArray<CNContact *> *)contacts {
for (CNContact *contact in contacts) {
NSLog(@"================================================");
[self printContactInfo:contact];
}
}
- (void)printContactInfo:(CNContact *)contact {
NSString *givenName = contact.givenName;
NSString *familyName = contact.familyName;
NSLog(@"givenName=%@, familyName=%@", givenName, familyName);
NSArray *phoneNumbers = contact.phoneNumbers;
for (CNLabeledValue<CNPhoneNumber*> *phone in phoneNumbers) {
NSString *label = phone.label;
CNPhoneNumber *phonNumber = (CNPhoneNumber *)phone.value;
NSLog(@"label=%@, value=%@", label, phonNumber.stringValue);
}
}
// 注意: 若實現下面這個方法,上面那個就不能實現,兩者只能選其一
// - (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty {
// NSLog(@"選中某個聯繫人的某個屬性時調用");
// }
@end
選擇單個聯繫人時的運行效果:

選擇多個聯繫人的界面:

iOS 10 需要在 Info.plist 配置 NSContactsUsageDescription:
<key>NSContactsUsageDescription</key> <string>請求訪問通訊錄</string>
應用啟動時請求授權:
#import "AppDelegate.h"
#import <Contacts/Contacts.h>
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[self requestAuthorizationForAddressBook];
return YES;
}
- (void)requestAuthorizationForAddressBook {
CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
if (authorizationStatus == CNAuthorizationStatusNotDetermined) {
CNContactStore *contactStore = [[CNContactStore alloc] init];
[contactStore requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
if (granted) {
} else {
NSLog(@"授權失敗, error=%@", error);
}
}];
}
}
@end
獲取通訊錄資訊:
#import "ViewController.h"
#import <Contacts/Contacts.h>
@implementation ViewController
- (void)touchesBegan:(NSSet<UITouch> *)touches withEvent:(UIEvent *)event {
CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
if (authorizationStatus == CNAuthorizationStatusAuthorized) {
NSLog(@"已授權...");
}
// 獲取指定字段,需指定具體字段而非全部
NSArray *keysToFetch = @[CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey];
CNContactFetchRequest *fetchRequest = [[CNContactFetchRequest alloc] initWithKeysToFetch:keysToFetch];
CNContactStore *contactStore = [[CNContactStore alloc] init];
[contactStore enumerateContactsWithFetchRequest:fetchRequest error:nil usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
NSLog(@"-------------------------------------------------------");
NSString *givenName = contact.givenName;
NSString *familyName = contact.familyName;
NSLog(@"givenName=%@, familyName=%@", givenName, familyName);
NSArray *phoneNumbers = contact.phoneNumbers;
for (CNLabeledValue *labelValue in phoneNumbers) {
NSString *label = labelValue.label;
CNPhoneNumber *phoneNumber = labelValue.value;
NSLog(@"label=%@, phone=%@", label, phoneNumber.stringValue);
}
// *stop = YES; // 停止循環,相當於 break
}];
}
@end
運行效果:
