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,記得切回主執行緒。這也是範例中把實際讀取丟到背景執行緒的原因——讀取大量聯絡人確實該避免阻塞主執行緒。Copy 或 Create 的 Core Foundation 函式,回傳的都是你擁有的參考,用完要 CFRelease。使用 CFBridgingRelease 可將所有權直接交給 ARC。ABMultiValueRef 相關 API 逐一取出,不可當成單一字串處理。CNContactStore)取代 AddressBook,新專案請直接採用新框架,語意清楚且完全以 Objective-C 物件呈現。