iOS 的聯絡人存取有兩套框架:AddressBook.framework 是以 C API 直接操作通訊錄資料庫的底層框架;AddressBookUI.framework 則是提供 Objective-C 介面互動的上層框架。本文示範只用 C 框架(不含 UI),匯入 AddressBook.framework 就能讀寫通訊錄。
以下示範建立一位聯絡人、為他設定名字與多組 email,存入通訊錄後再讀取出來:
ABAddressBookRef adbk = ABAddressBookCreate(); // 取得本機通訊錄
ABRecordRef moi = NULL; // 目標聯絡人
ABRecordRef annkey = ABPersonCreate(); // 建立聯絡人
// 設定名字
ABRecordSetValue(annkey, kABPersonFirstNameProperty, @"annkey", NULL);
ABRecordSetValue(annkey, kABPersonLastNameProperty, @"hu", NULL);
// 建立多值屬性(email)
ABMutableMultiValueRef addr = ABMultiValueCreateMutable(kABStringPropertyType);
ABMultiValueAddValueAndLabel(addr, @"annkey@qq.con", kABHomeLabel, NULL);
ABRecordSetValue(annkey, kABPersonEmailProperty, addr, NULL);
// 加入並儲存
ABAddressBookAddRecord(adbk, annkey, NULL);
ABAddressBookSave(adbk, NULL);
CFRelease(addr);
CFRelease(annkey); // 即使在 ARC 下,CF 物件仍需手動釋放
用名字搜尋,可能會有多個同名聯絡人,需要再透過其他屬性判斷:
CFArrayRef sams = ABAddressBookCopyPeopleWithName(adbk, (CFStringRef)@"hu");
for (CFIndex ix = 0; ix < CFArrayGetCount(sams); ix++) {
ABRecordRef sam = CFArrayGetValueAtIndex(sams, ix);
CFStringRef last = ABRecordCopyValue(sam, kABPersonLastNameProperty);
NSLog(@"找到 %@", last);
if (last && CFStringCompare(last, (CFStringRef)@"annkey", 0) == 0) {
moi = sam;
}
if (last) {
CFRelease(last); // CF 物件必須判斷非空才釋放,否則會報錯
}
}
ABMultiValueRef emails = ABRecordCopyValue(moi, kABPersonEmailProperty);
for (CFIndex ix = 0; ix < ABMultiValueGetCount(emails); ix++) {
CFStringRef label = ABMultiValueCopyLabelAtIndex(emails, ix);
CFStringRef value = ABMultiValueCopyValueAtIndex(emails, ix);
NSLog(@"我有一個 %@ 位址:%@", label, value);
CFRelease(label);
CFRelease(value);
}
CFRelease(emails);
CFRelease(sams);
CFRelease(adbk);
使用這套 C API 時要特別注意記憶體管理:凡是 Copy、Create 產生的 CF 物件,都要對應一次 CFRelease;釋放前務必判斷是否為 NULL,否則會出錯。此外,自 iOS 6 起存取通訊錄屬於敏感個資,必須先取得使用者授權(ABAddressBookCreateWithOptions 搭配 ABAddressBookRequestAccessWithCompletion)才能讀取;而從 iOS 9 開始,這套舊 AddressBook 已被 Contacts.framework(CNContact)取代,新專案建議直接採用 Contacts 框架。