您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 開發實戰:用 AddressBook 框架讀寫通訊錄

編輯:iOS 開發綜合

幾乎每個 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()。

更輕鬆的選擇:AddressBookUI

用 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

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved