针对iOS 9或更高版本的iOS的Contacts包装器

要求

iOS 9.0+

针对iOS 10

add "Privacy - Contacts Usage Description" to your application .plist file

可用方法

如果有，通过CNContactFamilyNameKey、CNContactGivenNameKey、CNContactPhoneNumbersKey、CNContactImageDataKey描述符获取所有联系人

- (void)getContactsWithContainerId:(nullable NSString *)containerId completionBlock:(void (^)(NSArray<CNContact *> * _Nullable contacts, NSError  * _Nullable error))completionBlock;

使用给定键描述符获取所有联系人

- (void)getContactsWithKeys:(NSArray<id<CNKeyDescriptor>> *)keys 
                containerId:(nullable NSString *)containerId
            completionBlock:(void (^)(NSArray<CNContact *> * _Nullable contacts, NSError  * _Nullable error))completionBlock

保存给定联系人

- (void)saveContact:(CNMutableContact *)contact
        containerId:(nullable NSString *)containerId
    completionBlock:(void (^)(bool isSuccess, NSError * _Nullable error))completionBlock

获取给定名称的联系人

- (void)getContactsWithGivenName:(NSString *)givenName
                 completionBlock:(void (^)(NSArray<CNContact *> * _Nullable contacts, NSError * _Nullable error))completionBlock

获取给定名称和姓氏的联系人

- (void)getContactsWithGivenName:(NSString *)givenName 
                      familyName:(NSString *)familyName 
                 completionBlock:(void (^)(NSArray<CNContact *> * _Nullable contacts, NSError * _Nullable error))completionBlock

更新给定联系人的信息

- (void)updateContact:(CNMutableContact *)contact
      completionBlock:(void (^)(bool isSuccess, NSError * _Nullable error))completionBlock

通过给定电子邮件地址获取联系人

- (void)getContactsWithEmailAddress:(NSString *)emailAddress
                    completionBlock:(void (^)(NSArray<CNContact *> * _Nullable contacts, NSError * _Nullable error))completionBlock

删除给定联系人

- (void)deleteContact:(CNMutableContact *)contact
      completionBlock:(void (^)(bool isSuccess, NSError * _Nullable error))completionBlock

将给定组添加到联系人列表中

- (void)addGroup:(CNMutableGroup *)group
     containerId:(nullable NSString *)containerId
 completionBlock:(void (^)(bool isSuccess, NSError * _Nullable error))completionBlock

将给定成员添加到指定组中

- (void)addGroupMember:(CNContact *)contact
                 group:(CNGroup *)group
       completionBlock:(void (^)(bool isSuccess, NSError * _Nullable error))completionBlock

将给定联系人添加到指定组中

- (void)addGroupMembers:(NSArray<CNMutableContact *> *)contacts
                  group:(CNGroup *)group
        completionBlock:(void (^)(BOOL isSuccess, NSError * _Nullable error))completionBlock

获取组信息

- (void)getGroupsWithContainerId:(nullable NSString *)containerId completionBlock:(void (^)(NSArray<CNGroup *> * _Nullable groups, NSError * _Nullable error))completionBlock

删除组

- (void)deleteGroup:(CNMutableGroup *)group
    completionBlock:(void (^)(bool isSuccess, NSError * _Nullable error))completionBlock;

更新组

- (void)updateGroup:(CNMutableGroup *)group
    completionBlock:(void (^)(bool isSuccess, NSError * _Nullable error))completionBlock;

获取容器

- (void)getContainers:(void (^)(NSArray<CNContainer *> * _Nullable containers, NSError * _Nullable error))completionBlock

许可协议

麻省理工学院许可证 (MIT)

版权所有 (c) 2016 Abdullah Selek

以下是对任何人获得本软件及其相关文档文件（“软件”）副本的免费许可，使用软件不受限制，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利，并允许获得软件的人这么做，但需遵守以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

软件按“原样”提供，不提供任何形式的质量保证，无论明示还是默示，包括但不限于适销性、特定用途的适用性和非侵权性的保证。在任何情况下，作者或版权持有人不应对任何索赔、损害或其他责任承担任何责任，无论这些责任是基于合同、侵权或其他法律。