Address Book is a technology that encompasses a centralized database for contact and group information, an application for viewing that information, and a programmatic interface for accessing that information in your own applications. The database contains information such as user names, street addresses, email addresses, phone numbers, and distribution lists. Applications that use the Address Book framework can share this contact information with other applications, including Mail and iChat, or extend it to include application-specific information.
The Address Book framework provides two APIs: one for Objective-C and one for C. Both are equally functional, but the majority of the code samples in this document are printed in Objective-C only. Where it is appropriate, this document addresses fundamental differences between the two. Developers using the C programming interface should refer to “Using the Address Book C API” and Address Book C Framework Reference for Mac OS X for information about mapping the Objective-C code to C.
This document is designed for anyone who wants to leverage the abilities of the Mac OS X Address Book technology in their application. You should read it to learn how to access a user’s address book, add new properties to the address book database, and create action plug-ins for the Address Book application.
It is expected that you are already familiar with Xcode and the basics of Mac OS X application development.
Note: Developers who have used the Address Book technology on iOS should be aware that the programming interface for this technology is different on Mac OS X.
The document contains the following articles:
“About the Address Book” describes what’s in the Address Book database and what you can do with it.
“Managing Address Book Records ” describes how to add and remove people and groups, how to arrange people into groups, and how to find the record for the logged-in user.
“Accessing Address Book Records” describes how to access data in a person or group record.
“Searching an Address Book” describes how to perform searches on a user’s address book.
“Using Address Book Groups as Distribution Lists” describes how to set up a group so you can use it as a mailing list, or other type of distribution list.
“Adding Properties to Address Book Records” describes how to customize an address book for your own applications by adding properties to it.
“Creating and Using Address Book Action Plug-ins” describes how to create action plug-ins which allow users to perform custom actions on address book data viewed within the Address Book application.
“Importing and Exporting Address Book People and Groups” describes how to import and export person records by using the vCard standard.
“Using the Address Book C API” contains special information for those using the Address Book C API.
Sync Services Programming Guide discusses the data synchronization engine built-in to Mac OS X.
Identity Services Programming Guide discusses a way to manage groups of users on a local system, including standard login accounts and sharing accounts.
Last updated: 2010-08-03