若 App 需要與使用者保持同步(例如讀取聯絡人做好友推薦),就得知道系統通訊錄何時被修改。Address Book 框架提供了外部變更回呼機制,可以即時收到通知。
/* 移除註冊 */
- (void)dealloc
{
ABAddressBookUnregisterExternalChangeCallback(_addressBook,
ContactsChangeCallback,
nil);
}
/* 註冊回呼 */
- (id)init
{
self = [super init];
if (self) {
[self addressBookHandle];
// _addressBook 為通訊錄句柄
ABAddressBookRegisterExternalChangeCallback(_addressBook,
ContactsChangeCallback,
nil);
}
return self;
}
/* 回呼函數:在此實作自己的邏輯 */
void ContactsChangeCallback(ABAddressBookRef addressBook,
CFDictionaryRef info,
void *context)
{
NSLog(@"ContactsChangeCallback");
}
這個回呼不是隨時都會收到,行為取決於 App 的執行狀態:
這個設計其實很合理:掛起中的 App 不該被喚醒來處理這種非緊急事件。但也因此,你的程式碼不能假設每次回呼都對應一次即時的變更——掛起期間可能發生過十次修改,回前台時只會收到一次通知。
正確的處理方式是:收到回呼後,重新讀取一次完整的通訊錄,比對差異,而不是嘗試從 info 推斷發生了什麼。
Unregister 會造成 callback 指向已釋放的物件而崩潰。本文使用的 Address Book 框架(ABAddressBookRef、CF 風格的 C API)自 iOS 9 起已被標記為不建議使用。新專案請改用 Contacts / ContactsUI 框架:
#import <Contacts/Contacts.h>
// 請求授權
CNContactStore *store = [[CNContactStore alloc] init];
[store requestAccessForEntityType:CNEntityTypeContacts
completionHandler:^(BOOL granted, NSError *error) {
if (granted) {
// 讀取聯絡人
}
}];
// 監聽外部變更(Contacts 框架提供兩個通知名稱)
// CNContactStoreDidChangeNotification
// 透過它取得變更的 object identifier,再用 store 重新讀取
Contacts 框架的變更通知設計更清楚:它會告訴你哪一個 CNContact 的 identifier 產生了變更,你可以只重讀那一筆,而不必掃描整個通訊錄。對聯絡人數量多的使用者來說,這個差異在效能上很顯著。
通訊錄屬於敏感個資。除了技術上的權限請求之外,還要注意:
Info.plist 中必須提供 NSContactsUsageDescription,且說明文字要具體描述用途,否則會被 App Store 拒絕。掌握「回呼不即時、需重讀比對、記得取消註冊」這三點,並改用 Contacts 框架,通訊錄同步功能就能穩定運作。