
先談談要不要換框架
翻了一下當年的系統佔有率資料,iOS 9 已經吃掉大約八成用戶。也就是說,除非你能說服老闆瀟灑地放棄剩下那兩成(實話說,這基本不可能),否則最現實的做法只有兩條路:要麼老老實實繼續用 AddressBook,要麼寫一套判斷系統版本的適配邏輯,新老框架各走一條。如果專案的最低支援版本站在 iOS 9 以上,那恭喜你,可以直接擁抱 Contacts。
CNContactStore:整套框架的主角
新框架裡出場頻率最高的類莫過於 CNContactStore。官方的定義很樸素:一個執行查詢與修改操作的類,而且是執行緒安全的。除此之外,蘋果還貼心地給了幾條使用建議:
CNContactStoreDidChangeNotification 就要記得刷新。動手之前,先問問系統答不答應:
CNAuthorizationStatus status = [CNContactStore authorizationStatusForEntityType:CNEntityTypeContacts];
回傳值一共四種,各自的含義與應對方式如下。
NotDetermined:用戶還沒表態。App 剛裝好的那一刻就是這個狀態,此時應該主動發起授權請求。
Restricted:不光讀不到資料,用戶連在「設定」裡改回來的權限都沒有,通常是家長控制之類的活躍限制所致。
Denied:用戶明確拒絕過。這個狀態只有用戶自己能改,所以只能引導他去設定頁。
Authorized:所有 App 都夢寐以求的狀態,可以放手讀取通訊錄並繼續後續業務。
策略很清楚:Authorized 直接開工;NotDetermined 走請求授權流程;剩下兩種,彈個提示請用戶自行前往設定開權限。
假設查到的狀態是 NotDetermined,那就發起請求:
CNContactStore *store = [[CNContactStore alloc] init];
[store requestAccessForEntityType:CNEntityTypeContacts completionHandler:^(BOOL granted, NSError * _Nullable error) {
// granted 為 NO 時,可以考慮引導用戶去設定頁開啟
}];
順利的話,授權就到手了。至於用戶拒絕,要不要反覆追著要,就看你產品的分寸感了。
讀資料前需要一個 CNContactFetchRequest。這裡有兩個關鍵參數值得多說兩句:
predicate 謂詞必須由 CNContact+Predicates 生成,不能自己隨便湊;keysToFetch 則由兩部分拼起來——一部分去 CNContact.h 檔案末尾找,另一部分查 CNContactFormatter.h。
CNContactFetchRequest *request = [[CNContactFetchRequest alloc] initWithKeysToFetch:@[
[CNContactFormatter descriptorForRequiredKeysForStyle:CNContactFormatterStyleFullName],
CNContactPhoneNumbersKey
]];
NSError *error = nil;
self.array = [NSMutableArray array];
[store enumerateContactsWithFetchRequest:request error:&error usingBlock:^(CNContact * _Nonnull contact, BOOL * _Nonnull stop) {
[self.array addObject:contact];
}];
執行完這段,通訊錄資料就躺在陣列裡了。要留意的是並非一次回傳全部,而是逐筆回呼,可以透過 stop 這個指標隨時中止遍歷。
順帶一提,官方文件裡有個說法:只要呼叫查詢方法,系統其實會自動觸發授權流程。所以上面那個顯式請求授權的方法究竟該放在哪個時機呼叫,確實是個值得再翻一次文件的細節。
如果本地快取了聯絡人資料,就得面對同步問題。註冊 CNContactStoreDidChangeNotification 即可,但要注意:通訊錄裡改動幾筆,通知就會觸發幾次,別讓刷新邏輯被重複呼叫拖垮。
最後補一個小細節:iOS 8 之後可以直接從 App 內跳到設定頁,一行搞定,能省用戶不少麻煩。
[[UIApplication sharedApplication] openURL:[NSURL URLWithString:UIApplicationOpenSettingsURLString]];
寫到這裡,一個能讀通訊錄的最小可用版本就成型了。實際落地時,別忘了把授權被拒、通知多次觸發這類邊界情況處理乾淨。
文/Two_Seven(簡書作者)
原文鏈接:https://www.jianshu.com/p/8de5a30cdda4