詳解iOS獲取通訊錄的4種方式

更新時(shí)間：2020年04月15日 17:05:06 作者：vbirdbest

這篇文章主要為大家詳細(xì)介紹了iOS獲取通訊錄的4種方式，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下

本文實(shí)例為大家分享了iOS獲取通訊錄的4種方式，供大家參考，具體內(nèi)容如下

使用場景

一些App通過手機(jī)號(hào)碼來推薦好友，如微博、支付寶

首先客戶端會(huì)獲取通訊錄中的所有手機(jī)號(hào)然后將這些手機(jī)號(hào)提交到App服務(wù)器中，服務(wù)器會(huì)查找每個(gè)手機(jī)號(hào)對(duì)應(yīng)的App賬號(hào)如QQ號(hào)碼返回到客戶端，然后客戶端根據(jù)服務(wù)器返回的賬號(hào)列表來推薦好友。

獲取聯(lián)系人方式

方案一：AddressBookUI.framework框架

提供了聯(lián)系人列表界面、聯(lián)系人詳情界面、添加聯(lián)系人界面等
一般用于選擇聯(lián)系人

方案二：AddressBook.framework框架：
沒有提供UI界面，需要自己搭建聯(lián)系人界面
純C語言的API，僅僅是獲得聯(lián)系人數(shù)據(jù)
大部分?jǐn)?shù)據(jù)類型是Core Foundation
從iOS6 開始，需要得到用戶的授權(quán)才能訪問通訊錄

方案三：第三方框架：RHAddressBook
對(duì) AddressBook.framework 進(jìn)行封裝

方案四：iOS9.0最新通訊錄框架
ContactsUI.framework : 方案1的替代品，特點(diǎn)：面向?qū)ο?，使用簡單，有界?br /> Contacts.framework：方案2的替代品，特點(diǎn)：面向?qū)ο螅褂煤唵?，五界?br />

方案一：AddressBookUI.framework

實(shí)現(xiàn)步驟：

1.創(chuàng)建選擇聯(lián)系人的控制器
2.設(shè)置代理：用來接收用戶選擇的聯(lián)系人信息
3.彈出聯(lián)系人控制器
4.實(shí)現(xiàn)代理方法
5.在對(duì)應(yīng)的代理方法中獲取聯(lián)系人信息

AddressBook.frame實(shí)現(xiàn)步驟：

1.請(qǐng)求授權(quán)
2.判斷授權(quán)狀態(tài)如果已授權(quán)則繼續(xù)，如果未授權(quán)則提示用戶
3.創(chuàng)建通訊錄對(duì)象
4.從通訊錄中獲取所有的聯(lián)系人
5.遍歷所有的聯(lián)系人
6.釋放不再使用的對(duì)象

AddreesBook.framework具體實(shí)現(xiàn):

1. AppDelegate 應(yīng)用啟動(dòng)時(shí)請(qǐng)求授權(quán)

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

@interface AppDelegate ()

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 // Override point for customization after application launch.

 [self requestAuthorizationAddressBook];
 return YES;
}


- (void)requestAuthorizationAddressBook {
 // 判斷是否授權(quán)
 ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();
 if (authorizationStatus == kABAuthorizationStatusNotDetermined) {
 // 請(qǐng)求授權(quán)
 ABAddressBookRef addressBookRef = ABAddressBookCreate();
 ABAddressBookRequestAccessWithCompletion(addressBookRef, ^(bool granted, CFErrorRef error) {
  if (granted) { // 授權(quán)成功

  } else { // 授權(quán)失敗
  NSLog(@"授權(quán)失敗！");
  }
 });
 }
}
@end

2. iOS10 需要在Info.plist配置NSContactsUsageDescription

<key>NSContactsUsageDescription</key>
<string>請(qǐng)求訪問通訊錄</string>

3. ViewController

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

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
 [super viewDidLoad];
}

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
 // 1. 判讀授權(quán)
 ABAuthorizationStatus authorizationStatus = ABAddressBookGetAuthorizationStatus();
 if (authorizationStatus != kABAuthorizationStatusAuthorized) {

 NSLog(@"沒有授權(quán)");
 return;
 }

 // 2. 獲取所有聯(lián)系人
 ABAddressBookRef addressBookRef = ABAddressBookCreate();
 CFArrayRef arrayRef = ABAddressBookCopyArrayOfAllPeople(addressBookRef);
 long count = CFArrayGetCount(arrayRef);
 for (int i = 0; i < count; i++) {
 //獲取聯(lián)系人對(duì)象的引用
 ABRecordRef people = CFArrayGetValueAtIndex(arrayRef, i);

 //獲取當(dāng)前聯(lián)系人名字
 NSString *firstName=(__bridge NSString *)(ABRecordCopyValue(people, kABPersonFirstNameProperty));

 //獲取當(dāng)前聯(lián)系人姓氏
 NSString *lastName=(__bridge NSString *)(ABRecordCopyValue(people, kABPersonLastNameProperty));
 NSLog(@"--------------------------------------------------");
 NSLog(@"firstName=%@, lastName=%@", firstName, lastName);

 //獲取當(dāng)前聯(lián)系人的電話 數(shù)組
 NSMutaleArray *phoneArray = [[NSMutableArray alloc]init];
 ABMultiValueRef phones = ABRecordCopyValue(people, kABPersonPhoneProperty);
 for (NSInteger j=0; j<ABMultiValueGetCount(phones); j++) {
  NSString *phone = (__bridge NSString *)(ABMultiValueCopyValueAtIndex(phones, j));
  NSLog(@"phone=%@", phone);
  [phoneArray addObject:phone];
 }

 //獲取當(dāng)前聯(lián)系人的郵箱 注意是數(shù)組
 NSMutableArray *emailArray = [[NSMutableArray alloc]init];
 ABMultiValueRef emails= ABRecordCopyValue(people, kABPersonEmailProperty);
 for (NSInteger j=0; j<ABMultiValueGetCount(emails); j++) {
  NSString *email = (__bridge NSString *)(ABMultiValueCopyValueAtIndex(emails, j));
  NSLog(@"email=%@", email);
  [emailArray addObject:email];
 }
//獲取當(dāng)前聯(lián)系人中間名
 NSString *middleName=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonMiddleNameProperty));
 //獲取當(dāng)前聯(lián)系人的名字前綴
 NSString *prefix=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonPrefixProperty));

 //獲取當(dāng)前聯(lián)系人的名字后綴
 NSString *suffix=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonSuffixProperty));

 //獲取當(dāng)前聯(lián)系人的昵稱
 NSString *nickName=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonNicknameProperty));

 //獲取當(dāng)前聯(lián)系人的名字拼音
 NSString *firstNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonFirstNamePhoneticProperty));

 //獲取當(dāng)前聯(lián)系人的姓氏拼音
 NSString *lastNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonLastNamePhoneticProperty));

 //獲取當(dāng)前聯(lián)系人的中間名拼音
 NSString *middleNamePhoneic=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonMiddleNamePhoneticProperty));

 //獲取當(dāng)前聯(lián)系人的公司
 NSString *organization=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonOrganizationProperty));

 //獲取當(dāng)前聯(lián)系人的職位
 NSString *job=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonJobTitleProperty));

 //獲取當(dāng)前聯(lián)系人的部門
 NSString *department=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonDepartmentProperty));

 //獲取當(dāng)前聯(lián)系人的生日
 NSString *birthday=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonBirthdayProperty));

 //獲取當(dāng)前聯(lián)系人的備注
 NSString *notes=(__bridge NSString*)(ABRecordCopyValue(people, kABPersonNoteProperty));

 //獲取創(chuàng)建當(dāng)前聯(lián)系人的時(shí)間 注意是NSDate
 NSDate *creatTime=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonCreationDateProperty));

 //獲取最近修改當(dāng)前聯(lián)系人的時(shí)間
 NSDate *alterTime=(__bridge NSDate*)(ABRecordCopyValue(people, kABPersonModificationDateProperty));

 //獲取地址
 ABMultiValueRef address = ABRecordCopyValue(people, kABPersonAddressProperty);
 for (int j=0; j<ABMultiValueGetCount(address); j++) {
  //地址類型
  NSString *type = (__bridge NSString *)(ABMultiValueCopyLabelAtIndex(address, j));
  NSDictionary * tempDic = (__bridge NSDictionary *)(ABMultiValueCopyValueAtIndex(address, j));
  //地址字符串，可以按需求格式化
  NSString *adress = [NSString stringWithFormat:@"國家:%@\n省:%@\n市:%@\n街道:%@\n郵編:%@",[temDic valueForKey:(NSString*)kABPersonAddressCountryKey],[tempDic valueForKey:(NSString*)kABPersonAddressStateKey],[tempDic valueForKey:(NSString*)kABPersonAddressCityKey],[tempDic valueForKey:(NSString*)kABPersonAddressStreetKey],[tempDic valueForKey:(NSString*)kABPersonAddressZIPKey]];
 }

 //獲取當(dāng)前聯(lián)系人頭像圖片
 NSData *userImage=(__bridge NSData*)(ABPersonCopyImageData(people));

 //獲取當(dāng)前聯(lián)系人紀(jì)念日
 NSMutableArray *dateArr = [[NSMutableArray alloc]init];
 ABMultiValueRef dates= ABRecordCopyValue(people, kABPersonDateProperty);
 for (NSInteger j=0; j<ABMultiValueGetCount(dates); j++) {
  //獲取紀(jì)念日日期
  NSDate *data =(__bridge NSDate*)(ABMultiValueCopyValueAtIndex(dates, j));
  //獲取紀(jì)念日名稱
  NSString *str =(__bridge NSString*)(ABMultiValueCopyLabelAtIndex(dates, j));
  NSDictionary *tempDic = [NSDictionary dictionaryWithObject:data forKey:str];
  [dateArr addObject:tempDic];
 }
 }
}

@end

4. 運(yùn)行結(jié)果

第三方框架：RHAddressBook

https://github.com/heardrwt/RHAddressBook

該框架使用的MRC來管理內(nèi)存的，如果直接將源代碼拖入進(jìn)去需要為每個(gè)文件設(shè)置編譯標(biāo)記：-fno-objc-arc，設(shè)置完還會(huì)報(bào)錯(cuò)，該項(xiàng)目使用的一些方法過于古老，很多都不支持了，所以這種方式不采用；可以將該項(xiàng)目打成靜態(tài)庫的方式；也可以直接將項(xiàng)目拖入到自己的工程中作為一個(gè)依賴

1.直接將RHAddressBook.xcodeproj拖入到工程中

這里寫圖片描述

2.添加Target Dependencies和Link Binary With Libraries

這里寫圖片描述

3.Build Settings—> Other Linker Flags : -ObjC

用于解決系統(tǒng)分類找不到方法的錯(cuò)誤

這里寫圖片描述

4.iOS10 需要在Info.plist配置NSContactsUsageDescription

<key>NSContactsUsageDescription</key>
<string>請(qǐng)求訪問通訊錄</string>

App啟動(dòng)時(shí)請(qǐng)求授權(quán)訪問通訊錄

#import "AppDelegate.h"
#import <RHAddressBook/RHAddressBook.h>

@interface AppDelegate ()

@end

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 // Override point for customization after application launch.

 [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(@"請(qǐng)求授權(quán)拒絕");
   }
  }];
 }
}
@end

獲取所有聯(lián)系人的信息：姓名、手機(jī)號(hào)等

#import "ViewController.h"
#import <RHAddressBook/RHAddressBook.h>
#import <RHAddressBook/AddressBook.h>

@interface ViewController ()

@end

@implementation ViewController
- (void)viewDidLoad {
 [super viewDidLoad];
}

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
 RHAddressBook *addressBook = [[RHAddressBook alloc] init];
 if ([RHAddressBook authorizationStatus] != RHAuthorizationStatusAuthorized){
  NSLog(@"沒有授權(quán)");
  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

運(yùn)行結(jié)果：

ContactsUI.framework

#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];
}


// 如果實(shí)現(xiàn)該方法當(dāng)選中聯(lián)系人時(shí)就不會(huì)再出現(xiàn)聯(lián)系人詳情界面， 如果需要看到聯(lián)系人詳情界面只能不實(shí)現(xiàn)這個(gè)方法，
- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContact:(CNContact *)contact {
 NSLog(@"選中某一個(gè)聯(lián)系人時(shí)調(diào)用---------------------------------");

 [self printContactInfo:contact];
}

// 同時(shí)選中多個(gè)聯(lián)系人
- (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);
 }
}
// 注意:如果實(shí)現(xiàn)該方法，上面那個(gè)方法就不能實(shí)現(xiàn)了，這兩個(gè)方法只能實(shí)現(xiàn)一個(gè)
//- (void)contactPicker:(CNContactPickerViewController *)picker didSelectContactProperty:(CNContactProperty *)contactProperty {
// NSLog(@"選中某個(gè)聯(lián)系人的某個(gè)屬性時(shí)調(diào)用");
//}

@end

選擇單個(gè)聯(lián)系人時(shí)運(yùn)行效果：

選擇多個(gè)聯(lián)系人的界面：

Contact.framework

iOS10 需要在Info.plist配置NSContactsUsageDescription

<key>NSContactsUsageDescription</key>
<string>請(qǐng)求訪問通訊錄</string>

應(yīng)用啟動(dòng)時(shí)請(qǐng)求授權(quán)：

#import "AppDelegate.h"
#import <Contacts/Contacts.h>

@interface AppDelegate ()

@end

@implementation AppDelegate


- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
 // Override point for customization after application launch.

 [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(@"授權(quán)失敗, error=%@", error);
   }
  }];
 }
}

@end

獲取通訊錄信息

#import "ViewController.h"
#import <Contacts/Contacts.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
 [super viewDidLoad];

}

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
 CNAuthorizationStatus authorizationStatus = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
 if (authorizationStatus == CNAuthorizationStatusAuthorized) {
  NSLog(@"沒有授權(quán)...");
 }

 // 獲取指定的字段,并不是要獲取所有字段，需要指定具體的字段
 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; // 停止循環(huán)，相當(dāng)于break；
 }];

}
@end

運(yùn)行效果：