Swift：JKContactsKit 获取通讯录的联系人

JKSwiftExtension，测试用例在 JKContactsKitViewController 里面
目录：

1、简介和CNKeyDescriptor的key介绍
2、通讯录的基本使用
- 获取授权状态
- 查询出所有通讯录信息
- 添加新联系人
- 更新联系人
- 删除联系人

一、简介和CNKeyDescriptor的key介绍

1.1、在 iOS9.0 之前, 我们只能通过 AddressBook 框架来获取通讯录联系人信息。但 AddressBook framework 语法很奇怪，同时也十分难用。所以苹果从 iOS9.0 开始推出的全新的联系人框架 Contacts FrameWork 作为替代，同时将原来的 AddressBook 给废弃掉。
1.2、Contacts FrameWork 同样包含两种访问通讯录的方式：
- ContactsUI.framework 框架：通过系统提供的通讯录交互界面来访问（替代原先的 AddressBookUI.framework）
- Contacts.framework 框架：没有界面，通过代码来获取所有联系人信息（替代原先的 AddressBook.framework）
由于苹果安全策略更新，在使用 Xcode8 开发时，需要在 Info.plist 配置请求通讯录的相关描述字段（Privacy - Contacts Usage Description）

1.3、CNKeyDescriptor的key介绍

//  标识符
@available(iOS 9.0, *)
public let CNContactIdentifierKey: String
// 姓名前缀
@available(iOS 9.0, *)
public let CNContactNamePrefixKey: String
// 姓名
@available(iOS 9.0, *)
public let CNContactGivenNameKey: String
// 中间名
@available(iOS 9.0, *)
public let CNContactMiddleNameKey: String
// 姓氏
@available(iOS 9.0, *)
public let CNContactFamilyNameKey: String
// 之前的姓氏(ex:国外的女士)
@available(iOS 9.0, *)
public let CNContactPreviousFamilyNameKey: String
// 姓名后缀
@available(iOS 9.0, *)
public let CNContactNameSuffixKey: String
// 昵称
@available(iOS 9.0, *)
public let CNContactNicknameKey: String
// 公司(组织)
@available(iOS 9.0, *)
public let CNContactOrganizationNameKey: String
// 部门
@available(iOS 9.0, *)
public let CNContactDepartmentNameKey: String
// 职位
@available(iOS 9.0, *)
public let CNContactJobTitleKey: String
// 名字的拼音或音标
@available(iOS 9.0, *)
public let CNContactPhoneticGivenNameKey: String
// 中间名的拼音或音标
@available(iOS 9.0, *)
public let CNContactPhoneticMiddleNameKey: String
// 形式的拼音或音标
@available(iOS 9.0, *)
public let CNContactPhoneticFamilyNameKey: String
// 公司(组织)的拼音或音标(iOS10 才开始存在的呢)
@available(iOS 10.0, *)
public let CNContactPhoneticOrganizationNameKey: String
// 生日
@available(iOS 9.0, *)
public let CNContactBirthdayKey: String
// 农历
@available(iOS 9.0, *)
public let CNContactNonGregorianBirthdayKey: String
// 备注
@available(iOS 9.0, *)
public let CNContactNoteKey: String
// 头像
@available(iOS 9.0, *)
public let CNContactImageDataKey: String
// 头像的缩略图
@available(iOS 9.0, *)
public let CNContactThumbnailImageDataKey: String
// 头像是否可用
@available(iOS 9.0, *)
public let CNContactImageDataAvailableKey: String
// 类型
@available(iOS 9.0, *)
public let CNContactTypeKey: String
// 电话号码
@available(iOS 9.0, *)
public let CNContactPhoneNumbersKey: String
// 邮箱地址
@available(iOS 9.0, *)
public let CNContactEmailAddressesKey: String
// 住址
@available(iOS 9.0, *)
public let CNContactPostalAddressesKey: String
// 其他日期
@available(iOS 9.0, *)
public let CNContactDatesKey: String
// url地址
@available(iOS 9.0, *)
public let CNContactUrlAddressesKey: String
// 关联人
@available(iOS 9.0, *)
public let CNContactRelationsKey: String
// 社交
@available(iOS 9.0, *)
public let CNContactSocialProfilesKey: String
// 即时通信
@available(iOS 9.0, *)
public let CNContactInstantMessageAddressesKey: String

二、通讯录的基本使用

2.1、获取授权状态

// MARK: 1.1、获取授权状态
/// 获取授权状态
/// - Returns: 授权状态
static func authorizationStatus() -> CNAuthorizationStatus {
    // 获取授权状态
    return CNContactStore.authorizationStatus(for: .contacts)
}

2.2、查询出所有通讯录信息

// MARK: 1.2、获取通讯录的信息
/// 获取通讯录的信息
/// - Parameter keys: 获取Fetch,并且指定之后要获取联系人中的什么属性
///   - completion: 结果闭包
static func selectContactsData(keys: [String] = [CNContactFamilyNameKey, CNContactGivenNameKey, CNContactOrganizationNameKey, CNContactPhoneNumbersKey, CNContactNicknameKey], completion: @escaping (([CNContact], Error?) -> Void)) {
     // 创建通讯录对象
     let store = CNContactStore()
     store.requestAccess(for: .contacts) {(granted, error) in
         if (granted) && (error == nil) {
             // 创建请求对象 需要传入一个(keysToFetch: [CNKeyDescriptor]) 包含'CNKeyDescriptor'类型的数组
             let request = CNContactFetchRequest(keysToFetch: keys as [CNKeyDescriptor])
             do {
                 var contacts: [CNContact] = []
                 // 需要传入一个CNContactFetchRequest
                 try store.enumerateContacts(with: request, usingBlock: {(contact : CNContact, stop : UnsafeMutablePointer) -> Void in
                     contacts.append(contact)
                 })
                 completion(contacts, nil)
             } catch {
                 completion([], nil)
             }
         } else {
             completion([], error)
         }
     }
}

2.3、添加新联系人

// MARK: 1.3、添加新联系人
/// 添加新联系人
/// - Parameters:
///   - contact: 联系人的信息
///   - completion: 结果闭包
static func addContactItem(contact: CNMutableContact, completion: @escaping ((Bool, Error?) -> Void)) {
     // 创建通讯录对象
     let store = CNContactStore()
     store.requestAccess(for: .contacts) {(granted, error) in
         if (granted) && (error == nil) {
             // 添加联系人请求
             let saveRequest = CNSaveRequest()
             saveRequest.add(contact, toContainerWithIdentifier: nil)
             do {
                 // 写入联系人
                 try store.execute(saveRequest)
                 completion(true, nil)
             } catch {
                 completion(true, error)
            }
         } else {
             completion(false, error)
         }
     }
}

2.4、更新联系人

// MARK: 1.4、更新联系人
/// 更新联系人
/// - Parameters:
///   - identifier: 唯一标识符
///   - familyName: 姓氏
///   - givenName: 名字
///   - phoneNumbers: 手机号码数组
///   - keys: key
///   - completion: 结果闭包
static func updateContactItem(identifier: String, familyName: String, givenName: String, phoneNumbers: [CNLabeledValue<CNPhoneNumber>], keys: [String] = [CNContactFamilyNameKey, CNContactGivenNameKey, CNContactOrganizationNameKey, CNContactPhoneNumbersKey, CNContactNicknameKey], completion: @escaping ((Bool, Error?) -> Void)) {
  // 创建通讯录对象
  let store = CNContactStore()
  store.requestAccess(for: .contacts) {(granted, error) in
      if (granted) && (error == nil) {
          guard let itemContact = try? store.unifiedContact(withIdentifier: identifier, keysToFetch: keys as [CNKeyDescriptor]) else {
              return
          }
          let mutableContact = itemContact.mutableCopy() as! CNMutableContact
          mutableContact.familyName = familyName
          mutableContact.givenName = givenName
          mutableContact.phoneNumbers = phoneNumbers
          // 修改联系人请求
          let request = CNSaveRequest()
          request.update(mutableContact)
          do {
              // 修改联系人
              try store.execute(request)
              completion(true, error)
          } catch {
              completion(false, error)
          }
      } else {
          completion(false, error)
      }
  }
}

2.5、删除联系人

// MARK: 1.5、删除联系人
/// 删除联系人
/// - Parameters:
///   - identifier: 唯一标识符
///   - keys: key
///   - completion: 结果闭包
static func deleteContactItem(identifier: String, keys: [String] = [CNContactFamilyNameKey, CNContactGivenNameKey, CNContactOrganizationNameKey, CNContactPhoneNumbersKey, CNContactNicknameKey], completion: @escaping ((Bool, Error?) -> Void)) {
    // 创建通讯录对象
    let store = CNContactStore()
    store.requestAccess(for: .contacts) {(granted, error) in
        if (granted) && (error == nil) {
            guard let itemContact = try? store.unifiedContact(withIdentifier: identifier, keysToFetch: keys as [CNKeyDescriptor]) else {
                return
            }
            let mutableContact = itemContact.mutableCopy() as! CNMutableContact
            // 删除联系人请求
            let request = CNSaveRequest()
            request.delete(mutableContact)
            do {
                // 执行操作
                try store.execute(request)
                completion(true, error)
            } catch {
                completion(false, error)
            }
        } else {
            completion(false, error)
        }
    }
}