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

從 AddressBook 告別時刻:iOS Contacts 框架通訊錄開發實戰

編輯:iOS 開發基礎

先談談要不要換框架

翻了一下當年的系統佔有率資料,iOS 9 已經吃掉大約八成用戶。也就是說,除非你能說服老闆瀟灑地放棄剩下那兩成(實話說,這基本不可能),否則最現實的做法只有兩條路:要麼老老實實繼續用 AddressBook,要麼寫一套判斷系統版本的適配邏輯,新老框架各走一條。如果專案的最低支援版本站在 iOS 9 以上,那恭喜你,可以直接擁抱 Contacts。

CNContactStore:整套框架的主角

新框架裡出場頻率最高的類莫過於 CNContactStore。官方的定義很樸素:一個執行查詢與修改操作的類,而且是執行緒安全的。除此之外,蘋果還貼心地給了幾條使用建議:

  • 只查你真正用得到的屬性,別貪多。
  • 需要快取全部聯絡人時,先把所有 identifier 撈出來,再按需回查細節。
  • 一次要拿多筆資料,同樣是「先收集 identifier,再批量取詳情」的思路。
  • 一旦做了快取,收到 CNContactStoreDidChangeNotification 就要記得刷新。
  • 查詢方法內部有 I/O,別在主執行緒上跑。

第一步:先看授權狀態

動手之前,先問問系統答不答應:

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


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