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

AddressBook.framework 實戰:ABAddressBookRef、ABRecordRef 與多值屬性操作

編輯:iOS 開發綜合

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 物件必須判斷非空才釋放,否則會報錯
    }
}

讀取多值屬性(email)

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 框架。

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