jiexishede/ljcontactmanager

LJContanctManager 是一款操作通讯录的类库

LJContactManager

介绍

LJContanctManager 是一款操作通讯录的类库，iOS 9 之前使用的是 AddressBook 和 AddressBookUI 系统库，iOS 9 之后使用苹果新推出的 Contacts 和 ContactsUI 框架，一行代码搞定通讯录。

安装

CocoaPods

1. 在 Podfile 中添加 pod 'LJContactManager'。
2. 执行 pod install 或 pod update。
3. 导入 <LJContactManager.h>。

手动安装

1. 下载 LJContactManager 文件夹内的所有内容。
2. 将 LJContactManager 内的源文件添加(拖放)到你的工程。
3. 导入 LJContactManager.h。

使用

主要提供以下的方法：

• 选择联系人

/**
 选择联系人

 @param controller 控制器
 @param completcion 回调
 */
- (void)selectContactAtController:(UIViewController *)controller
                      complection:(void (^)(NSString *name, NSString *phone))completcion;

• 创建新联系人

/**
 创建新联系人

 @param phoneNum 手机号
 @param controller 当前 Controller
 */
- (void)createNewContactWithPhoneNum:(NSString *)phoneNum controller:(UIViewController *)controller;

• 添加到现有联系人

/**
 添加到现有联系人

 @param phoneNum 手机号
 @param controller 当前 Controller
 */
- (void)addToExistingContactsWithPhoneNum:(NSString *)phoneNum controller:(UIViewController *)controller;

• 获取联系人列表（未分组的通讯录）

/**
 获取联系人列表（未分组的通讯录）
 
 @param completcion 回调
 */
- (void)accessContactsComplection:(void (^)(BOOL succeed, NSArray <LJPerson *> *contacts))completcion;

• 获取联系人列表（已分组的通讯录）

/**
 获取联系人列表（已分组的通讯录）

 @param completcion 回调
 */
- (void)accessSectionContactsComplection:(void (^)(BOOL succeed, NSArray <LJSectionPerson *> *contacts, NSArray <NSString *> *keys))completcion;

• 通讯录变更回调（未分组的通讯录）

/**
 通讯录变更回调（未分组的通讯录）
 
 @param succeed 是否成功
 @param newContacts  联系人列表（未分组）
 */
typedef void (^LJContactChangeHanlder) (BOOL succeed, NSArray <LJPerson *> *newContacts);

• 通讯录变更回调（已分组的通讯录）

/**
 通讯录变更回调（已分组的通讯录）
 
 @param succeed 是否成功
 @param newSectionContacts 联系人列表（已分组）
 @param keys 所有联系人的分区标题
 */
typedef void (^LJSectionContactChangeHanlder) (BOOL succeed, NSArray <LJSectionPerson *> *newSectionContacts, NSArray <NSString *> *keys);

系统要求

该项目最低支持 iOS 8.0 和 Xcode 7.0。

相关文章

iOS 通讯录开发的所有姿势