Contacts Framework是苹果提供的一个框架，用于在iOS、iPadOS、macOS、watchOS和tvOS应用中访问和管理用户的联系人信息

Bol5261

于 2025-05-04 00:00:00 发布

阅读量887

点赞数 11

本文链接：https://blog.csdn.net/blog_programb/article/details/147624321

版权

Ios(iPhone iPad iPod Touch) 同时被 3 个专栏收录

73 篇文章

订阅专栏

Swift(iOS、macOS)

71 篇文章

订阅专栏

Java TV(Java Micro Edition)

70 篇文章

订阅专栏

Contacts Framework是苹果提供的一个框架，用于在iOS、iPadOS、macOS、watchOS和tvOS应用中访问和管理用户的联系人信息。它提供了一系列API，能让开发者以安全且合规的方式与系统联系人数据库进行交互。以下是对它的详细介绍：

主要功能

联系人信息访问：可以获取联系人的各种信息，如姓名、电话号码、电子邮件地址、地址、生日等。还能获取联系人的照片、社交网络账号信息等。
联系人创建与修改：支持在应用内创建新的联系人，以及对现有联系人的信息进行修改和删除操作。
联系人分组管理：能够处理联系人的分组信息，比如获取联系人所在的群组、创建新的联系人分组等。
权限管理：框架具备完善的权限管理机制，在应用访问联系人数据前，会请求用户授权，以保护用户的隐私。

使用场景

社交与通讯应用：在社交和通讯类应用中，使用该框架导入用户的联系人信息，方便用户快速查找和添加好友，还能同步联系人的状态信息。
办公与日程管理应用：办公和日程管理类应用可以借助它获取联系人信息，用于安排会议、发送日程提醒等。
营销与客户关系管理应用：营销和客户关系管理类应用能利用该框架获取客户的联系人信息，进行精准营销和客户关系维护。

开发步骤

1. 请求权限

在访问联系人数据之前，需要请求用户授权。示例代码（Swift）如下：

import Contacts

let store = CNContactStore()
store.requestAccess(for: .contacts) { (granted, error) in
    if granted {
        // 权限已授予，可以访问联系人数据
    } else {
        // 权限被拒绝
        if let error = error {
            print("请求权限时出错: \(error)")
        }
    }
}

2. 查询联系人

当获得权限后，就可以查询联系人信息。示例代码如下：

let keysToFetch = [CNContactGivenNameKey, CNContactFamilyNameKey, CNContactPhoneNumbersKey] as [CNKeyDescriptor]
let request = CNContactFetchRequest(keysToFetch: keysToFetch)

do {
    try store.enumerateContacts(with: request) { (contact, stop) in
        let givenName = contact.givenName
        let familyName = contact.familyName
        let phoneNumbers = contact.phoneNumbers
        
        print("姓名: \(givenName) \(familyName)")
        for phoneNumber in phoneNumbers {
            let number = phoneNumber.value.stringValue
            print("电话号码: \(number)")
        }
    }
} catch {
    print("查询联系人时出错: \(error)")
}

3. 创建和修改联系人

也可以在应用内创建和修改联系人信息。示例代码如下：

// 创建新联系人
let newContact = CNMutableContact()
newContact.givenName = "John"
newContact.familyName = "Doe"

let phoneNumber = CNLabeledValue(label: CNLabelPhoneNumberMobile, value: CNPhoneNumber(stringValue: "123-456-7890"))
newContact.phoneNumbers = [phoneNumber]

let saveRequest = CNSaveRequest()
saveRequest.add(newContact, toContainerWithIdentifier: nil)

do {
    try store.execute(saveRequest)
    print("联系人创建成功")
} catch {
    print("创建联系人时出错: \(error)")
}

注意事项

权限处理：要妥善处理权限请求和用户拒绝授权的情况，给用户清晰的提示，说明应用请求权限的目的。
数据安全：由于联系人信息属于用户的敏感数据，在处理和存储这些信息时，要采取必要的安全措施，确保数据不被泄露。
性能优化：当联系人数据量较大时，要注意查询和处理的性能问题，避免影响应用的响应速度。
Contacts Framework 简介

Contacts Framework 是苹果在 iOS 9 中引入的一个用于访问和管理设备联系人数据的框架，旨在替代旧的 AddressBook Framework。它提供了更简洁、更易用的 API，支持 Objective-C 和 Swift 语言，使得开发者可以更方便地读取、创建、更新和删除联系人信息。

核心功能

联系人对象（CNContact）
- CNContact 是一个不可变对象，用于表示一个联系人，包含姓名、电话号码、电子邮件、地址等信息。
- 提供了多种属性访问器，例如 givenName（名字）、familyName（姓氏）、phoneNumbers（电话号码）等。
联系人存储（CNContactStore）
- CNContactStore 是与设备联系人数据库交互的核心类，提供了读取、创建、更新和删除联系人的方法。
- 支持通过 CNContactFetchRequest 查询联系人，并可以设置过滤条件和排序规则。
联系人创建与更新
- 创建联系人时，使用 CNMutableContact（CNContact 的可变子类）设置联系人的各种属性。
- 更新联系人时，从数据库中获取联系人对象，将其转换为 CNMutableContact，修改属性后保存。
联系人查询
- 使用 CNContactFetchRequest 和 NSPredicate 可以根据条件查询联系人，例如按名字、电话号码等。
联系人格式化
- 提供了 CNContactFormatter 和 CNPostalAddressFormatter，用于格式化联系人姓名和地址。
权限管理
- 由于联系人数据属于用户敏感信息，应用在访问联系人数据前需要请求用户授权。

使用示例

查询联系人

import Contacts

let store = CNContactStore()
store.requestAccess(for: .contacts) { granted, error in
    guard granted else { return }
    
    let request = CNContactFetchRequest(keysToFetch: [CNContactGivenNameKey, CNContactFamilyNameKey])
    do {
        var contacts = [CNContact]()
        try store.enumerateContacts(with: request) { contact, stop in
            contacts.append(contact)
        }
        print(contacts)
    } catch {
        print("Error fetching contacts: \(error)")
    }
}

创建联系人

import Contacts

let contact = CNMutableContact()
contact.givenName = "John"
contact.familyName = "Doe"
contact.phoneNumbers = [CNLabeledValue(label: CNLabelPhoneNumberMobile, value: CNPhoneNumber(stringValue: "1234567890"))]

let store = CNContactStore()
let saveRequest = CNSaveRequest()
saveRequest.add(contact, toContainerWithIdentifier: nil)

do {
    try store.execute(saveRequest)
    print("Contact saved successfully")
} catch {
    print("Error saving contact: \(error)")
}