幾乎每個 iOS 用戶手機裡都裝著「聯絡人」這款系統應用,它默默替我們管理著亲朋好友的電話與資訊。但在開發自己的 App 時,我們常常希望能讀取甚至修改這些聯絡資料,這時就得請出 AddressBook.framework 這位功臣了。
在 iOS 的世界裡,通訊錄其實是躺在資料庫中的。基於系統的沙盒與權限設計,Apple 並不允許開發者直接捅進資料庫去存取資料,而必須透過 AddressBook 提供的一組標準 C 語言 API 來完成所有操作。這個框架讓開發者得以從底層靈活地操控通訊錄裡的每一筆資訊,但有一點務必牢記:它是用 C 語言打造的,因此無法享受 ARC 自動記憶體管理的照顧,一切都要靠開發者自己動手管理記憶體。
在正式動手之前,先來認識幾個通訊錄操作裡經常打照面的型別:
ABAddressBookRef:代表整個通訊錄物件。透過它,開發者不必操心資料究竟怎麼存,而能以近乎透明的方式去讀取與保存。要留意的是,凡是以 AddressBook.framework 進行的新增、刪除、修改,最後都必須執行一次儲存動作,行為模式有點像 Core Data。
ABRecordRef:代表一筆通用的紀錄物件,它可以是一張聯絡人資料,也可以是一個群組,用 ABRecordGetRecordType() 就能辨明廬山真面目。當它作為聯絡人時(實務上最常見的用法),記錄的是姓名、性別、電話、郵件等一整套資訊,每筆紀錄都有一個独一无二的 ID,可透過 ABRecordGetRecordID() 取得。
ABPersonRef:專門代表聯絡人資訊,但實務上很少直接拿它來用,多數情況會改用型別為 "kABPersonType" 的 ABRecordRef 來表示聯絡人——換句話說,ABPersonRef 本質上就是一種 "kABPersonType" 類型的 ABRecordRef。
ABGroupRef:代表群組,用法與 ABPersonRef 如出一轍,實作時同樣偏好用型別為 "kABGroupType" 的 ABRecordRef 來表示。一個群組能容納多位聯絡人,一位聯絡人也能同時身處多個群組。
由於整個通訊錄操作的軸心就是對 ABRecordRef 的處理,我們先來看看操作紀錄時的幾把常用瑞士刀:
ABPersonCreate():創建一個型別為 "kABPersonType" 的 ABRecordRef。
ABRecordCopyValue():取出指定屬性的值。
ABRecordCopyCompositeName():取得聯絡人(或群組)的複合資訊。對聯絡人而言,包含姓、名、公司等;對群組而言,則回傳群組名稱。
ABRecordSetValue():設定 ABRecordRef 的屬性值。這裡有個眉角要分清楚:屬性分為單值與多值兩種。單值屬性只要用 ABRecordSetValue() 指定屬性名與值即可;多值屬性則得先打造一個 ABMutableMultiValueRef 類型的變數,用 ABMultiValueAddValueAndLabel() 逐筆塞入屬性值,最後再用 ABRecordSetValue() 把這個變數設為紀錄的值。
ABRecordRemoveValue():刪除指定的屬性值。
特別提醒:由於聯絡人涉及的屬性五花八門(讀取、設定、刪除時都可能用到),不妨翻翻 ABPerson.h,或直接在官方說明文件裡搜尋 "Personal Information Properties" 一探究竟。
整個通訊錄的存取大致遵循以下幾個步驟:
① 呼叫 ABAddressBookCreateWithOptions() 建立通訊錄物件 ABAddressBookRef。
② 呼叫 ABAddressBookRequestAccessWithCompletion() 向用戶索取存取通訊錄的授權。
③ 呼叫 ABAddressBookCopyArrayOfAllPeople() 或 ABAddressBookCopyPeopleWithName() 查詢聯絡人資訊。
④ 讀到聯絡人之後,若要顯示,就用 ABRecord 相關方法把資料取出來;若要修改,就改動 ABRecord 後呼叫 ABAddressBookSave() 提交;若要刪除,則用 ABAddressBookRemoveRecord() 刪掉,同樣再呼叫 ABAddressBookSave() 收尾。
換言之,修改與刪除都得先「查」到目標聯絡人,動完手腳後再「存」。至於新增聯絡人則不必查詢,直接 ABPersonCreate() 建一筆 ABRecord、設定好各項屬性,再用 ABAddressBookAddRecord() 加入即可。
接著就透過一個實作範例,示範如何用 ABAddressBook.framework 打造一個能查看、刪除、新增聯絡人的 App。範例以一個 UITableViewController 充當通訊錄的門面。
主控制器視圖,負責顯示、修改與刪除聯絡人:
KCContactViewController.h
//
// KCTableViewController.h
// AddressBook
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import
/**
* 定義一個協議作為代理
*/
@protocol KCContactDelegate
//新增或修改聯系人
-(void)editPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber;
//取消修改或新增
-(void)cancelEdit;
@end
@interface KCContactTableViewController : UITableViewController
@end
KCContactViewController.m
//
// KCTableViewController.m
// AddressBook
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "KCContactTableViewController.h"
#import
#import "KCAddPersonViewController.h"
@interface KCContactTableViewController ()
@property (assign,nonatomic) ABAddressBookRef addressBook;//通訊錄
@property (strong,nonatomic) NSMutableArray *allPerson;//通訊錄所有人員
@property (assign,nonatomic) int isModify;//標識是修改還是新增,通過選擇cell進行導航則認為是修改,否則視為新增
@property (assign,nonatomic) UITableViewCell *selectedCell;//當前選中的單元格
@end
@implementation KCContactTableViewController
#pragma mark - 控制器視圖
- (void)viewDidLoad {
[super viewDidLoad];
//請求訪問通訊錄並初始化數據
[self requestAddressBook];
}
//由於在整個視圖控制器周期內addressBook都駐留在內存中,所有當控制器視圖銷毀時銷毀該對象
-(void)dealloc{
if (self.addressBook!=NULL) {
CFRelease(self.addressBook);
}
}
#pragma mark - UI事件
//點擊刪除按鈕
- (IBAction)trashClick:(UIBarButtonItem *)sender {
self.tableView.editing=!self.tableView.editing;
}
#pragma mark - UITableView數據源方法
- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
return 1;
}
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
return self.allPerson.count;
}
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
static NSString *identtityKey=@"myTableViewCellIdentityKey1";
UITableViewCell *cell=[tableView dequeueReusableCellWithIdentifier:identtityKey];
if(cell==nil){
cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:identtityKey];
}
//取得一條人員記錄
ABRecordRef recordRef=(__bridge ABRecordRef)self.allPerson[indexPath.row];
//取得記錄中得信息
NSString *firstName=(__bridge NSString *) ABRecordCopyValue(recordRef, kABPersonFirstNameProperty);//注意這裡進行了強轉,不用自己釋放資源
NSString *lastName=(__bridge NSString *)ABRecordCopyValue(recordRef, kABPersonLastNameProperty);
ABMultiValueRef phoneNumbersRef= ABRecordCopyValue(recordRef, kABPersonPhoneProperty);//獲取手機號,注意手機號是ABMultiValueRef類,有可能有多條
// NSArray *phoneNumbers=(__bridge NSArray *)ABMultiValueCopyArrayOfAllValues(phoneNumbersRef);//取得CFArraryRef類型的手機記錄並轉化為NSArrary
long count= ABMultiValueGetCount(phoneNumbersRef);
// for(int i=0;i // NSString *phoneLabel= (__bridge NSString *)(ABMultiValueCopyLabelAtIndex(phoneNumbersRef, i));
// NSString *phoneNumber=(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phoneNumbersRef, i));
// NSLog(@"%@:%@",phoneLabel,phoneNumber);
// }
cell.textLabel.text=[NSString stringWithFormat:@"%@ %@",firstName,lastName];
if (count>0) {
cell.detailTextLabel.text=(__bridge NSString *)(ABMultiValueCopyValueAtIndex(phoneNumbersRef, 0));
}
if(ABPersonHasImageData(recordRef)){//如果有照片數據
NSData *imageData= (__bridge NSData *)(ABPersonCopyImageData(recordRef));
cell.imageView.image=[UIImage imageWithData:imageData];
}else{
cell.imageView.image=[UIImage imageNamed:@"avatar"];//沒有圖片使用默認頭像
}
//使用cell的tag存儲記錄id
cell.tag=ABRecordGetRecordID(recordRef);
return cell;
}
- (void)tableView:(UITableView *)tableView commitEditingStyle:(UITableViewCellEditingStyle)editingStyle forRowAtIndexPath:(NSIndexPath *)indexPath {
if (editingStyle == UITableViewCellEditingStyleDelete) {
ABRecordRef recordRef=(__bridge ABRecordRef )self.allPerson[indexPath.row];
[self removePersonWithRecord:recordRef];//從通訊錄刪除
[self.allPerson removeObjectAtIndex:indexPath.row];//從數組移除
[tableView deleteRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationFade];//從列表刪除
} else if (editingStyle == UITableViewCellEditingStyleInsert) {
// Create a new instance of the appropriate class, insert it into the array, and add a new row to the table view
}
}
#pragma mark - UITableView代理方法
-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{
self.isModify=1;
self.selectedCell=[tableView cellForRowAtIndexPath:indexPath];
[self performSegueWithIdentifier:@"AddPerson" sender:self];
}
#pragma mark - Navigation
- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender {
if([segue.identifier isEqualToString:@"AddPerson"]){
UINavigationController *navigationController=(UINavigationController *)segue.destinationViewController;
//根據導航控制器取得添加/修改人員的控制器視圖
KCAddPersonViewController *addPersonController=(KCAddPersonViewController *)navigationController.topViewController;
addPersonController.delegate=self;
//如果是通過選擇cell進行的導航操作說明是修改,否則為添加
if (self.isModify) {
UITableViewCell *cell=self.selectedCell;
addPersonController.recordID=(ABRecordID)cell.tag;//設置
NSArray *array=[cell.textLabel.text componentsSeparatedByString:@" "];
if (array.count>0) {
addPersonController.firstNameText=[array firstObject];
}
if (array.count>1) {
addPersonController.lastNameText=[array lastObject];
}
addPersonController.workPhoneText=cell.detailTextLabel.text;
}
}
}
#pragma mark - KCContact代理方法
-(void)editPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{
if (self.isModify) {
UITableViewCell *cell=self.selectedCell;
NSIndexPath *indexPath= [self.tableView indexPathForCell:cell];
[self modifyPersonWithRecordID:(ABRecordID)cell.tag firstName:firstName lastName:lastName workNumber:workNumber];
[self.tableView reloadRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationRight];
}else{
[self addPersonWithFirstName:firstName lastName:lastName workNumber:workNumber];//通訊簿中添加信息
[self initAllPerson];//重新初始化數據
[self.tableView reloadData];
}
self.isModify=0;
}
-(void)cancelEdit{
self.isModify=0;
}
#pragma mark - 私有方法
/**
* 請求訪問通訊錄
*/
-(void)requestAddressBook{
//創建通訊錄對象
self.addressBook=ABAddressBookCreateWithOptions(NULL, NULL);
//請求訪問用戶通訊錄,注意無論成功與否block都會調用
ABAddressBookRequestAccessWithCompletion(self.addressBook, ^(bool granted, CFErrorRef error) {
if (!granted) {
NSLog(@"未獲得通訊錄訪問權限!");
}
[self initAllPerson];
});
}
/**
* 取得所有通訊錄記錄
*/
-(void)initAllPerson{
//取得通訊錄訪問授權
ABAuthorizationStatus authorization= ABAddressBookGetAuthorizationStatus();
//如果未獲得授權
if (authorization!=kABAuthorizationStatusAuthorized) {
NSLog(@"尚未獲得通訊錄訪問授權!");
return ;
}
//取得通訊錄中所有人員記錄
CFArrayRef allPeople= ABAddressBookCopyArrayOfAllPeople(self.addressBook);
self.allPerson=(__bridge NSMutableArray *)allPeople;
//釋放資源
CFRelease(allPeople);
}
/**
* 刪除指定的記錄
*
* @param recordRef 要刪除的記錄
*/
-(void)removePersonWithRecord:(ABRecordRef)recordRef{
ABAddressBookRemoveRecord(self.addressBook, recordRef, NULL);//刪除
ABAddressBookSave(self.addressBook, NULL);//刪除之後提交更改
}
/**
* 根據姓名刪除記錄
*/
-(void)removePersonWithName:(NSString *)personName{
CFStringRef personNameRef=(__bridge CFStringRef)(personName);
CFArrayRef recordsRef= ABAddressBookCopyPeopleWithName(self.addressBook, personNameRef);//根據人員姓名查找
CFIndex count= CFArrayGetCount(recordsRef);//取得記錄數
for (CFIndex i=0; i ABRecordRef recordRef=CFArrayGetValueAtIndex(recordsRef, i);//取得指定的記錄
ABAddressBookRemoveRecord(self.addressBook, recordRef, NULL);//刪除
}
ABAddressBookSave(self.addressBook, NULL);//刪除之後提交更改
CFRelease(recordsRef);
}
/**
* 添加一條記錄
*
* @param firstName 名
* @param lastName 姓
* @param iPhoneName iPhone手機號
*/
-(void)addPersonWithFirstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{
//創建一條記錄
ABRecordRef recordRef= ABPersonCreate();
ABRecordSetValue(recordRef, kABPersonFirstNameProperty, (__bridge CFTypeRef)(firstName), NULL);//添加名
ABRecordSetValue(recordRef, kABPersonLastNameProperty, (__bridge CFTypeRef)(lastName), NULL);//添加姓
ABMutableMultiValueRef multiValueRef =ABMultiValueCreateMutable(kABStringPropertyType);//添加設置多值屬性
ABMultiValueAddValueAndLabel(multiValueRef, (__bridge CFStringRef)(workNumber), kABWorkLabel, NULL);//添加工作電話
ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);
//添加記錄
ABAddressBookAddRecord(self.addressBook, recordRef, NULL);
//保存通訊錄,提交更改
ABAddressBookSave(self.addressBook, NULL);
//釋放資源
CFRelease(recordRef);
CFRelease(multiValueRef);
}
/**
* 根據RecordID修改聯系人信息
*
* @param recordID 記錄唯一ID
* @param firstName 姓
* @param lastName 名
* @param homeNumber 工作電話
*/
-(void)modifyPersonWithRecordID:(ABRecordID)recordID firstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber{
ABRecordRef recordRef=ABAddressBookGetPersonWithRecordID(self.addressBook,recordID);
ABRecordSetValue(recordRef, kABPersonFirstNameProperty, (__bridge CFTypeRef)(firstName), NULL);//添加名
ABRecordSetValue(recordRef, kABPersonLastNameProperty, (__bridge CFTypeRef)(lastName), NULL);//添加姓
ABMutableMultiValueRef multiValueRef =ABMultiValueCreateMutable(kABStringPropertyType);
ABMultiValueAddValueAndLabel(multiValueRef, (__bridge CFStringRef)(workNumber), kABWorkLabel, NULL);
ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);
//保存記錄,提交更改
ABAddressBookSave(self.addressBook, NULL);
//釋放資源
CFRelease(multiValueRef);
}
@end
新增或修改控制器視圖,用於顯示一個聯系人的信息或者新增一個聯系人:
KCAddPersonViewController.h
//
// KCAddPersonViewController.h
// AddressBook
//
// kABPersonFirstNameProperty
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import
@protocol KCContactDelegate;
@interface KCAddPersonViewController : UIViewController
@property (assign,nonatomic) int recordID;//通訊錄記錄id,如果ID不為0則代表修改否則認為是新增
@property (strong,nonatomic) NSString *firstNameText;
@property (strong,nonatomic) NSString *lastNameText;
@property (strong,nonatomic) NSString *workPhoneText;
@property (strong,nonatomic) id delegate;
@end
KCAddPersonViewController.m
//
// KCAddPersonViewController.m
// AddressBook
//
// kABPersonFirstNameProperty
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "KCAddPersonViewController.h"
#import "KCContactTableViewController.h"
@interface KCAddPersonViewController ()
@property (weak, nonatomic) IBOutlet UITextField *firstName;
@property (weak, nonatomic) IBOutlet UITextField *lastName;
@property (weak, nonatomic) IBOutlet UITextField *workPhone;
@end
@implementation KCAddPersonViewController
- (void)viewDidLoad {
[super viewDidLoad];
[self setupUI];
}
#pragma mark - UI事件
- (IBAction)cancelClick:(UIBarButtonItem *)sender {
[self.delegate cancelEdit];
[self dismissViewControllerAnimated:YES completion:nil];
}
- (IBAction)doneClick:(UIBarButtonItem *)sender {
//調用代理方法
[self.delegate editPersonWithFirstName:self.firstName.text lastName:self.lastName.text workNumber:self.workPhone.text];
[self dismissViewControllerAnimated:YES completion:nil];
}
#pragma mark - 私有方法
-(void)setupUI{
if (self.recordID) {//如果ID不為0則認為是修改,此時需要初始化界面
self.firstName.text=self.firstNameText;
self.lastName.text=self.lastNameText;
self.workPhone.text=self.workPhoneText;
}
}
@end
運行效果:
AddressBook
1. 文中提到的、以 Ref 結尾的物件,其實就是該物件的指標(或參考)。在 C 語言框架裡,多數型別都會以 Ref 收尾,這個型別本身就是個指標,宣告時不必再加「*」。
2. 凡是名稱裡帶有 copy、create、new、retain 等關鍵字的方法所建立的變數,用完後都得呼叫對應的 release 方法釋放。例如以 ABPersonCreate() 建好 ABRecordRef 後,就要用 CFRelease() 回收。
3. 與許多 C 語言框架打交道時,往往會遇到 Objective-C 與 C 語言型別之間的轉換(尤其是 Obj-C 與 Core Foundation 之間)。此時可能得動用橋接,只要在強轉前面加上 "__bridge",經過橋接轉換後的型別就不必再手動維護記憶體,自然也就不用呼叫 release。
4. AddressBook 框架裡,很多型別的建立、屬性設定,都是用「型別名 + 動作」的方式命名的。熟悉其他框架後你會發現這其實是 Apple 一以貫之的命名慣例(特別是 C 語言框架)。例如要替 ABRecordRef 變數設值,就用 ABRecordSetValue()。
用 AddressBook.framework 操作通訊錄的好處是控制精準,但缺點也很明顯——面對一大堆 C 語言 API 實在有些繁瑣。於是 Apple 貼心地端出了另一套框架:AddressBookUI.framework。前面那些查看、新增、修改人員的畫面,這個框架早就備好了現成的控制器視圖供你取用。以下就是它提供的幾個控制器視圖:
ABPersonViewController:用來查看聯絡人資訊(也可設定為可編輯),需透過 displayedPerson 屬性指定要顯示或編輯的聯絡人。
ABNewPersonViewController:用來新增聯絡人資訊。
ABUnknownPersonViewController:用來顯示一位未知聯絡人(尚未儲存的聯絡人),同樣以 displayedPerson 屬性指定要顯示的物件。
這三個控制器視圖都繼承自 UIViewController,使用時必須用一個 UINavigationController 加以包裝,否則你只能看到畫面內容卻無法操作(例如 ABNewPersonViewController 若不包一層導航控制器,連「新增」和「取消」按鈕都不會出現)。同時要留意,包裝後的控制器視圖不必你去處理新增、修改的具體邏輯(這些邏輯其內部早已搞定),但你得負責關閉它(呼叫 dismissViewControllerAnimated: 方法),並可透過代理方法拿到新增或修改後的聯絡人。下面看看這三個控制器視圖各自的代理方法:
1. ABPersonViewController 的 displayViewDelegate 代理方法:
-(BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:選中某個聯絡人屬性後觸發,四個參數分別代表使用的控制器視圖、所查看的聯絡人、選中的聯絡人屬性,以及該屬性是否為多值屬性。
2. ABNewPersonViewController 的 newPersonViewDelegate 代理方法:
-(void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(ABRecordRef)person:點擊取消或完成後觸發。若參數 person 為 NULL 表示按了取消,否則代表按了完成。無論取消還是完成,此方法被呼叫時儲存動作都已完成,你不必在這裡自己存聯絡人。
3. ABUnknownPersonViewcontroller 的 unkownPersonViewDelegate 代理方法:
-(void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person:儲存此聯絡人時呼叫,呼叫後將聯絡人回傳。
-(BOOL)unknownPersonViewController:(ABUnknownPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:選中某個未知聯絡人屬性後執行,返回值代表是否執行預設動作(例如選到手機號,預設動作就是撥打該號碼)。
除了上述三類控制器視圖,AddressBookUI 還準備了另一個控制器視圖 ABPeoplePickerNavigationController,它與先前介紹過的 UIImagePickerController、MPMediaPickerController 頗為相似,只是拿來挑選聯絡人的。這個控制器視圖本身繼承自 UINavigationController,「組」與「取消」按鈕的操作開發者無需自己動手(例如按下取消時不必自己關閉視圖,它早已內建)。這裡重點說說它的 peoplePickerDelegate 代理方法:
-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person:選中一位聯絡人後執行。一旦實作了這個代理方法,另一個帶 property 參數的方法便不會再觸發;而且實作它之後,用戶只能選到聯絡人層級,無法再深入查看具體資訊。
-(void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker:用戶按下取消後執行。
-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier:選中聯絡人的具體屬性後執行。若要觸發此方法,就不能實作上一個 didSelectPerson 方法,此時點擊具體聯絡人會先導航到詳細資訊頁,用戶點了某個屬性才會觸發它。
下面來看這四個控制器視圖的實際用法。範例中定義了四個按鈕,點擊不同按鈕即呼叫不同控制器視圖作示範:
//
// ViewController.m
// AddressBookUI
//
// Created by Kenshin Cui on 14/04/05.
// Copyright (c) 2014年 cmjstudio. All rights reserved.
//
#import "ViewController.h"
#import
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
}
#pragma mark - UI事件
//添加聯系人
- (IBAction)addPersonClick:(UIButton *)sender {
ABNewPersonViewController *newPersonController=[[ABNewPersonViewController alloc]init];
//設置代理
newPersonController.newPersonViewDelegate=self;
//注意ABNewPersonViewController必須包裝一層UINavigationController才能使用,否則不會出現取消和完成按鈕,無法進行保存等操作
UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:newPersonController];
[self presentViewController:navigationController animated:YES completion:nil];
}
//
- (IBAction)unknownPersonClick:(UIButton *)sender {
ABUnknownPersonViewController *unknownPersonController=[[ABUnknownPersonViewController alloc]init];
//設置未知人員
ABRecordRef recordRef=ABPersonCreate();
ABRecordSetValue(recordRef, kABPersonFirstNameProperty, @"Kenshin", NULL);
ABRecordSetValue(recordRef, kABPersonLastNameProperty, @"Cui", NULL);
ABMultiValueRef multiValueRef=ABMultiValueCreateMutable(kABStringPropertyType);
ABMultiValueAddValueAndLabel(multiValueRef, @"18500138888", kABHomeLabel, NULL);
ABRecordSetValue(recordRef, kABPersonPhoneProperty, multiValueRef, NULL);
unknownPersonController.displayedPerson=recordRef;
//設置代理
unknownPersonController.unknownPersonViewDelegate=self;
//設置其他屬性
unknownPersonController.allowsActions=YES;//顯示標准操作按鈕
unknownPersonController.allowsAddingToAddressBook=YES;//是否允許將聯系人添加到地址簿
CFRelease(multiValueRef);
CFRelease(recordRef);
//使用導航控制器包裝
UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:unknownPersonController];
[self presentViewController:navigationController animated:YES completion:nil];
}
- (IBAction)showPersonClick:(UIButton *)sender {
ABPersonViewController *personController=[[ABPersonViewController alloc]init];
//設置聯系人
ABAddressBookRef addressBook=ABAddressBookCreateWithOptions(NULL, NULL);
ABRecordRef recordRef= ABAddressBookGetPersonWithRecordID(addressBook, 1);//取得id為1的聯系人記錄
personController.displayedPerson=recordRef;
//設置代理
personController.personViewDelegate=self;
//設置其他屬性
personController.allowsActions=YES;//是否顯示發送信息、共享聯系人等按鈕
personController.allowsEditing=YES;//允許編輯
// personController.displayedProperties=@[@(kABPersonFirstNameProperty),@(kABPersonLastNameProperty)];//顯示的聯系人屬性信息,默認顯示所有信息
//使用導航控制器包裝
UINavigationController *navigationController=[[UINavigationController alloc]initWithRootViewController:personController];
[self presentViewController:navigationController animated:YES completion:nil];
}
- (IBAction)selectPersonClick:(UIButton *)sender {
ABPeoplePickerNavigationController *peoplePickerController=[[ABPeoplePickerNavigationController alloc]init];
//設置代理
peoplePickerController.peoplePickerDelegate=self;
[self presentViewController:peoplePickerController animated:YES completion:nil];
}
#pragma mark - ABNewPersonViewController代理方法
//完成新增(點擊取消和完成按鈕時調用),注意這裡不用做實際的通訊錄增加工作,此代理方法調用時已經完成新增,當保存成功的時候參數中得person會返回保存的記錄,如果點擊取消person為NULL
-(void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(ABRecordRef)person{
//如果有聯系人信息
if (person) {
NSLog(@"%@ 信息保存成功.",(__bridge NSString *)(ABRecordCopyCompositeName(person)));
}else{
NSLog(@"點擊了取消.");
}
//關閉模態視圖窗口
[self dismissViewControllerAnimated:YES completion:nil];
}
#pragma mark - ABUnknownPersonViewController代理方法
//保存未知聯系人時觸發
-(void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person{
if (person) {
NSLog(@"%@ 信息保存成功!",(__bridge NSString *)(ABRecordCopyCompositeName(person)));
}
[self dismissViewControllerAnimated:YES completion:nil];
}
//選擇一個人員屬性後觸發,返回值YES表示觸發默認行為操作,否則執行代理中自定義的操作
-(BOOL)unknownPersonViewController:(ABUnknownPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{
if (person) {
NSLog(@"選擇了屬性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));
}
return NO;
}
#pragma mark - ABPersonViewController代理方法
//選擇一個人員屬性後觸發,返回值YES表示觸發默認行為操作,否則執行代理中自定義的操作
-(BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{
if (person) {
NSLog(@"選擇了屬性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));
}
return NO;
}
#pragma mark - ABPeoplePickerNavigationController代理方法
//選擇一個聯系人後,注意這個代理方法實現後屬性選擇的方法將不會再調用
-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person{
if (person) {
NSLog(@"選擇了%@.",(__bridge NSString *)(ABRecordCopyCompositeName(person)));
}
}
//選擇屬性之後,注意如果上面的代理方法實現後此方法不會被調用
//-(void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier{
// if (person && property) {
// NSLog(@"選擇了屬性:%i,值:%@.",property,(__bridge NSString *)ABRecordCopyValue(person, property));
// }
//}
//點擊取消按鈕
-(void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker{
NSLog(@"取消選擇.");
}
@end
運行效果:
ABPersonViewController ABNewPersonViewController
ABUnkownPersonViewController ABPeoplePickerNaviagationController