本文介绍如何在 android 应用中通过 contacts provider 精准查询最近被修改（如姓名、号码变更）的联系人，避免全量扫描，提升性能与响应效率。
本文介绍如何在 android 应用中通过 contacts provider 精准查询最近被修改（如姓名、号码变更）的联系人，避免全量扫描，提升性能与响应效率。
在使用 ContentObserver 监听联系人变更后，仅知道“有更新”是不够的——关键在于识别哪些联系人实际被修改过。Android 的 Contacts Provider 提供了内置字段 CONTACT_LAST_UPDATED_TIMESTAMP（类型为 LONG，单位为毫秒），它记录每个联系人最后一次更新的时间戳，是实现增量同步的核心依据。
✅ 正确做法：按时间戳筛选更新项
替换原有全量查询逻辑，改用 ContactsContract.Contacts.CONTENT_URI 并投影关键字段：
public void contactChanged() {
ContentResolver resolver = getContentResolver();
String[] projection = {
ContactsContract.Contacts._ID,
ContactsContract.Contacts.DISPLAY_NAME,
ContactsContract.Contacts.CONTACT_LAST_UPDATED_TIMESTAMP
};
String sortOrder = ContactsContract.Contacts.CONTACT_LAST_UPDATED_TIMESTAMP + " DESC";
Cursor cursor = resolver.query(
ContactsContract.Contacts.CONTENT_URI,
projection,
null, // selection（可加条件，如只查过去24小时）
null, // selectionArgs
sortOrder
);
if (cursor != null) {
try {
while (cursor.moveToNext()) {
String id = cursor.getString(cursor.getColumnIndexOrThrow(ContactsContract.Contacts._ID));
String name = cursor.getString(cursor.getColumnIndexOrThrow(ContactsContract.Contacts.DISPLAY_NAME));
long lastUpdatedMs = cursor.getLong(cursor.getColumnIndexOrThrow(ContactsContract.Contacts.CONTACT_LAST_UPDATED_TIMESTAMP));
// ⚠️ 注意：lastUpdatedMs 是自系统启动以来的毫秒数（非 Unix 时间戳）
// 如需转换为标准时间，请使用：
// Date updatedDate = new Date(lastUpdatedMs);
// 示例：仅处理 5 分钟内更新的联系人（可按需调整）
if (System.currentTimeMillis() - lastUpdatedMs <= 5 * 60 * 1000) {
// 执行同步、本地更新或通知逻辑
processUpdatedContact(id, name, lastUpdatedMs);
}
}
} finally {
cursor.close(); // 必须显式关闭，防止内存泄漏
}
}
}? 补充说明与注意事项
- CONTACT_LAST_UPDATED_TIMESTAMP 的可靠性：该字段由系统自动维护，涵盖所有变更（包括姓名、号码、邮箱、分组等），无需手动触发更新。
- 避免重复处理：建议在应用中持久化一个“最后同步时间戳”，每次查询时添加 selection 条件（例如 "contact_last_updated_timestamp > ?"），实现真正的增量拉取。
- 权限要求：确保已在 AndroidManifest.xml 中声明 READ_CONTACTS 权限（Android 6.0+ 需运行时申请）。
- 性能优化：相比遍历 Phone.CONTENT_URI（可能含重复联系人），直接查 Contacts.CONTENT_URI 更高效、去重且语义清晰。
- ContentObserver 注册/注销：务必在 Activity.onDestroy() 或 Service.onDestroy() 中调用 getContentResolver().unregisterContentObserver(observer)，避免内存泄漏和重复回调。
通过合理利用 CONTACT_LAST_UPDATED_TIMESTAMP 字段，你不仅能精准捕获变更，还能构建轻量、可靠、可扩展的联系人同步机制。
