請切記，用戶的聯系人數據屬於個人敏感數據。用戶關心其隱私權，因此不希望應用收集有關其自身的數據或其聯系人的數據。 如需權限來訪問其聯系人數據的理由並不充分，用戶可能給您的應用作出差評或干脆拒絕安裝。

User Profile(用戶個人資料)

ContactsContract.Contacts 表有一行包含設備用戶的個人資料數據。 這些數據描述設備的 user 而不是用戶的其中一位聯系人。 對於每個使用個人資料的系統，該個人資料聯系人行都鏈接到某個原始聯系人行。 每個個人資料原始聯系人行可具有多個數據行。ContactsContract.Profile 類中提供了用於訪問用戶個人資料的常量。

訪問用戶個人資料需要特殊權限。除了進行讀取和寫入所需的 READ_CONTACTS 和 WRITE_CONTACTS 權限外，如果想訪問用戶個人資料，還分別需要 android.Manifest.permission#READ_PROFILE 和 android.Manifest.permission#WRITE_PROFILE 權限進行讀取和寫入訪問。

請切記，您應該將用戶的個人資料視為敏感數據。android.Manifest.permission#READ_PROFILE 權限讓您可以訪問設備用戶的個人身份識別數據。 請務必在您的應用的描述中告知用戶您需要用戶個人資料訪問權限的原因。

要檢索包含用戶個人資料的聯系人行，請調用 ContentResolver.query()。 將內容 URI 設置為 CONTENT_URI 並且不要提供任何選擇條件。 您還可以使用該內容 URI 作為檢索原始聯系人或個人資料數據的基本 URI。 例如，以下代碼段用於檢索個人資料數據：

// Sets the columns to retrieve for the user profile
mProjection = new String[]
    {
        Profile._ID,
        Profile.DISPLAY_NAME_PRIMARY,
        Profile.LOOKUP_KEY,
        Profile.PHOTO_THUMBNAIL_URI
    };

// Retrieves the profile from the Contacts Provider
mProfileCursor =
        getContentResolver().query(
                Profile.CONTENT_URI,
                mProjection ,
                null,
                null,
                null);

注：如果您要檢索多個聯系人行並想要確定其中一個是否為用戶個人資料，請測試該行的 IS_USER_PROFILE 列。 如果該聯系人是用戶個人資料，則此列設置為“1”。

(Contacts Provide Metadata)Contacts Provide元數據

Contact Provide管理用於追蹤存儲庫中聯系人數據狀態的數據。 這些有關存儲庫的元數據存儲在各處，其中包括原始聯系人表行、數據表行和聯系人表行、 ContactsContract.Settings 表以及 ContactsContract.SyncState 表。 下表顯示的是每一部分元數據的作用：

表 3. 聯系人提供程序中的元數據

Contacts Access Provider(聯系人提供程序訪問)

本節描述訪問聯系人提供程序中數據的准則，側重於闡述以下內容：

Discover Entity(查詢實體)

由於Contact Provider表是以層級形式組織，因此對於檢索某一行以及與其鏈接的所有“子”行，往往很有幫助。 例如，要想顯示某位聯系人的所有信息，您可能需要檢索某個 ContactsContract.Contacts 行的所有ContactsContract.RawContacts 行，或者檢索某個 ContactsContract.RawContacts 行的所有 ContactsContract.CommonDataKinds.Email 行。 為便於執行此操作，Contact Provider提供了實體構造，其作用類似於表間的數據庫連接。

實體類似於一個表，由父表及其子表中的選定列組成。 當您查詢實體時，需要根據實體中的可用列提供投影和搜索條件。 結果會得到一個 Cursor，檢索的每個子表行在其中都有一行與之對應。 例如，如果您在 ContactsContract.Contacts.Entity 中查詢某個聯系人姓名以及該姓名所有原始聯系人的所有 ContactsContract.CommonDataKinds.Email 行，您會獲得一個 Cursor，每個 ContactsContract.CommonDataKinds.Email 行在其中都有一行與之對應。

實體簡化了查詢。使用實體時，您可以一次性檢索聯系人或原始聯系人的所有聯系人數據，而不必先通過查詢父表獲得ID，然後通過該 ID 查詢子表。此外，聯系人提供程序可通過單一事務處理實體查詢，這確保了所檢索數據的內部一致性。

注：實體通常不包含父表和子表的所有列。 如果您試圖使用的列名稱並未出現在實體的列名稱常量列表中，則會引發一個 Exception。

以下代碼段說明如何檢索某位聯系人的所有原始聯系人行。該代碼段是一個大型應用的組成部分，包含“主”和“詳”兩個 Activity。 主 Activity 顯示一個聯系人行列表；當用戶選擇一行時，該 Activity 會將其 ID 發送至詳 Activity。 詳 Activity 使用 ContactsContract.Contacts.Entity 顯示與所選聯系人關聯的所有原始聯系人中的所有數據行。

   /*
     * Appends the entity path to the URI. In the case of the Contacts Provider, the
     * expected URI is content://com.google.contacts/#/entity (# is the ID value).
     */
    mContactUri = Uri.withAppendedPath(
            mContactUri,
            ContactsContract.Contacts.Entity.CONTENT_DIRECTORY);

    // Initializes the loader identified by LOADER_ID.
    getLoaderManager().initLoader(
            LOADER_ID,  // The identifier of the loader to initialize
            null,       // Arguments for the loader (in this case, none)
            this);      // The context of the activity

    // Creates a new cursor adapter to attach to the list view
    mCursorAdapter = new SimpleCursorAdapter(
            this,                        // the context of the activity
            R.layout.detail_list_item,   // the view item containing the detail widgets
            mCursor,                     // the backing cursor
            mFromColumns,                // the columns in the cursor that provide the data
            mToViews,                    // the views in the view item that display the data
            0);                          // flags

    // Sets the ListView's backing adapter.
    mRawContactList.setAdapter(mCursorAdapter);
...
@Override
public Loader onCreateLoader(int id, Bundle args) {

    /*
     * Sets the columns to retrieve.
     * RAW_CONTACT_ID is included to identify the raw contact associated with the data row.
     * DATA1 contains the first column in the data row (usually the most important one).
     * MIMETYPE indicates the type of data in the data row.
     */
    String[] projection =
        {
            ContactsContract.Contacts.Entity.RAW_CONTACT_ID,
            ContactsContract.Contacts.Entity.DATA1,
            ContactsContract.Contacts.Entity.MIMETYPE
        };

    /*
     * Sorts the retrieved cursor by raw contact id, to keep all data rows for a single raw
     * contact collated together.
     */
    String sortOrder =
            ContactsContract.Contacts.Entity.RAW_CONTACT_ID +
            " ASC";

    /*
     * Returns a new CursorLoader. The arguments are similar to
     * ContentResolver.query(), except for the Context argument, which supplies the location of
     * the ContentResolver to use.
     */
    return new CursorLoader(
            getApplicationContext(),  // The activity's context
            mContactUri,              // The entity content URI for a single contact
            projection,               // The columns to retrieve
            null,                     // Retrieve all the raw contacts and their data rows.
            null,                     //
            sortOrder);               // Sort by the raw contact ID.
}

加載完成時，LoaderManager 會調用一個 onLoadFinished() 回調。此方法的傳入參數之一是一個 Cursor，其中包含查詢的結果。在您自己的應用中，您可以從該 Cursor 獲取數據，以進行顯示或做進一步處理。

Batch Edit(批量修改)

您應盡可能地通過創建一個 ContentProviderOperation 對象 ArrayList 並調用 applyBatch()，以“批處理模式”在聯系人提供程序中插入、更新和刪除數據。 由於聯系人提供程序是在 applyBatch() 中通過單一事務執行所有操作，因此您的修改絕不會使聯系人存儲庫出現不一致問題。 此外，批量修改還有便於同時插入原始聯系人及其明細數據。

注：要修改單個原始聯系人，可以考慮向設備的聯系人應用發送一個 Intent，而不是在您的應用中處理修改。

Yield Point(屈服點)

一個包含大量操作的批量修改可能會阻斷其他進程，導致糟糕的總體用戶體驗。 要將您想執行的所有修改組織到盡可能少的單獨列表中，同時防止它們阻斷系統，則應為一項或多項操作設置屈服點。 屈服點是一個 ContentProviderOperation 對象，其 isYieldAllowed() 值設置為 true。當聯系人提供程序遇到屈服點時，它會暫停其工作，讓其他進程運行，並關閉當前事務。 當提供程序再次啟動時，它會繼續執行 ArrayList 中的下一項操作，並啟動一個新的事務。

屈服點會導致每次調用 applyBatch() 會產生多個事務。因此，您應該為針對一組相關行的最後一項操作設置屈服點。 例如，您應該為一組操作中添加原始聯系人行及其關聯數據行的最後一項操作，或者針對一組與一位聯系人相關的行的最後一項操作設置屈服點。

屈服點也是一個原子操作單元。兩個屈服點之間所有訪問的成功或失敗都將以一個單元的形式出現。 如果您不設置任何屈服點，則最小的原子操作是整個批量操作。 如果您使用了屈服點，則可以防止操作降低系統性能，還可確保一部分操作是原子操作。

Modify References Back(修改向後引用)

當您將一個新原始聯系人行及其關聯的數據行作為一組 ContentProviderOperation 對象插入時，需要通過將原始聯系人的 android.provider.BaseColumns#_ID 值作為 RAW_CONTACT_ID 值插入，將數據行鏈接到原始聯系人行。 不過，當您為數據行創建 ContentProviderOperation 時，該值不可用，因為您尚未對原始聯系人行應用 ContentProviderOperation。 為解決此問題， ContentProviderOperation.Builder 類使用了 withValueBackReference() 方法。 該方法讓您可以插入或修改包含上一操作結果的列。

withValueBackReference() 方法具有兩個參數：

以下代碼段說明如何批量插入新原始聯系人和數據。代碼段中包括用於建立屈服點和使用向後引用的代碼。 這些代碼段是擴展版本的 createContacEntry() 方法，該方法是 Contact Manager 示例應用中 ContactAdder 類的組成部分。

第一個代碼段用於檢索 UI 中的聯系人數據。此時，用戶已經選擇了應添加新原始聯系人的帳戶。

// Creates a contact entry from the current UI values, using the currently-selected account.
protected void createContactEntry() {
    /*
     * Gets values from the UI
     */
    String name = mContactNameEditText.getText().toString();
    String phone = mContactPhoneEditText.getText().toString();
    String email = mContactEmailEditText.getText().toString();

    int phoneType = mContactPhoneTypes.get(
            mContactPhoneTypeSpinner.getSelectedItemPosition());

    int emailType = mContactEmailTypes.get(
            mContactEmailTypeSpinner.getSelectedItemPosition());

下一個代碼段用於創建將該原始聯系人行插入 ContactsContract.RawContacts 表的操作：

 /*
     * Prepares the batch operation for inserting a new raw contact and its data. Even if
     * the Contacts Provider does not have any data for this person, you can't add a Contact,
     * only a raw contact. The Contacts Provider will then add a Contact automatically.
     */

     // Creates a new array of ContentProviderOperation objects.
    ArrayList ops =
            new ArrayList();

    /*
     * Creates a new raw contact with its account type (server type) and account name
     * (user's account). Remember that the display name is not stored in this row, but in a
     * StructuredName data row. No other data is required.
     */
    ContentProviderOperation.Builder op =
            ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
            .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, mSelectedAccount.getType())
            .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, mSelectedAccount.getName());

    // Builds the operation and adds it to the array of operations
    ops.add(op.build());

接著，代碼會創建顯示姓名行、電話行和電子郵件行的數據行。

每個操作生成器對象都使用 withValueBackReference() 來獲取 RAW_CONTACT_ID。引用指回來自第一次操作的 ContentProviderResult 對象，第一次操作就是添加原始聯系人行並返回其新 android.provider.BaseColumns#_ID 值。 結果是，每個數據行都通過其 RAW_CONTACT_ID 自動鏈接到其所屬的 ContactsContract.RawContacts 行。

添加電子郵件行的 ContentProviderOperation.Builder 對象帶有 withYieldAllowed() 標志，用於設置屈服點：

  // Creates the display name for the new raw contact, as a StructuredName data row.
    op =
            ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
            /*
             * withValueBackReference sets the value of the first argument to the value of
             * the ContentProviderResult indexed by the second argument. In this particular
             * call, the raw contact ID column of the StructuredName data row is set to the
             * value of the result returned by the first operation, which is the one that
             * actually adds the raw contact row.
             */
            .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)

            // Sets the data row's MIME type to StructuredName
            .withValue(ContactsContract.Data.MIMETYPE,
                    ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)

            // Sets the data row's display name to the name in the UI.
            .withValue(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, name);

    // Builds the operation and adds it to the array of operations
    ops.add(op.build());

    // Inserts the specified phone number and type as a Phone data row
    op =
            ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
            /*
             * Sets the value of the raw contact id column to the new raw contact ID returned
             * by the first operation in the batch.
             */
            .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)

            // Sets the data row's MIME type to Phone
            .withValue(ContactsContract.Data.MIMETYPE,
                    ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)

            // Sets the phone number and type
            .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phone)
            .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, phoneType);

    // Builds the operation and adds it to the array of operations
    ops.add(op.build());

    // Inserts the specified email and type as a Phone data row
    op =
            ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
            /*
             * Sets the value of the raw contact id column to the new raw contact ID returned
             * by the first operation in the batch.
             */
            .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)

            // Sets the data row's MIME type to Email
            .withValue(ContactsContract.Data.MIMETYPE,
                    ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE)

            // Sets the email address and type
            .withValue(ContactsContract.CommonDataKinds.Email.ADDRESS, email)
            .withValue(ContactsContract.CommonDataKinds.Email.TYPE, emailType);

    /*
     * Demonstrates a yield point. At the end of this insert, the batch operation's thread
     * will yield priority to other threads. Use after every set of operations that affect a
     * single contact, to avoid degrading performance.
     */
    op.withYieldAllowed(true);

    // Builds the operation and adds it to the array of operations
    ops.add(op.build());

最後一個代碼段顯示的是 applyBatch() 調用，用於插入新原始聯系人行和數據行。

  // Ask the Contacts Provider to create a new contact
    Log.d(TAG,"Selected account: " + mSelectedAccount.getName() + " (" +
            mSelectedAccount.getType() + ")");
    Log.d(TAG,"Creating contact: " + name);

    /*
     * Applies the array of ContentProviderOperation objects in batch. The results are
     * discarded.
     */
    try {

            getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);
    } catch (Exception e) {

            // Display a warning
            Context ctx = getApplicationContext();

            CharSequence txt = getString(R.string.contactCreationFailure);
            int duration = Toast.LENGTH_SHORT;
            Toast toast = Toast.makeText(ctx, txt, duration);
            toast.show();

            // Log exception
            Log.e(TAG, "Exception encountered while inserting contact: " + e);
    }
}

此外，您還可以利用批處理操作實現optimistic concurrency control，這是一種無需鎖定底層存儲庫便可應用修改事務的控制方法。 要使用此方法，您需要應用事務，然後檢查是否存在可能已同時做出的其他修改。 如果您發現了不一致的修改，請回滾事務並重試。

optimistic concurrency control對於移動設備很有用，因為在移動設備上，同一時間只有一位用戶，並且同時訪問數據存儲庫的情況很少見。 由於未使用鎖定功能，因此不用浪費時間設置鎖定或等待其他事務解除鎖定。

要在更新某個 ContactsContract.RawContacts 行時使用optimistic concurrency control，請按以下步驟操作：
1. 檢索原始聯系人的 VERSION 列以及要檢索的其他數據。
2. 創建一個適合使用 newAssertQuery(Uri) 方法強制執行約束 的 ContentProviderOperation.Builder 對象。對於內容 URI，請使用追加有原始聯系人 android.provider.BaseColumns#_ID 的 RawContacts.CONTENT_URI 。
3. 對於 ContentProviderOperation.Builder 對象，請調用 withValue()，對 VERSION 列與您剛檢索的版本號進行比較。
4. 對於同一 ContentProviderOperation.Builder，請調用 withExpectedCount()，確保此斷言只對一行進行測試。
5. 調用 build() 創建 ContentProviderOperation 對象，然後將此對象添加為要傳遞至 applyBatch() 的 ArrayList 中的第一個對象。
6. 應用批處理事務。

如果在您讀取原始聯系人行到您試圖對其進行修改這段時間有另一項操作更新了該行，“Assert”ContentProviderOperation 將會失敗，系統將終止整個批處理操作。 此情況下，您可以選擇重新執行批處理操作，或執行其他某操作。

以下代碼段演示如何在使用 CursorLoader 查詢一位原始聯系人後創建一個“Assert” ContentProviderOperation：

/*
 * The application uses CursorLoader to query the raw contacts table. The system calls this method
 * when the load is finished.
 */
public void onLoadFinished(Loader loader, Cursor cursor) {

    // Gets the raw contact's _ID and VERSION values
    mRawContactID = cursor.getLong(cursor.getColumnIndex(BaseColumns._ID));
    mVersion = cursor.getInt(cursor.getColumnIndex(SyncColumns.VERSION));
}

...

// Sets up a Uri for the assert operation
Uri rawContactUri = ContentUris.withAppendedId(RawContacts.CONTENT_URI, mRawContactID);

// Creates a builder for the assert operation
ContentProviderOperation.Builder assertOp = ContentProviderOperation.netAssertQuery(rawContactUri);

// Adds the assertions to the assert operation: checks the version and count of rows tested
assertOp.withValue(SyncColumns.VERSION, mVersion);
assertOp.withExpectedCount(1);

// Creates an ArrayList to hold the ContentProviderOperation objects
ArrayList ops = new ArrayList;

ops.add(assertOp.build());

// You would add the rest of your batch operations to "ops" here

...

// Applies the batch. If the assert fails, an Exception is thrown
try
    {
        ContentProviderResult[] results =
                getContentResolver().applyBatch(AUTHORITY, ops);

    } catch (OperationApplicationException e) {

        // Actions you want to take if the assert operation fails go here
    }

通過 Intent 執行檢索和修改

通過向設備的聯系人應用發送 Intent，您可以間接訪問聯系人提供程序。 Intent 會啟動設備的聯系人應用 UI，用戶可以在其中執行與聯系人有關的操作。 通過這種訪問方式，用戶可以：

刪除聯系人或聯系人數據。

如果用戶要插入或更新數據，您可以先收集數據，然後將其作為 Intent 的一部分發送。

當您使用 Intent 通過設備的聯系人應用訪問Contact Provider時，您無需自行編寫用於訪問該提供程序的 UI 或代碼。 您也無需請求對提供程序的讀取或寫入權限。 設備的聯系人應用可以將聯系人讀取權限授予給您，而且您是通過另一個應用對該提供程序進行修改，不需要擁有寫入權限。通過Intent訪問數據參考Android Content Provider基礎

表 4 匯總了您為可用任務使用的操作、MIME 類型以及數據值，ContactsContract.Intents.Insert 參考文檔列出了您可用於putExtra() 的 Extra 值：

表 4. Contact Provider Intent。

設備的聯系人應用不允許您使用 Intent 刪除原始聯系人或其任何數據。 因此，要刪除原始聯系人，請使用 ContentResolver.delete() 或 ContentProviderOperation.newDelete()。

以下代碼段說明如何構建和發送一個插入新原始聯系人和數據的 Intent：

// Gets values from the UI
String name = mContactNameEditText.getText().toString();
String phone = mContactPhoneEditText.getText().toString();
String email = mContactEmailEditText.getText().toString();

String company = mCompanyName.getText().toString();
String jobtitle = mJobTitle.getText().toString();

// Creates a new intent for sending to the device's contacts application
Intent insertIntent = new Intent(ContactsContract.Intents.Insert.ACTION);

// Sets the MIME type to the one expected by the insertion activity
insertIntent.setType(ContactsContract.RawContacts.CONTENT_TYPE);

// Sets the new contact name
insertIntent.putExtra(ContactsContract.Intents.Insert.NAME, name);

// Sets the new company and job title
insertIntent.putExtra(ContactsContract.Intents.Insert.COMPANY, company);
insertIntent.putExtra(ContactsContract.Intents.Insert.JOB_TITLE, jobtitle);

/*
 * Demonstrates adding data rows as an array list associated with the DATA key
 */

// Defines an array list to contain the ContentValues objects for each row
ArrayList contactData = new ArrayList();


/*
 * Defines the raw contact row
 */

// Sets up the row as a ContentValues object
ContentValues rawContactRow = new ContentValues();

// Adds the account type and name to the row
rawContactRow.put(ContactsContract.RawContacts.ACCOUNT_TYPE, mSelectedAccount.getType());
rawContactRow.put(ContactsContract.RawContacts.ACCOUNT_NAME, mSelectedAccount.getName());

// Adds the row to the array
contactData.add(rawContactRow);

/*
 * Sets up the phone number data row
 */

// Sets up the row as a ContentValues object
ContentValues phoneRow = new ContentValues();

// Specifies the MIME type for this data row (all data rows must be marked by their type)
phoneRow.put(
        ContactsContract.Data.MIMETYPE,
        ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE
);

// Adds the phone number and its type to the row
phoneRow.put(ContactsContract.CommonDataKinds.Phone.NUMBER, phone);

// Adds the row to the array
contactData.add(phoneRow);

/*
 * Sets up the email data row
 */

// Sets up the row as a ContentValues object
ContentValues emailRow = new ContentValues();

// Specifies the MIME type for this data row (all data rows must be marked by their type)
emailRow.put(
        ContactsContract.Data.MIMETYPE,
        ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE
);

// Adds the email address and its type to the row
emailRow.put(ContactsContract.CommonDataKinds.Email.ADDRESS, email);

// Adds the row to the array
contactData.add(emailRow);

/*
 * Adds the array to the intent's extras. It must be a parcelable object in order to
 * travel between processes. The device's contacts app expects its key to be
 * Intents.Insert.DATA
 */
insertIntent.putParcelableArrayListExtra(ContactsContract.Intents.Insert.DATA, contactData);

// Send out the intent to start the device's contacts app in its add contact activity.
startActivity(insertIntent);

數據完整性

聯系人存儲庫包含用戶認為是正確且是最新的重要敏感數據，因此Contact Provider具有規定清晰的數據完整性規則。 您有責任在修改聯系人數據時遵守這些規則。 以下列出了其中的重要規則：

如果ContactsContract.Data 表中的 ContactsContract.RawContacts 行沒有 ContactsContract.CommonDataKinds.StructuredName 行，可能會在聚合時引發問題。

如果 ContactsContract.Data 行未鏈接到 ContactsContract.RawContacts，則其在設備的聯系人應用中將處於不可見狀態，而且這可能會導致同步適配器出現問題。

請切記，Contact Provider所管理的數據通常來自多個不同帳戶類型/在線服務。 您需要確保您的應用僅修改或刪除歸您所有的行的數據，並且僅通過您控制的帳戶類型和帳戶名稱插入數據。

使用這些常量有助於您避免錯誤。如有任何常量被棄用，您還會從編譯器警告收到通知。

自定義數據行

通過創建和使用自己的自定義 MIME 類型，您可以在 ContactsContract.Data 表中插入、編輯、刪除和檢索您的自有數據行。 這些行僅限使用 ContactsContract.DataColumns 中定義的列，但您可以將您自己的類型專用列名稱映射到默認列名稱。 在設備的聯系人應用中，會顯示這些行的數據，但無法對其進行編輯或刪除，用戶也無法添加其他數據。 要允許用戶修改您的自定義數據行，您必須在自己的應用中提供編輯器 Activity。

要顯示您的自定義數據，請提供一個 contacts.xml 文件，其中須包含一個 元素，及其一個或多個 子元素。 element 部分對此做了更詳盡的描述。

Contacts Provider Sync Adapters(同步適配器)

要為Contact Provider 實現同步適配器，您首先要創建一個包含以下內容的 Android 應用：

一個 Service 組件，用於響應系統發出的綁定到同步適配器的請求。
當系統想要運行同步時，它會調用服務的 onBind() 方法，為同步適配器獲取一個 IBinder。這樣，系統便可跨進程調用適配器的方法。

作為 AbstractThreadedSyncAdapter 具體子類實現的實際同步適配器。
此類的作用是從服務器下載數據、從設備上傳數據以及解決沖突。 適配器的主要工作是在方法 onPerformSync() 中完成的。 必須將此類實例化為單一實例。

Application 的子類。
此類充當同步適配器單一實例的工廠。使用 onCreate() 方法實例化同步適配器，並提供一個靜態“getter”方法，使單一實例返回同步適配器服務的 onBind() 方法。

可選：一個 Service 組件，用於響應系統發出的用戶身份驗證請求。
AccountManager 會啟動此服務以開始身份驗證流程。 該服務的 onCreate() 方法會將一個身份驗證器對象實例化。 當系統想要對應用同步適配器的用戶帳戶進行身份驗證時，它會調用該服務的 onBind() 方法，為該身份驗證器獲取一個 IBinder。 這樣，系統便可跨進程調用身份驗證器的方法。

可選：一個用於處理身份驗證請求的 AbstractAccountAuthenticator 具體子類。
AccountManager 就是調用此類所提供的方法向服務器驗證用戶的憑據。 詳細的身份驗證過程會因服務器所采用技術的不同而有很大差異。

用於定義系統同步適配器和身份驗證器的 XML 文件。
之前描述的同步適配器和身份驗證器服務組件都是在應用清單文件中的 元素內定義的。 這些元素包含以下用於向系統提供特定數據的 子元素：

res/xml/contacts.xml