在开发移动应用程序时，访问联系人信息是一个常见的需求。Android平台提供了一个Contacts框架，它允许开发者访问和管理设备上的联系人信息。本博客将为您介绍如何使用Contacts框架来访问联系人信息并进行联系人管理。
引入Contacts框架
要使用Contacts框架，首先需要在应用程序的AndroidManifest.xml文件中添加以下权限：
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
这些权限分别用于读取和写入联系人信息。
然后，在应用程序中引入Contacts框架：
import android.provider.ContactsContract;
查询联系人
现在我们可以开始查询联系人信息了。使用ContactsContract类中的CONTENT_URI常量，我们可以获取联系人的内容URI。使用此URI，我们可以执行查询以获取所有联系人的详细信息。
以下是一个查询所有联系人信息的示例：
Cursor cursor = getContentResolver().query(
ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
if (cursor != null && cursor.getCount() > 0) {
while (cursor.moveToNext()) {
String name = cursor.getString(
cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
// 获取联系人姓名
// 其他联系人信息可通过对应的常量获取，例如电话号码、电子邮件等
// 这里省略读取其他联系人信息的代码，您可以根据需求自行添加
Log.d("Contact Name", name);
}
cursor.close();
}
在上面的示例中，我们使用getContentResolver().query()方法执行了一个查询，获取联系人的显示名称，并将其打印到日志中。您可以根据需要查询其他联系人信息，例如电话号码、电子邮件等。
添加联系人
如果您需要向设备的联系人列表中添加联系人，可以使用ContactsContract类中的CONTENT_URI常量，并使用getContentResolver().insert()方法插入新联系人。
以下是一个示例，展示了如何向联系人列表中添加新联系人：
ContentValues values = new ContentValues();
values.put(ContactsContract.RawContacts.CONTENT_TYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE);
values.put(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, "John");
// 设置联系人姓名为"John"
// 您可以添加其他联系人信息，如电话号码、电子邮件等
Uri uri = getContentResolver().insert(ContactsContract.RawContacts.CONTENT_URI, values);
long rawContactId = ContentUris.parseId(uri);
在上面的示例中，我们首先创建一个ContentValues对象，并设置联系人的相关信息，例如姓名等。然后，我们使用getContentResolver().insert()方法将新联系人插入到设备的联系人列表中。插入成功后，返回的URI将包含新联系人的ID，您可以使用ContentUris.parseId()方法解析ID并进行后续的操作。
更新和删除联系人
Contacts框架还提供了更新和删除联系人的方法。要更新联系人信息，您可以使用getContentResolver().update()方法，将新的联系人信息传递给相应的URI。
以下是一个示例，展示了如何更新联系人的姓名：
ContentValues values = new ContentValues();
values.put(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, "John Doe");
getContentResolver().update(
ContactsContract.Data.CONTENT_URI,
values,
ContactsContract.Data.RAW_CONTACT_ID + "=? AND " + ContactsContract.Data.MIMETYPE + "=?",
new String[]{String.valueOf(rawContactId), ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE});
在上面的示例中，我们首先创建一个ContentValues对象，并设置新的联系人姓名。然后，我们使用getContentResolver().update()方法将新的联系人信息传递给ContactsContract.Data.CONTENT_URI，同时指定更新的条件。
要删除联系人，请使用getContentResolver().delete()方法，并指定要删除的联系人的URI。
getContentResolver().delete(
ContactsContract.RawContacts.CONTENT_URI,
ContactsContract.RawContacts._ID + "=?",
new String[]{String.valueOf(rawContactId)});
在上面的示例中，我们使用getContentResolver().delete()方法删除了指定ID的联系人。
总结
通过Contacts框架，我们可以方便地访问和管理设备上的联系人信息。我们可以查询联系人详细信息、添加新联系人、更新现有联系人、甚至删除联系人。使用Contacts框架可以为我们的应用程序提供更好的用户体验。本博客给出了使用Contacts框架访问联系人信息的基本示例，您可以根据自己的需求自由扩展。希望这篇博客能对您有所帮助！
本文来自极简博客，作者：梦幻蝴蝶，转载请注明原文链接：使用Contacts框架访问联系人信息
