-
PPGetAddressBook对AddressBook框架(iOS9之前)和Contacts框架(iOS9之后)做了对应的封装处理;
-
支持一句代码获取按联系人姓名首字拼音A~Z排序(重点:已处理姓名所有字符的排序问题,排序更准确!);
-
支持一句代码获取原始顺序的联系人,未分组,可自行处理;
-
已对号码中的"+86","-","()",空号和联系人姓名空白做了处理,不会出现因为数据源NULL导致程序crash的问题;
-
对姓"长","沈","厦","地","冲"多音字进行优化处理.
###新建 PP-iOS学习交流群 : 323408051 有关于PP系列封装的问题和iOS技术可以在此群讨论
####如果你需要Swift版本,请戳: https://github.com/jkpang/PPGetAddressBookSwift
##Requirements 要求
- iOS 7+
- Xcode 8+
##Installation 安装
###1.手动安装:
下载DEMO后,将子文件夹PPGetAddressBook拖入到项目中, 导入头文件PPGetAddressBook.h开始使用
###2.CocoaPods安装:
first
pod 'PPGetAddressBook',:git => 'https://github.com/jkpang/PPGetAddressBook.git'
then
pod install或pod install --no-repo-update
如果发现pod search PPGetAddressBook 不是最新版本，在终端执行pod setup命令更新本地spec镜像缓存(时间可能有点长),重新搜索就OK了 ##Usage 使用方法 *注意, 在iOS 10系统下必须在info.plist文件中配置获取隐私数据权限声明 : 兼容iOS 10：配置获取隐私数据权限声明 ###一、首先必须要请求用户是否授权APP访问通讯录的权限(建议在APPDeletegate.m中的didFinishLaunchingWithOptions方法中调用)
//请求用户获取通讯录权限
[PPGetAddressBook requestAddressBookAuthorization];###二、获取通讯录 ###1.获取按联系人姓名首字拼音A~Z排序(已处理姓名所有字符的排序问题),一句话搞定!
//获取按联系人姓名首字拼音A~Z排序(已经对姓名的第二个字做了处理)
[PPGetAddressBook getOrderAddressBook:^(NSDictionary<NSString *,NSArray *> *addressBookDict, NSArray *nameKeys) {
//addressBookDict: 装着所有联系人的字典
//nameKeys: A~Z拼音字母数组;
//刷新 tableView
[self.tableView reloadData];
} authorizationFailure:^{
NSLog(@"请在iPhone的“设置-隐私-通讯录”选项中，允许PPAddressBook访问您的通讯录");
}];
###2.获取原始顺序的联系人模型,未分组,一句话搞定!
//获取没有经过排序的联系人模型
[PPGetAddressBook getOriginalAddressBook:^(NSArray<PPPersonModel *> *addressBookArray) {
//addressBookArray:原始顺序的联系人模型数组
//刷新 tableView
[self.tableView reloadData];
} authorizationFailure:^{
NSLog(@"请在iPhone的“设置-隐私-通讯录”选项中，允许PPAddressBook访问您的通讯录");
}];
##CocoaPods更新日志
- 2016.12.01(tag:0.2.8)--修复在iOS 9之前系统中编辑联系人不会及时同步的bug
- 2016.10.30(tag:0.2.7)--1.对姓"长","沈","厦","地","冲"多音字进行优化处理; 2.将'#'key值排列在A~Z的末尾!
- 2016.10.08(tag:0.2.6)--读取联系人速度再次提升!
- 2016.09.16(tag:0.2.5)--读取排序通讯录时性能提升3~6倍以及部分代码优化,推荐使用此版本及之后的版本
- 2016.09.12(tag:0.2.2)--小细节优化
- 2016.09.01(tag:0.2.1)--修复 当用户没有授权时程序卡死的Bug
- 2016.08.26(tag:0.2.0)--将联系人排序的耗时操作放在子线程,大大优化程序的载入速度与体验
- 2016.08.23(tag:0.1.2)--小细节优化
- 2016.08.21(tag:0.1.1)--Pods初始化
##联系方式:
- Weibo : @CoderPang
- Email : [email protected]
- QQ群 : 323408051
##许可证 PPGetAddressBook 使用 MIT 许可证，详情见 LICENSE 文件。