当前位置：首页 > news >正文

APAddressBook 0.1.x到0.2.x迁移指南：轻松升级你的通讯录功能

news 2026/7/14 8:58:47

APAddressBook 0.1.x到0.2.x迁移指南：轻松升级你的通讯录功能

【免费下载链接】APAddressBookEasy access to iOS address book项目地址: https://gitcode.com/gh_mirrors/ap/APAddressBook

APAddressBook是一款让iOS开发者轻松访问系统通讯录的实用框架。本指南将帮助你顺利从0.1.x版本迁移到0.2.x版本，解锁更强大的通讯录功能。

为什么选择升级到0.2.x版本？

升级到APAddressBook 0.2.x版本，你将获得以下核心改进：

更简洁的API设计，减少冗余代码
增强的错误处理机制，提升应用稳定性
优化的性能表现，更快的通讯录数据加载速度
完善的Swift支持，包括更全面的桥接文件

准备工作

在开始迁移前，请确保：

你的项目使用iOS 9.0或更高版本
已安装最新版本的CocoaPods
备份你的项目代码，以防意外情况

安装与更新

使用CocoaPods更新

打开你的Podfile，找到APAddressBook相关行：

pod 'APAddressBook', '~> 0.1.0'

将其更新为：

pod 'APAddressBook', '~> 0.2.0'

然后在终端中执行：

pod update APAddressBook

手动更新

如果你是手动集成APAddressBook，请从项目中移除旧版本文件，然后添加新版本的核心文件：

Pod/Core/Public/APAddressBook.h
Pod/Core/Public/APAddressBook.m
Pod/Core/Public/Models/目录下的所有模型文件

主要API变更

初始化方法变更

0.1.x版本：

APAddressBook *addressBook = [[APAddressBook alloc] init];

0.2.x版本：

APAddressBook *addressBook = [[APAddressBook alloc] initWithOptions:@{APAddressBookOptionPreferedContactStore: CNContactStore.defaultStore}];

新的初始化方法允许你传入选项字典，提供了更大的灵活性。

权限请求方法改进

0.1.x版本：

[addressBook requestAccessWithCompletion:^(BOOL granted, NSError *error) { // 处理权限结果 }];

0.2.x版本：

[addressBook requestAuthorization:^(APAddressBookAuthorizationStatus status, NSError *error) { if (status == APAddressBookAuthorizationStatusAuthorized) { // 权限已授予 } else { // 处理权限被拒绝情况 } }];

新的授权方法返回更详细的授权状态，便于精确处理各种权限场景。

联系人获取方式优化

0.1.x版本：

[addressBook fetchContactsWithCompletion:^(NSArray *contacts, NSError *error) { // 处理联系人数据 }];

0.2.x版本：

APContactFetchRequest *request = [[APContactFetchRequest alloc] init]; request.keysToFetch = @[APContactKeyName, APContactKeyPhoneNumbers]; [addressBook fetchContactsWithRequest:request completion:^(NSArray<APContact *> *contacts, NSError *error) { // 处理联系人数据 }];

新的获取方法引入了APContactFetchRequest类，允许你指定需要获取的联系人字段，减少不必要的数据传输，提高性能。

模型类变更

APContact模型类在0.2.x版本中进行了重构，主要变更包括：

属性名称标准化

0.1.x版本：

NSString *firstName = contact.first; NSString *lastName = contact.last;

0.2.x版本：

NSString *firstName = contact.name.givenName; NSString *lastName = contact.name.familyName;

姓名相关属性现在统一封装在APName对象中，通过contact.name属性访问。

电话号码处理改进

0.1.x版本：

NSString *phone = contact.phones.firstObject;

0.2.x版本：

APPhone *phone = contact.phones.firstObject; NSString *phoneNumber = phone.number; NSString *phoneLabel = phone.label;

电话号码现在通过APPhone对象表示，包含号码和标签信息，提供更丰富的数据。

错误处理增强

0.2.x版本引入了更详细的错误码和错误信息，帮助你更好地调试和处理异常情况：

[addressBook fetchContactsWithRequest:request completion:^(NSArray<APContact *> *contacts, NSError *error) { if (error) { NSLog(@"获取联系人失败: %@", error.localizedDescription); switch (error.code) { case APAddressBookErrorNotAuthorized: // 处理未授权错误 break; case APAddressBookErrorDataUnavailable: // 处理数据不可用错误 break; // 其他错误类型... } } }];

Swift支持改进

0.2.x版本增强了Swift支持，提供了更完善的桥接文件Pod/Swift/APAddressBook-Bridging.h，使Swift项目集成更加顺畅：

import APAddressBook let addressBook = APAddressBook(options: [APAddressBookOptionPreferedContactStore: CNContactStore.default()]) addressBook.requestAuthorization { status, error in if status == .authorized { let request = APContactFetchRequest() request.keysToFetch = [.name, .phoneNumbers] addressBook.fetchContacts(with: request) { contacts, error in // 处理联系人数据 } } }