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

iOS學習筆記(二十九):系統服務(二)通訊錄開發

編輯:iOS 開發綜合

一、通訊錄概覽

在iOS中,通訊錄其實是存放在資料庫裡的。由於iOS嚴格的權限設計,開發者並不被允許直接存取通訊錄資料庫,要操作通訊錄就必須借助AddressBook.framework框架。

AddressBook.framework

能從底層精確地操作通訊錄的所有資訊,控制力最強;但它是以C語言撰寫的,無法用ARC管理記憶體,需要開發者手動管理;此外還得自行打造UI介面。

除此之外,iOS也提供了另一個操作通訊錄的框架——AddressBookUI.framework。

AddressBookUI.framework

它封裝了AddressBook.framework,向外提供現成的視圖控制器;能使用ARC管理記憶體;缺點是高度封裝、介面固定,客製化的空間較小。

這兩個框架各有所長也各有所短,究竟採用哪一個,端看實際需求而定。

二、AddressBook

AddressBook.framework是基於C語言的,缺少物件導向的思維,因此我們可以把其中的一些結構體理解為一個「類別」。

幾個核心結構體

ABAddressBookRef:通訊錄物件,全域管理通訊錄操作,例如修改、儲存等。
ABRecordRef:通用的記錄物件,可以是一筆聯絡人資訊,也可以是一個群組,透過型別來區分,每筆記錄都有一個唯一ID識別碼。
ABPersonRef:聯絡人資訊,較少直接使用,可用型別為kABPersonType的ABRecordRef代替。
ABGroupRef:群組資訊,較少直接使用,可用型別為kABGroupType的ABRecordRef代替。

常用於記錄 Record 的 C 語言函式

 /* 獲取一條記錄對象的唯一標識ID */ ABRecordID ABRecordGetRecordID(ABRecordRef record); /* 創建一條記錄對象,類型為kABPersonType,表示一條聯系人信息 */ ABRecordRef ABPersonCreate(void); /* 創建一條記錄對象,類型為kABGroupType,表示一條群組信息 */ ABRecordRef ABGroupCreate(void); /* 獲取指定屬性的值 */ CFTypeRef ABRecordCopyValue(ABRecordRef record, ABPropertyID property); /* 設置紀錄的屬性值,返回設置是否成功 */ bool ABRecordSetValue( ABRecordRef record, /* 記錄 */ ABPropertyID property, /* 屬性 */ CFTypeRef value, /* 值,可以是單值,也可以是多重值 */ CFErrorRef* error /* 錯誤信息 */ ); /* 向多重值添加單值 */ bool ABMultiValueAddValueAndLabel( ABMutableMultiValueRef multiValue, /* 多重值 */ CFTypeRef value, /* 單值 */ CFStringRef label, /* 單值對應的屬性名 */ ABMultiValueIdentifier *outIdentifier /* 多重值的標示 */ ); /* 從多重值中取出指定索引的單值 */ CFTypeRef ABMultiValueCopyValueAtIndex( ABMultiValueRef multiValue, CFIndex index ); /* 刪除指定的屬性值 */ bool ABRecordRemoveValue( ABRecordRef record, /* 記錄 */ ABPropertyID property, /* 屬性 */ CFErrorRef* error /* 錯誤信息 */ );

常用的通訊錄操作函式

 /* 創建通訊錄對象 */ ABAddressBookRef ABAddressBookCreate(void); /* 操作通訊錄用戶授權,注意無論成功與否回調都會調用 */ void ABAddressBookRequestAccessWithCompletion( ABAddressBookRef addressBook, /* 通訊錄 */ ABAddressBookRequestAccessCompletionHandler completion /* 回調 */ ); /* 獲取通訊錄所有的記錄 */ CFArrayRef ABAddressBookCopyArrayOfAllPeople(ABAddressBookRef addressBook); /* 添加記錄進通訊錄 */ bool ABAddressBookAddRecord( ABAddressBookRef addressBook, /* 通訊錄 */ ABRecordRef record, /* 記錄 */ CFErrorRef* error /* 錯誤信息 */ ); /* 從通訊錄刪除記錄 */ bool ABAddressBookRemoveRecord( ABAddressBookRef addressBook,/* 通訊錄 */ ABRecordRef record, /* 記錄 */ CFErrorRef* error/* 錯誤信息 */ ); /* 從通訊錄中獲取一個記錄,根據記錄ID */ ABRecordRef ABAddressBookGetPersonWithRecordID( ABAddressBookRef addressBook, /* 通訊錄 */ ABRecordID recordID /* 記錄ID */ ); /* 保持通訊錄,修改了通訊錄需要保存提交修改 */ bool ABAddressBookSave( ABAddressBookRef addressBook, /* 通訊錄 */ CFErrorRef* error /* 錯誤信息 */ );

通訊錄使用步驟

建立通訊錄物件ABAddressBookRef,接著請求使用者授權操作通訊錄ABAddressBookRequestAccessWithCompletion,再查詢所有通訊錄記錄ABAddressBookCopyArrayOfAllPeople,之後進行新增、刪除、修改記錄的操作,最後別忘了修改後要儲存通訊錄ABAddressBookSave。

實際程式碼

1. 建立通訊錄並請求授權
 /* 請求訪問通訊錄並獲取通訊錄所有記錄 */ - (void)requestAddressBook{ //創建通訊錄對象 self.addressBook = ABAddressBookCreate(); //請求訪問用戶通訊錄,注意無論成功與否block都會調用 ABAddressBookRequestAccessWithCompletion(self.addressBook, ^(bool granted, CFErrorRef error) { if (!granted) { NSLog(@"未獲得通訊錄訪問權限!"); } //獲取所有通訊錄記錄 [self initAllPerson]; //刷新表格 [self.tableView reloadData]; }); } /* 取得所有通訊錄記錄 */ - (void)initAllPerson{ //取得通訊錄訪問授權 ABAuthorizationStatus authorization = ABAddressBookGetAuthorizationStatus(); //如果未獲得授權 if (authorization != kABAuthorizationStatusAuthorized) { NSLog(@"尚未獲得通訊錄訪問授權!"); return ; } //取得通訊錄中所有人員記錄 CFArrayRef allPeople = ABAddressBookCopyArrayOfAllPeople(self.addressBook); self.allPerson = (__bridge NSMutableArray *)allPeople; //釋放資源 CFRelease(allPeople); }
2. 新增聯絡人
  /** * 添加一條記錄 * * @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); }
3. 刪除聯絡人
 /* 刪除指定的記錄 */ - (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
4. 修改聯絡人
 /** * 根據記錄ID修改聯系人信息 * * @param recordID 記錄唯一ID * @param firstName 姓 * @param lastName 名 * @param homeNumber 工作電話 */ - (void)modifyPersonWithRecordID:(ABRecordID)recordID firstName:(NSString *)firstName lastName:(NSString *)lastName workNumber:(NSString *)workNumber { //根據記錄ID獲取一條記錄 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); }
5. 以 UITableView 呈現
 #pragma mark - TableView代理和數據源 - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section { if (!self.allPerson) { return 0; } return self.allPerson.count; } - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { static NSString *key = @"cellIdentify"; UITableViewCell *cell = [self.tableView dequeueReusableCellWithIdentifier:key]; if (!cell) { cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:key]; } //取得一條人員記錄 ABRecordRef recordRef = (__bridge ABRecordRef)self.allPerson[indexPath.row]; //取得記錄中得信息,注意這裡進行了強轉,不用自己釋放資源 NSString *firstName = (__bridge NSString *)ABRecordCopyValue(recordRef, kABPersonFirstNameProperty); NSString *lastName = (__bridge NSString *)ABRecordCopyValue(recordRef, kABPersonLastNameProperty); //獲取手機號,注意手機號是ABMultiValueRef類,有可能有多條 ABMultiValueRef phoneNumbersRef = ABRecordCopyValue(recordRef, kABPersonPhoneProperty); long count = ABMultiValueGetCount(phoneNumbersRef); for(int i = 0;i < count;++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)); } //使用cell的tag存儲記錄ID cell.tag = ABRecordGetRecordID(recordRef); //記錄最後一個記錄的ID if (indexPath.row == self.allPerson.count - 1) { self.lastID = ABRecordGetRecordID(recordRef); } return cell; }
6. UI 點擊與視圖控制器的初始化、銷毀
 - (void)viewDidLoad { [super viewDidLoad]; self.tableView.delegate = self; self.tableView.dataSource = self; //請求訪問通訊錄並獲取通訊錄所有記錄 [self requestAddressBook]; } //由於在整個視圖控制器周期內addressBook都駐留在內存中,所以當控制器視圖銷毀時銷毀該對象 - (void)dealloc{ if (self.addressBook != NULL) { CFRelease(self.addressBook); } } #pragma mark - UI點擊 - (IBAction)addPerson:(id)sender { //添加聯系人 [self addPersonWithFirstName:@"liu" lastName:@"ting" workNumber:@"13412321332"]; //獲取所有通訊錄記錄 [self initAllPerson]; //刷新表格 [self.tableView reloadData]; } - (IBAction)removePerson:(id)sender { //刪除聯系人 [self removePersonWithName:@"liu ting"]; //獲取所有通訊錄記錄 [self initAllPerson]; //刷新表格 [self.tableView reloadData]; } - (IBAction)changePerson:(id)sender { [self modifyPersonWithRecordID:self.lastID firstName:@"XXXX" lastName:@"YYY" workNumber:@"1111111111"]; //獲取所有通訊錄記錄 [self initAllPerson]; //刷新表格 [self.tableView reloadData]; }

三、AddressBookUI

AddressBookUI這個框架直接提供了現成的控制器視圖供開發者使用,高度封裝。

框架中提供的控制器視圖

ABPersonViewController:用於檢視聯絡人資訊(可設定為編輯)。需設定displayedPerson屬性來指定要顯示或編輯的聯絡人。
ABNewPersonViewController:用於新增聯絡人資訊。
ABUnknownPersonViewController:用於顯示一個未知聯絡人(尚未儲存的聯絡人)資訊,需設定displayedPerson屬性。
ABPeoplePickerNavigationController:用於選擇聯絡人。

前三個控制器視圖皆繼承自UIViewController,使用時必須以一個UINavigationController包裝,否則只能看到內容而無法操作,並且必須自行處理關閉動作;新增、修改後的聯絡人則可透過代理方法取得。最後一個控制器視圖繼承自UINavigationController,其「完成」、「取消」按鈕的行為已由系統實作,開發者不必再自行處理關閉。

這四個控制器的代理方法

 #pragma mark - ABPersonViewController代理方法 //選擇一個人員屬性後觸發,返回值YES表示觸發默認行為操作,否則執行代理中自定義的操作 - (BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier; #pragma mark - ABNewPersonViewController代理方法 /* 完成新增(點擊取消和完成按鈕時調用),注意這裡不用做實際的通訊錄增加工作, 此代理方法調用時已經完成新增,當保存成功的時候參數中得person會返回保存的記錄,如果點擊取消person為NULL */ - (void)newPersonViewController:(ABNewPersonViewController *)newPersonView didCompleteWithNewPerson:(ABRecordRef)person; #pragma mark - ABUnknownPersonViewController代理方法 //保存未知聯系人時觸發 - (void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person; #pragma mark - ABPeoplePickerNavigationController代理方法 //選擇一個聯系人後調用,注意這個代理方法實現後選擇屬性的方法將不會再調用 - (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person; //選擇屬性之後調用,注意如果上面的代理方法實現後此方法不會被調用 - (void)peoplePickerNavigationController:(ABPeoplePickerNavigationController *)peoplePicker didSelectPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier; //點擊取消按鈕調用 - (void)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker;

具體程式碼示例(此處包裝了一個全域導航控制器)

 #import "addressBookUIViewController.h" #import @interface addressBookUIViewController () @end @implementation addressBookUIViewController - (void)viewDidLoad { [super viewDidLoad]; } #pragma mark - UI事件 //點擊添加聯系人 - (IBAction)addPersonClick:(UIButton *)sender { //創建添加聯系人視圖控制器 ABNewPersonViewController *newPersonController = [[ABNewPersonViewController alloc] init]; //設置代理 newPersonController.newPersonViewDelegate = self; //注意必須有一層導航控制器才能使用,否則不會出現取消和完成按鈕,無法進行保存等操作 [self.navigationController pushViewController:newPersonController animated:YES]; } //點擊未知聯系人 - (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); [self.navigationController pushViewController:unknownPersonController animated:YES]; } //點擊顯示聯系人 - (IBAction)showPersonClick:(UIButton *)sender { //創建顯示聯系人視圖控制器 ABPersonViewController *personController = [[ABPersonViewController alloc] init]; //設置聯系人,取得id為1的聯系人記錄 ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL); ABRecordRef recordRef = ABAddressBookGetPersonWithRecordID(addressBook, 1); personController.displayedPerson = recordRef; //設置代理 personController.personViewDelegate = self; //設置其他屬性 personController.allowsActions = YES;//是否顯示發送信息、共享聯系人等按鈕 personController.allowsEditing = YES;//允許編輯 [self.navigationController pushViewController:personController animated:YES]; } //點擊選擇聯系人 - (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.navigationController popToRootViewControllerAnimated:YES]; } #pragma mark - ABUnknownPersonViewController代理方法 //保存未知聯系人時觸發 - (void)unknownPersonViewController:(ABUnknownPersonViewController *)unknownCardViewController didResolveToPerson:(ABRecordRef)person { if (person) { NSLog(@"%@ 信息保存成功!",(__bridge NSString *)(ABRecordCopyCompositeName(person))); } //返回主視圖窗口 [self.navigationController popToRootViewControllerAnimated:YES]; } #pragma mark - ABPersonViewController代理方法 //選擇一個人員屬性後觸發,返回值YES表示觸發默認行為操作,否則執行代理中自定義的操作 - (BOOL)personViewController:(ABPersonViewController *)personViewController shouldPerformDefaultActionForPerson:(ABRecordRef)person property:(ABPropertyID)property identifier:(ABMultiValueIdentifier)identifier { if (person) { NSLog(@"選擇了屬性:%d",property); NSLog(@"值為:%@", (__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)peoplePickerNavigationControllerDidCancel:(ABPeoplePickerNavigationController *)peoplePicker{ NSLog(@"取消選擇."); } @end




  1. 上一篇文章:
  2. 下一篇文章:
Copyright © IOS教程網 All Rights Reserved