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

iOS 7 讀不到通訊錄?ABAddressBookRef 的版本適配與權限處理

編輯:iOS 開發綜合

iOS 6 導入聯絡人隱私權限機制之後,讀取通訊錄的程式碼必須改寫;到了 iOS 7,API 又有了變化。若沒有依系統版本分別建構 ABAddressBookRef,就會出現「iOS 7 上讀不到任何聯絡人」的狀況。

根本原因是:ABAddressBookCreate() 在 iOS 6 之後已被取代,必須改用 ABAddressBookCreateWithOptions(),並且要先向使用者請求授權。以下兩個方法已在各版本實測可用。

取得通訊錄並請求授權

// 取得通訊錄
- (void)GetUserAddressBook {
    ABAddressBookRef ab = NULL;

    // ABAddressBookCreateWithOptions 為 iOS 6 以後的 API
    if (&ABAddressBookCreateWithOptions) {
        CFErrorRef error = nil;
        ab = ABAddressBookCreateWithOptions(NULL, &error);
        if (error) {
            NSLog(@"%@", error);
        }
    }

    // 舊系統的退路
    if (ab == NULL) {
        ab = ABAddressBookCreate();
    }

    if (ab) {
        // ABAddressBookRequestAccessWithCompletion 同樣是 iOS 6 以後才有
        if (&ABAddressBookRequestAccessWithCompletion) {
            ABAddressBookRequestAccessWithCompletion(ab, ^(bool granted, CFErrorRef error) {
                if (granted) {
                    // constructInThread: 會負責 CFRelease(ab)
                    [NSThread detachNewThreadSelector:@selector(constructInThread:)
                                            toTarget:self
                                          withObject:CFBridgingRelease(ab)];
                } else {
                    // 使用者拒絕授權,此處可加上提示
                }
            });
        } else {
            [NSThread detachNewThreadSelector:@selector(constructInThread:)
                                    toTarget:self
                                  withObject:CFBridgingRelease(ab)];
        }
    }
}

這裡有兩個關鍵技巧值得注意。第一,用 &ABAddressBookCreateWithOptions 這種「取函式位址」的方式來判斷 API 是否存在,是判斷符號可用性的標準做法,比比較 systemVersion 更可靠。第二,CFBridgingRelease 會在丟入 Objective-C 世界時轉移所有權,後續就不該再自行 CFRelease,這樣能避免 double free。

實際讀取聯絡人資料

- (void)constructInThread:(ABAddressBookRef)ab {
    NSLog(@"已取得存取權限");

    CFArrayRef results = ABAddressBookCopyArrayOfAllPeople(ab);
    NSMutableArray *contactArray = [[NSMutableArray alloc] init];

    for (int i = 0; i < CFArrayGetCount(results); i++) {
        ABRecordRef person = CFArrayGetValueAtIndex(results, i);

        NSString *firstName = (NSString *)CFBridgingRelease(
            ABRecordCopyValue(person, kABPersonFirstNameProperty));
        NSString *lastName = (NSString *)CFBridgingRelease(
            ABRecordCopyValue(person, kABPersonLastNameProperty));
        NSString *organization = (NSString *)CFBridgingRelease(
            ABRecordCopyValue(person, kABPersonOrganizationProperty));
        NSString *department = (NSString *)CFBridgingRelease(
            ABRecordCopyValue(person, kABPersonDepartmentProperty));

        NSDate *birthday = (NSDate *)CFBridgingRelease(
            ABRecordCopyValue(person, kABPersonBirthdayProperty));
        double birthdayString = [birthday timeIntervalSince1970];

        NSString *nickname = (NSString *)CFBridgingRelease(
            ABRecordCopyValue(person, kABPersonNicknameProperty));

        // 電話屬於多值屬性,必須逐項走訪
        NSString *phoneString = @"";
        ABMultiValueRef phones = ABRecordCopyValue(person, kABPersonPhoneProperty);
        for (int k = 0; k < ABMultiValueGetCount(phones); k++) {
            NSString *phone = (NSString *)CFBridgingRelease(
                ABMultiValueCopyValueAtIndex(phones, k));
            phoneString = [phoneString stringByAppendingFormat:@"%@ ", phone];
        }
        if (phones) CFRelease(phones);

        // TODO: 組裝成模型物件後加入 contactArray
    }

    if (results) CFRelease(results);
}

實作上的重點整理

  • 授權是非同步的。ABAddressBookRequestAccessWithCompletion 的回呼不保證在主執行緒,因此若要在回呼中更新 UI,記得切回主執行緒。這也是範例中把實際讀取丟到背景執行緒的原因——讀取大量聯絡人確實該避免阻塞主執行緒。
  • CF 記憶體必須自己管。凡是名稱帶 Copy 或 Create 的 Core Foundation 函式,回傳的都是你擁有的參考,用完要 CFRelease。使用 CFBridgingRelease 可將所有權直接交給 ARC。
  • 電話、電子郵件、地址都是多值屬性,要用 ABMultiValueRef 相關 API 逐一取出,不可當成單一字串處理。
  • 使用者拒絕授權時要有出路。可以提供引導前往「設定」開啟權限的說明,而不是靜默失敗。
  • iOS 9 之後,Apple 已推出 Contacts.framework(CNContactStore)取代 AddressBook,新專案請直接採用新框架,語意清楚且完全以 Objective-C 物件呈現。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved