Android ContactsContract 如何通过Intent填充结构化姓名的前缀、后缀字段？

可行实现方案 #

你遇到的参数无效问题，本质是大部分定制ROM/第三方联系人应用没有实现对ContactsContract.Intents.Insert.DATA字段中结构化姓名的解析逻辑，按以下步骤实现可覆盖绝大多数场景：

1. 首先确保Intent初始化符合规范，这是DATA参数能被系统识别的前提：

// 初始化Intent必须使用正确的Action和Type
Intent intent = new Intent(Intent.ACTION_INSERT);
intent.setType(ContactsContract.Contacts.CONTENT_TYPE);

2. 采用双保险的参数传递逻辑，同时兼容支持和不支持结构化姓名解析的联系人应用：

// 自定义姓名各字段值
String prefix = "Sir";
String givenName = "John";
String familyName = "Doe";
String suffix = "PhD";

// 第一套参数：拼接完整姓名，供不支持结构化解析的应用使用
String fullName = String.format("%s %s %s %s", prefix, givenName, familyName, suffix);
intent.putExtra(ContactsContract.Intents.Insert.NAME, fullName);

// 第二套参数：传入结构化姓名数据，供支持该特性的应用识别前缀、后缀
ArrayList<ContentValues> data = new ArrayList<>();
ContentValues nameRow = new ContentValues();
nameRow.put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE);
nameRow.put(ContactsContract.CommonDataKinds.StructuredName.PREFIX, prefix);
nameRow.put(ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, givenName);
nameRow.put(ContactsContract.CommonDataKinds.StructuredName.FAMILY_NAME, familyName);
nameRow.put(ContactsContract.CommonDataKinds.StructuredName.SUFFIX, suffix);
data.add(nameRow);
intent.putExtra(ContactsContract.Intents.Insert.DATA, data);

3. 增加异常捕获逻辑避免设备无联系人应用时崩溃：

if (intent.resolveActivity(getPackageManager()) != null) {
    startActivity(intent);
}

适配说明 #

• 原生AOSP系统的官方联系人应用从Android 7.0版本开始就完整支持上述结构化姓名参数，前缀、后缀会自动填充到对应输入框
• 未适配该特性的第三方/定制ROM联系人应用，会直接展示拼接后的完整姓名，用户可手动调整拆分内容即可

内容的提问来源于stack exchange，提问作者Mc Midas