要實作聯絡人搜尋,通常分兩步:先把通訊錄讀進記憶體,再用 NSPredicate 做模糊比對。以下示範 AddressBook 框架的完整流程。
iOS 6 之後存取通訊錄必須先取得使用者授權,而授權是**非同步**的。這裡用 dispatch_semaphore 把非同步的授權回呼轉為同步等待,讓後續程式碼能順序執行:
- (void)ReadAllPeoples {
[contacts removeAllObjects];
ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(nil, nil);
dispatch_semaphore_t sema = dispatch_semaphore_create(0);
ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) {
dispatch_semaphore_signal(sema);
});
dispatch_semaphore_wait(sema, DISPATCH_TIME_FOREVER);
CFArrayRef results = ABAddressBookCopyArrayOfAllPeople(addressBook);
for (int i = 0; i < CFArrayGetCount(results); i++) {
ABRecordRef person = CFArrayGetValueAtIndex(results, i);
if (person == NULL) continue;
NSString *lastname = (__bridge NSString *)ABRecordCopyValue(person, kABPersonLastNameProperty);
if (lastname == nil) lastname = @"";
ABMultiValueRef phone = ABRecordCopyValue(person, kABPersonPhoneProperty);
for (int k = 0; k < ABMultiValueGetCount(phone); k++) {
NSString *personPhone = (__bridge NSString *)ABMultiValueCopyValueAtIndex(phone, k);
// contacts 為 NSMutableArray,每筆存成 @[姓名, 電話]
[contacts addObject:@[lastname, personPhone]];
}
if (phone) CFRelease(phone);
}
CFRelease(results);
CFRelease(addressBook);
[self.tableView reloadData];
}
對姓名與電話同時比對,只要任一欄位包含關鍵字即符合:
NSPredicate *predicate = [NSPredicate predicateWithFormat:
@"self[0] contains[cd] %@ || self[1] contains[cd] %@",
用戶輸入的string, 用戶輸入string];
filterData = [[NSArray alloc] initWithArray:[contacts filteredArrayUsingPredicate:predicate]];
filterData 就是查詢結果。[cd] 中的 c 代表 case-insensitive(不分大小寫),d 代表 diacritic-insensitive(忽略變音符號),對英文名字的搜尋很實用。
1. 記得檢查 granted。原始碼中若使用者拒絕授權,ABAddressBookCopyArrayOfAllPeople 會拿到空結果。請在 sema 回呼中判斷 granted,並在為 NO 時引導使用者前往設定開啟權限。
2. Core Foundation 的記憶體要自己管。ABRecordCopyValue、ABMultiValueCopyValueAtIndex、ABAddressBookCopyArrayOfAllPeople 都含 Copy,對應的 CFRelease 不可省略,否則大量聯絡人會造成明顯的記憶體洩漏。
3. 同步等待有風險。DISPATCH_TIME_FOREVER 會讓當前執行緒無限期阻塞。若這段程式在主執行緒執行,使用者會看到畫面凍住。請務必放在背景佇列,或改用非同步的 completion 寫法。
4. 資料結構建議改用模型物件。@[姓名, 電話] 這種以陣列位置取值的做法很脆弱,欄位一多就難以維護。改用 [[NSMutableDictionary alloc] init] 或自訂 Contact 模型,可读性與擴充性都好得多。
5. 隱私規範。存取通訊錄就必須在 Info.plist 中宣告 NSContactsUsageDescription,並在 App Store 審核時說明用途。此外,ABAddressBook 這套 C API 在 iOS 9 之後已被 CNContactStore(Contacts Framework)取代,新專案建議直接採用 Swift 友善的 Contacts 框架。