如何将通话/SMS应用加入安卓默认通讯录的「关联应用」列表？

要让通话/短信类应用出现在系统通讯录的关联应用列表，核心是让系统通讯录识别到你的应用可处理联系人相关操作，并能与通讯录数据建立关联。以下是具体配置和实现要点：

1. 声明必要权限 #

在AndroidManifest.xml中添加静态权限声明，Android 6.0+还需动态申请危险权限：

<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />

2. 配置联系人相关Intent Filter #

系统通讯录通过检测应用是否能处理特定联系人Intent来纳入关联列表，在处理联系人的Activity中添加以下配置：

<activity android:name=".ContactHandlerActivity">
    <intent-filter>
        <!-- 处理联系人详情查看 -->
        <action android:name="android.intent.action.VIEW" />
        <data android:mimeType="vnd.android.cursor.item/contact" />
        <category android:name="android.intent.category.DEFAULT" />
        
        <!-- 处理通话请求 -->
        <action android:name="android.intent.action.CALL" />
        <data android:scheme="tel" />
        
        <!-- 处理短信请求 -->
        <action android:name="android.intent.action.SENDTO" />
        <data android:scheme="smsto" />
        
        <!-- 支持从通讯录选择联系人 -->
        <action android:name="android.intent.action.PICK" />
        <data android:mimeType="vnd.android.cursor.dir/phone_v2" />
    </intent-filter>
</activity>

3. 实现通讯录关联的ContentProvider（关键） #

之前使用ContentProvider未成功，大概率是未正确实现ContactsContract.Contacts.Entity相关查询逻辑，需按以下步骤配置：

3.1 注册ContentProvider到Manifest #

<provider
    android:name=".ContactLinkProvider"
    android:authorities="com.your.package.contactlink"
    android:exported="true"
    android:permission="android.permission.READ_CONTACTS">
    <meta-data
        android:name="android.provider.ContactsContract"
        android:value="true" />
</provider>

3.2 实现核心查询逻辑 #

重点处理query()方法，当系统通讯录查询ContactsContract.Contacts.Entity.CONTENT_URI时，返回应用与联系人的关联数据：

@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
    if (ContactsContract.Contacts.Entity.CONTENT_URI.equals(uri)) {
        // 构建包含应用关联信息的Cursor
        MatrixCursor cursor = new MatrixCursor(projection);
        // 填充字段：联系人ID、应用包名、操作文本（如"发送消息"）、应用图标Uri等
        Object[] row = new Object[projection.length];
        // 示例：根据传入的联系人ID，添加当前应用的关联条目
        // row[索引] = 对应字段值，需匹配projection中的字段顺序
        cursor.addRow(row);
        return cursor;
    }
    return super.query(uri, projection, selection, selectionArgs, sortOrder);
}

4. 关联账户（可选） #

若需将应用账户绑定到通讯录，需通过AccountManager添加账户，并配置SyncAdapter关联通讯录同步：

• 注册SyncAdapter服务，设置contentAuthority为com.android.contacts
• 实现SyncAdapter同步逻辑，将应用内的通话/短信/联系人数据同步到系统通讯录

5. 测试验证 #

• 确认应用已获取所有必要权限（可在应用信息页手动检查）
• 用adb命令测试Intent响应：

  adb shell am start -a android.intent.action.VIEW -d content://com.android.contacts/contacts/1
  

  若应用出现在可选列表，说明Intent配置有效
• 重启系统通讯录，查看关联应用列表是否显示你的应用

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