使用Intents修改聯系人信息 · Android Training官方培訓課程中文版

> 編寫:[spencer198711](https://github.com/spencer198711) - 原文:[http://developer.android.com/training/contacts-provider/modify-data.html](http://developer.android.com/training/contacts-provider/modify-data.html) 這一課介紹如何使用[Intent](http://developer.android.com/reference/android/content/Intent.html)去插入一個新的聯系人或者修改聯系人的數據。我們不是直接訪問Contacts Provider，而是通過Intent啟動Contacts應用去運行適當的[Activity](# "An activity represents a single screen with a user interface.")。對于這一課中描述的數據修改行為，如果你向Intent發送擴展的數據，它會自動填充進啟動的[Activity](# "An activity represents a single screen with a user interface.")頁面中。使用Intent去插入或者更新一個聯系人是比較推薦的修改Contacts Provider的做法。原因如下： - 節省了我們自行開發UI和編寫代碼的時間和精力。 - 避免了由于不按照Contacts Provider的規則去修改而產生的錯誤。 - 減少應用需要申請的權限數量。因為我們的應用把修改行為委托給已經擁有寫Contacts Provider權限的Contacts應用，所以我們的應用不需要再去申請這個權限，。 ### 使用Intent插入新的聯系人當我們的應用接收到新的數據時，我們通常會允許用戶去插入一個新的聯系人。例如，一個餐館評論應用可以允許用戶在評論餐館的時候，把這個餐館添加為一個聯系人。可以使用Intent去做這個任務，使用我們擁有的盡可能多的數據去創建對應的Intent，然后發送這個Intent到Contacts應用。使用Contacts應用去插入一個聯系人將會向Contacts Provider中的[ContactsContract.RawContacts](http://developer.android.com/reference/android/provider/ContactsContract.RawContacts.html)表中插入一個原始聯系人。必要的情況下，在創建原始聯系人的時候，Contacts應用將會提示用戶選擇賬戶類型和要使用的賬戶。如果聯系人已經存在，Contacts應用也會告知用戶。用戶將會有取消插入的選項，在這種情況下不會有聯系人被創建。想要知道更多關于原始聯系人的信息，請參閱[Contacts Provider](http://developer.android.com/guide/topics/providers/contacts-provider.html)的API指導。 ### 創建一個Intent 利用Intents.Insert.ACTION創建一個新的Intent對象，并設置其MIME類型為[RawContacts.CONTENT_TYPE](http://developer.android.com/reference/android/provider/ContactsContract.RawContacts.html#CONTENT_TYPE)。例如： ~~~ ... // Creates a new Intent to insert a contact Intent intent = new Intent(Intents.Insert.ACTION); // Sets the MIME type to match the Contacts Provider intent.setType(ContactsContract.RawContacts.CONTENT_TYPE); ~~~ 如果我們已經獲得了此聯系人的詳細信息，比如說電話號碼或者email地址，那么我們可以把它們作為擴展數據添加到Intent中。對于鍵值，需要使用[Intents.Insert](http://developer.android.com/reference/android/provider/ContactsContract.Intents.Insert.html)中對應的常量。Contacts應用將會在插入界面顯示這些數據，以便用戶作進一步的數據編輯和數據添加。 ~~~ /* Assumes EditText fields in your UI contain an email address * and a phone number. * */ private EditText mEmailAddress = (EditText) findViewById(R.id.email); private EditText mPhoneNumber = (EditText) findViewById(R.id.phone); ... /* * Inserts new data into the Intent. This data is passed to the * contacts app's Insert screen */ // Inserts an email address intent.putExtra(Intents.Insert.EMAIL, mEmailAddress.getText()) /* * In this example, sets the email type to be a work email. * You can set other email types as necessary. */ .putExtra(Intents.Insert.EMAIL_TYPE, CommonDataKinds.Email.TYPE_WORK) // Inserts a phone number .putExtra(Intents.Insert.PHONE, mPhoneNumber.getText()) /* * In this example, sets the phone type to be a work phone. * You can set other phone types as necessary. */ .putExtra(Intents.Insert.PHONE_TYPE, Phone.TYPE_WORK); ~~~ 一旦我們創建好Intent，調用startActivity()將其發送到Contacts應用。 ~~~ /* Sends the Intent */ startActivity(intent); ~~~ 這個調用將會打開Contacts應用的界面，并允許用戶進入一個新的聯系人。這個聯系人的賬戶類型和賬戶名字列在屏幕的上方。一旦用戶輸入數據并點擊_確定_，Contacts應用的聯系人列表則會顯示出來。用戶可以點擊_Back_鍵返回到我們自己創建的應用。 ### 使用Intent編輯已經存在的聯系人如果用戶已經選擇了一個感興趣的聯系人，使用Intent去編輯這個已存在的聯系人會很有用。例如，一個用來查找擁有郵政地址但是缺少郵政編碼的聯系人的應用，可以給用戶提供查找郵政編碼的選項，然后把找到的郵政編碼添加到這個聯系人中。使用Intent編輯已經存在的聯系人，同插入一個聯系人的步驟類似。像前面介紹的[使用Intent插入新的聯系人]()創建一個Intent，但是需要給這個Intent添加對應聯系人的[Contacts.CONTENT_LOOKUP_URI](http://developer.android.com/reference/android/provider/ContactsContract.Contacts.html#CONTENT_LOOKUP_URI)和MIME類型[Contacts.CONTENT_ITEM_TYPE](http://developer.android.com/reference/android/provider/ContactsContract.Contacts.html#CONTENT_ITEM_TYPE)。如果想要使用已經擁有的詳情信息編輯這個聯系人，我們需要把這些數據放到Intent的擴展數據中。同時注意有些列是不能使用Intent編輯的，這些不可編輯的列在[ContactsContract.Contacts](http://developer.android.com/reference/android/provider/ContactsContract.Contacts.html) 摘要部分“Update”標題下有列出。最后，發送這個Intent。Contacts應用會顯示一個編輯界面作為回應。當用戶編輯完成并保存，Contacts應用會顯示一個聯系人列表。當用戶點擊_Back_，我們自己的應用會出現。 ### 創建Intent 為了能夠編輯一個聯系人，需要調用Intent(action)去創建一個擁有ACTION_EDIT行為的Intent。調用setDataAndType()去設置這個Intent要編輯的聯系人的Contacts.CONTENT_LOOKUP_URI和MIME類型Contacts.CONTENT_ITEM_TYPE。因為調用setType()會重寫Intent當前的數據，所以我們必須同時設置數據和MIME類型。為了得到聯系人的Contacts.CONTENT_LOOKUP_URI，需要調用Contacts.getLookupUri(id, lookupkey)方法，該方法的參數分別是聯系人的Contacts._ID和Contacts.LOOKUP_KEY。以下的代碼片段展示了如何創建這個Intent： ~~~ // The Cursor that contains the Contact row public Cursor mCursor; // The index of the lookup key column in the cursor public int mLookupKeyIndex; // The index of the contact's _ID value public int mIdIndex; // The lookup key from the Cursor public String mCurrentLookupKey; // The _ID value from the Cursor public long mCurrentId; // A content URI pointing to the contact Uri mSelectedContactUri; ... /* * Once the user has selected a contact to edit, * this gets the contact's lookup key and _ID values from the * cursor and creates the necessary URI. */ // Gets the lookup key column index mLookupKeyIndex = mCursor.getColumnIndex(Contacts.LOOKUP_KEY); // Gets the lookup key value mCurrentLookupKey = mCursor.getString(mLookupKeyIndex); // Gets the _ID column index mIdIndex = mCursor.getColumnIndex(Contacts._ID); mCurrentId = mCursor.getLong(mIdIndex); mSelectedContactUri = Contacts.getLookupUri(mCurrentId, mCurrentLookupKey); ... // Creates a new Intent to edit a contact Intent editIntent = new Intent(Intent.ACTION_EDIT); /* * Sets the contact URI to edit, and the data type that the * Intent must match */ editIntent.setDataAndType(mSelectedContactUri,Contacts.CONTENT_ITEM_TYPE); ~~~ ### 添加導航標志在Android 4.0（API版本14）和更高的版本，Contacts應用中的一個問題會導致錯誤的頁面導航。我們的應用發送一個編輯聯系人的Intent到Contacts應用，用戶編輯并保存這個聯系人，當用戶點擊_Back_鍵的時候會看到聯系人列表頁面。用戶需要點擊最近使用的應用，然后選擇我們的應用，才能返回到我們自己的應用。要在Android 4.0.3（API版本15）及以后的版本解決此問題，需要添加`finishActivityOnSaveCompleted`擴展數據參數到這個Intent，并將它的值設置為true。Android 4.0之前的版本也能夠接受這個參數，但是不起作用。為了設置擴展數據，請按照以下方式去做： ~~~ // Sets the special extended data for navigation editIntent.putExtra("finishActivityOnSaveCompleted", true); ~~~ ### 添加其他的擴展數據對Intent添加額外的擴展數據，需要調用putExtra()。可以為常見的聯系人數據字段添加擴展數據，這些常見字段的key值可以從[Intents.Insert](http://developer.android.com/reference/android/provider/ContactsContract.Intents.Insert.html) API參考文檔中查到。記住ContactsContract.Contacts表中有些列是不能編輯的，這些列在[ContactsContract.Contacts](http://developer.android.com/reference/android/provider/ContactsContract.Contacts.html)的摘要部分“Update”標題下有列出。 ### 發送Intent 最后，發送我們已經構建好的Intent。例如： ~~~ // Sends the Intent startActivity(editIntent); ~~~ ### 使用Intent讓用戶去選擇是插入還是編輯聯系人我們可以通過發送帶有`ACTION_INSERT_OR_EDIT`行為的Intent，讓用戶去選擇是插入聯系人還是編輯已有的聯系人。例如，一個email客戶端應用會允許用戶添加一個收件地址到新的聯系人，或者僅僅作為額外的郵件地址添加到已有的聯系人。需要為這個Intent設置MIME類型Contacts.CONTENT_ITEM_TYPE，但是不需要設置數據URI。當我們發送這個Intent后，Contacts應用會展示一個聯系人列表。用戶可以選擇是插入一個新的聯系人還是挑選一個存在的聯系人去編輯。任何添加到Intent中的擴展數據字段都會填充在界面上。我們可以使用任何在[Intents.Insert](http://developer.android.com/reference/android/provider/ContactsContract.Intents.Insert.html)中指定的的key值。以下的代碼片段展示了如何構建和發送這個Intent： ~~~ // Creates a new Intent to insert or edit a contact Intent intentInsertEdit = new Intent(Intent.ACTION_INSERT_OR_EDIT); // Sets the MIME type intentInsertEdit.setType(Contacts.CONTENT_ITEM_TYPE); // Add code here to insert extended data, if desired ... // Sends the Intent with an request ID startActivity(intentInsertEdit); ~~~