Swift - 访问通讯录联系人（使用纯代码实现）

2015-07-14 发布：hangge 阅读：5799

注意：自 iOS9 起，AddressBook 框架已废弃使用。建议采用 Contacts 框架作为替代。相关文章如下：

1，通讯录访问介绍

通讯录（或叫地址簿，电话簿）是一个数据库，里面储存了联系人的相关信息。要实现访问通讯录有如下两种方式：

（1）AddressBook.framework框架：没有界面，通过代码来获取所有联系人信息（本文样例使用此方式）

（2）AddressBookUI.framework框架：通过系统提供的通讯录交互界面来访问

2，联系人记录的属性

在一条联系人记录中，有很多属性，而这些属性又分为单值属性和多值属性。

（1）单值属性是只有一个值的属性：

kABPersonLastNameProperty ：姓

kABPersonFirstNameProperty ：名

kABPersonMiddleNameProperty ：中间名

kABPersonPrefixProperty ：前缀

kABPersonSuffixProperty ：后缀

kABPersonLastNamePhoneticProperty ：姓氏汉语拼音或音标

kABPersonFirstNamePhoneticProperty ：名字汉语拼音或音标

kABPersonNicknameProperty ：昵称

kABPersonOrganizationProperty ：公司（组织）

kABPersonJobTitleProperty ：职位

kABPersonDepartmentProperty ：部门

kABPersonNoteProperty ：备注

（2）多值属性是包含多个值的集合类型：

kABPersonPhoneProperty ：电话

kABPersonEmailProperty ：Email

kABPersonAddressProperty ：地址

kABPersonURLProperty : URL属性

kABPersonDateProperty ：纪念日

kABPersonInstantMessageProperty ：获取即时通讯(IM)

kABPersonSocialProfileProperty ：社交账号

kABPersonRelatedNamesProperty ：亲属关系人

3，多值属性标签的本地名称

在多值属性中包含了label（标签）、value（值）和ID等部分，其中标签和值都是可以重复的，而ID是不能重复的。

对于标签，我们可以使用ABAddressBookCopyLocalizedLabel()方法转为本地标签名（即能看得懂的标签名，比如work、home）。要不然打印出来的是_$!<Home>!$_，_$!<Work>!$_这样的数据。

4，下面样例使用代码遍历所有的联系人，并打印输出相关属性

import UIKit
import AddressBook
import AddressBookUI

class ViewController: UIViewController {
    
    //address Book对象，用来获取电话簿句柄
    var addressBook:ABAddressBookRef?

    override func viewDidLoad() {
        super.viewDidLoad()
        
        //定义一个错误标记对象，判断是否成功
        var error:Unmanaged<CFErrorRef>?
        addressBook = ABAddressBookCreateWithOptions(nil, &error).takeRetainedValue()
        
        //发出授权信息
        let sysAddressBookStatus = ABAddressBookGetAuthorizationStatus()
        if (sysAddressBookStatus == ABAuthorizationStatus.NotDetermined) {
            println("requesting access...")
            var errorRef:Unmanaged<CFError>? = nil
            //addressBook = extractABAddressBookRef(ABAddressBookCreateWithOptions(nil, &errorRef))
            ABAddressBookRequestAccessWithCompletion(addressBook, { success, error in
                if success {
                    //获取并遍历所有联系人记录
                    self.readRecords();
                }
                else {
                    println("error")
                }
            })
        }
        else if (sysAddressBookStatus == ABAuthorizationStatus.Denied ||
            sysAddressBookStatus == ABAuthorizationStatus.Restricted) {
            println("access denied")
        }
        else if (sysAddressBookStatus == ABAuthorizationStatus.Authorized) {
            println("access granted")
            //获取并遍历所有联系人记录
            self.readRecords();
        }
    }
    
    //获取并遍历所有联系人记录
    func readRecords(){
        var sysContacts:NSArray = ABAddressBookCopyArrayOfAllPeople(addressBook)
            .takeRetainedValue() as NSArray
        
        for contact in sysContacts {
            //获取姓
            var lastName = ABRecordCopyValue(contact, kABPersonLastNameProperty)?
                .takeRetainedValue() as! String? ?? ""
            println("姓：\(lastName)")
            
            //获取名
            var firstName = ABRecordCopyValue(contact, kABPersonFirstNameProperty)?
                .takeRetainedValue() as! String? ?? ""
            println("名：\(firstName)")
            
            //昵称
            var nikeName = ABRecordCopyValue(contact, kABPersonNicknameProperty)?
                .takeRetainedValue() as! String? ?? ""
            println("昵称：\(nikeName)")
            
            //公司（组织）
            var organization = ABRecordCopyValue(contact, kABPersonOrganizationProperty)?
                .takeRetainedValue() as! String? ?? ""
            println("公司（组织）：\(organization)")
            
            //职位
            var jobTitle = ABRecordCopyValue(contact, kABPersonJobTitleProperty)?
                .takeRetainedValue() as! String? ?? ""
            println("职位：\(jobTitle)")
            
            //部门
            var department = ABRecordCopyValue(contact, kABPersonDepartmentProperty)?
                .takeRetainedValue() as! String? ?? ""
            println("部门：\(department)")
            
            //备注
            var note = ABRecordCopyValue(contact, kABPersonNoteProperty)?
                .takeRetainedValue() as! String? ?? ""
            println("备注：\(note)")
            
            //获取电话
            var phoneValues:ABMutableMultiValueRef? =
            ABRecordCopyValue(contact, kABPersonPhoneProperty).takeRetainedValue()
            if phoneValues != nil {
                println("电话：")
                for i in 0 ..< ABMultiValueGetCount(phoneValues){
                    
                    // 获得标签名
                    var phoneLabel = ABMultiValueCopyLabelAtIndex(phoneValues, i).takeRetainedValue()
                        as CFStringRef;
                    // 转为本地标签名（能看得懂的标签名，比如work、home）
                    var localizedPhoneLabel = ABAddressBookCopyLocalizedLabel(phoneLabel)
                        .takeRetainedValue() as! String
                    
                    var value = ABMultiValueCopyValueAtIndex(phoneValues, i)
                    var phone = value.takeRetainedValue() as! String
                    println("  \(localizedPhoneLabel):\(phone)")
                }
            }
            
            //获取Email
            var emailValues:ABMutableMultiValueRef? =
            ABRecordCopyValue(contact, kABPersonEmailProperty).takeRetainedValue()
            if emailValues != nil {
                println("Email：")
                for i in 0 ..< ABMultiValueGetCount(emailValues){
                    
                    // 获得标签名
                    var label = ABMultiValueCopyLabelAtIndex(emailValues, i).takeRetainedValue()
                        as CFStringRef;
                    var localizedLabel = ABAddressBookCopyLocalizedLabel(label)
                        .takeRetainedValue() as! String
                    
                    var value = ABMultiValueCopyValueAtIndex(emailValues, i)
                    var email = value.takeRetainedValue() as! String
                    println("  \(localizedLabel):\(email)")
                }
            }
            
            //获取地址
            var addressValues:ABMutableMultiValueRef? =
            ABRecordCopyValue(contact, kABPersonAddressProperty).takeRetainedValue()
            if addressValues != nil {
                println("地址：")
                for i in 0 ..< ABMultiValueGetCount(addressValues){
                    
                    // 获得标签名
                    var label = ABMultiValueCopyLabelAtIndex(addressValues, i).takeRetainedValue()
                        as CFStringRef;
                    var localizedLabel = ABAddressBookCopyLocalizedLabel(label)
                        .takeRetainedValue() as! String
                    
                    var value = ABMultiValueCopyValueAtIndex(addressValues, i)
                    var addrNSDict:NSMutableDictionary = value.takeRetainedValue()
                        as! NSMutableDictionary
                    var country:String = addrNSDict.valueForKey(kABPersonAddressCountryKey as String)
                        as? String ?? ""
                    var state:String = addrNSDict.valueForKey(kABPersonAddressStateKey as String)
                        as? String ?? ""
                    var city:String = addrNSDict.valueForKey(kABPersonAddressCityKey as String)
                        as? String ?? ""
                    var street:String = addrNSDict.valueForKey(kABPersonAddressStreetKey as String)
                        as? String ?? ""
                    var contryCode:String = addrNSDict
                        .valueForKey(kABPersonAddressCountryCodeKey as String) as? String ?? ""
                    print("  \(localizedLabel): Contry:\(country) State:\(state) ")
                    println("City:\(city) Street:\(street) ContryCode:\(contryCode) ")
                }
            }
            
            //获取纪念日
            var dateValues:ABMutableMultiValueRef? =
            ABRecordCopyValue(contact, kABPersonDateProperty).takeRetainedValue()
            if dateValues != nil {
                println("纪念日：")
                for i in 0 ..< ABMultiValueGetCount(dateValues){
                    
                    // 获得标签名
                    var label = ABMultiValueCopyLabelAtIndex(emailValues, i).takeRetainedValue()
                        as CFStringRef;
                    var localizedLabel = ABAddressBookCopyLocalizedLabel(label)
                        .takeRetainedValue() as! String
                    
                    var value = ABMultiValueCopyValueAtIndex(dateValues, i)
                    var date = (value.takeRetainedValue() as? NSDate)?.description ?? ""
                    println("  \(localizedLabel):\(date)")
                }
            }
            
            //获取即时通讯(IM)
            var imValues:ABMutableMultiValueRef? =
            ABRecordCopyValue(contact, kABPersonInstantMessageProperty).takeRetainedValue()
            if imValues != nil {
                println("即时通讯(IM)：")
                for i in 0 ..< ABMultiValueGetCount(imValues){
                    
                    // 获得标签名
                    var label = ABMultiValueCopyLabelAtIndex(imValues, i).takeRetainedValue()
                        as CFStringRef;
                    var localizedLabel = ABAddressBookCopyLocalizedLabel(label)
                        .takeRetainedValue() as! String
                    
                    var value = ABMultiValueCopyValueAtIndex(imValues, i)
                    var imNSDict:NSMutableDictionary = value.takeRetainedValue()
                        as! NSMutableDictionary
                    var serves:String = imNSDict
                        .valueForKey(kABPersonInstantMessageServiceKey as String) as? String ?? ""
                    var userName:String = imNSDict
                        .valueForKey(kABPersonInstantMessageUsernameKey as String) as? String ?? ""
                    println("  \(localizedLabel): Serves:\(serves) UserName:\(userName)")
                }
            }
        }
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}