iOS通讯录开发教程：OC语言实现基本管理功能

在iOS开发中，通讯录（Address Book）是内置的应用之一，它允许用户存储和管理联系人信息。对于iOS开发者而言，能够使用Objective-C（OC）语言访问并操作通讯录数据是基础技能之一。本知识点将详细介绍如何使用Objective-C语言操作iOS通讯录，实现添加、删除、查找和搜索联系人等基本功能。 首先，我们需要了解iOS平台中关于访问通讯录的API。在iOS 9.0之前的版本中，主要使用AddressBook.framework框架来访问通讯录。在iOS 9.0及以后的版本中，苹果推荐使用Contacts.framework框架来替代AddressBook框架。 ### 使用AddressBook框架（已废弃） #### 导入框架 要在项目中使用AddressBook框架，首先需要导入框架头文件： ```objective-c #import <AddressBook/AddressBook.h> ``` #### 请求访问权限 由于通讯录属于用户隐私数据，应用必须请求用户授权才能访问。使用`ABAddressBookRequestAccessWithCompletion`函数请求权限： ```objective-c ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL); ABAddressBookRequestAccessWithCompletion(addressBook, ^(bool granted, CFErrorRef error) { if (granted) { // 授权成功，进行操作 } else { // 授权失败，处理错误 } }); ``` #### 添加联系人 ```objective-c ABRecordRef person = ABPersonCreate(); ABRecordSetValue(person, kABPersonFirstNameProperty, (__bridge CFStringRef)@"John", NULL); ABRecordSetValue(person, kABPersonLastNameProperty, (__bridge CFStringRef)@"Doe", NULL); // 添加电话号码等其他信息... ABAddressBookAddRecord(addressBook, person, NULL); CFRelease(person); // 使用完后释放person对象 ``` #### 删除联系人 ```objective-c ABAddressBookRemoveRecord(addressBook, personRecord, NULL); ``` #### 查找联系人 ```objective-c CFArrayRef allPeople = ABAddressBookCopyArrayOfAllPeople(addressBook); for (CFIndex i = 0; i < CFArrayGetCount(allPeople); i++) { ABRecordRef person = CFArrayGetValueAtIndex(allPeople, i); CFStringRef firstName = ABRecordCopyValue(person, kABPersonFirstNameProperty); // 比较firstName... CFRelease(firstName); // 使用完毕后释放 } CFRelease(allPeople); ``` #### 搜索联系人 搜索联系人时，可以使用`ABAddressBookCopyArrayOfAllPeopleInSource`和`ABRecordCopyCompositeName`： ```objective-c ABAddressBookRef addressBook = ABAddressBookCreateWithOptions(NULL, NULL); CFArrayRef sources = ABAddressBookCopyArrayOfAllSources(addressBook); for (CFIndex i = 0; i < CFArrayGetCount(sources); i++) { ABRecordRef source = CFArrayGetValueAtIndex(sources, i); CFArrayRef people = ABAddressBookCopyArrayOfAllPeopleInSource(addressBook, source); for (CFIndex j = 0; j < CFArrayGetCount(people); j++) { ABRecordRef person = CFArrayGetValueAtIndex(people, j); CFStringRef compositeName = ABRecordCopyCompositeName(person); // 搜索条件判断... CFRelease(compositeName); } CFRelease(people); } CFRelease(sources); CFRelease(addressBook); ``` ### 使用Contacts框架（推荐） #### 导入框架 在新的iOS版本中，推荐使用Contacts.framework框架： ```objective-c #import <Contacts/Contacts.h> ``` #### 请求访问权限 使用`CNContactStore`请求访问权限： ```objective-c CNContactStore *store = [[CNContactStore alloc] init]; [store requestAccessForEntityType:CNEntityTypeContacts completion:^(BOOL granted, NSError * _Nullable error) { if (granted) { // 授权成功，进行操作 } else { // 授权失败，处理错误 } }]; ``` #### 添加联系人 ```objective-c CNContact *newContact = [CNContact new]; newContact.firstName = @"John"; newContact.lastName = @"Doe"; // 添加电话号码等其他信息... NSError *error = nil; [store saveContact:newContact completionHandler:^(CNContact *savedContact, NSError *error) { if (!error) { // 添加成功 } }]; ``` #### 删除联系人 ```objective-c NSError *error = nil; [store deleteContact:contact completionHandler:^(NSError *error) { if (!error) { // 删除成功 } }]; ``` #### 查找联系人 ```objective-c NSArray *keysToFetch = @[CNContactIdentifierKey, CNContactFirstNameKey, CNContactLastNameKey]; NSPredicate *predicate = [CNContact predicateForContactsMatchingName:@"John"]; CNContactStore *store = [[CNContactStore alloc] init]; NSError *error = nil; NSArray *contacts = [store unifiedContactsMatchingPredicate:predicate keysToFetch:keysToFetch error:&error]; if (!error) { // 处理找到的联系人信息 } ``` #### 搜索联系人 使用`CNContactStore`的`unifiedContactsMatchingPredicate`方法进行搜索： ```objective-c // 搜索条件同查找联系人部分... ``` ### 附录：文件名称列表说明 - **AddressPerson** 这个文件可能是与创建或管理联系人相关的代码文件。在这个文件中，开发者可能会编写相关的OC类或方法来封装通讯录的操作逻辑，如添加、删除、查找和搜索联系人的功能。 总结以上操作，开发者在进行iOS通讯录开发时，应首先确保获取了通讯录访问权限。然后根据iOS版本的不同，选择合适的框架（AddressBook或Contacts），并使用框架内提供的API进行通讯录数据的读写操作。此外，代码示例中也展示了如何构建条件来查询和管理通讯录中的联系人信息。实际开发中，应按照具体需求完善权限请求、用户交互和异常处理等部分的代码。