如何高效查询 Android 中已更新的联系人数据

雨明君_5711

雨明君_5711

2026-06-30

614人浏览

原创

如何高效查询 Android 中已更新的联系人数据

本文介绍如何利用 contactscontract.contacts.contact_last_updated_timestamp 字段精准筛选出最近被修改(如姓名、电话等字段变更)的联系人,避免全量遍历,提升性能与响应效率。

本文介绍如何利用 contactscontract.contacts.contact_last_updated_timestamp 字段精准筛选出最近被修改(如姓名、电话等字段变更)的联系人,避免全量遍历,提升性能与响应效率。

在 Android 联系人开发中,仅监听变更事件(如通过 ContentObserver)并不足以满足业务需求——关键在于识别哪些联系人真正发生了更新。原代码中直接查询 Phone.CONTENT_URI 会返回所有带号码的联系人记录,无法区分“新增”“修改”或“未变”,且存在重复(同一联系人可能有多个号码)。正确做法是:以联系人实体(ContactsContract.Contacts)为单位,按最后更新时间戳筛选。

✅ 正确查询已更新联系人的核心逻辑

ContactsContract.Contacts.CONTACT_LAST_UPDATED_TIMESTAMP 是系统维护的时间戳(毫秒级 Unix 时间),每次联系人任意字段(包括姓名、号码、邮箱、头像等)被修改时自动更新。因此,只需按该字段排序并限定范围即可高效获取增量变更:

Mapbox Android Patterns
Mapbox Android Patterns

Mapbox Maps SDK 在 Android 上的官方集成模式,涵盖安装、添加标记、用户定位、自定义数据、样式、相机控制等功能

下载
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";

    try (Cursor cursor = resolver.query(
            ContactsContract.Contacks.CONTENT_URI,
            projection,
            null, null, sortOrder)) {

        if (cursor == null || cursor.getCount() == 0) return;

        JSONArray updatedContacts = new JSONArray();
        while (cursor.moveToNext()) {
            String id = cursor.getString(cursor.getColumnIndexOrThrow(ContactsContract.Contacts._ID));
            String name = cursor.getString(cursor.getColumnIndexOrThrow(ContactsContract.Contacts.DISPLAY_NAME));
            long lastUpdated = cursor.getLong(cursor.getColumnIndexOrThrow(ContactsContract.Contacts.CONTACT_LAST_UPDATED_TIMESTAMP));

            // ⚠️ 关键建议:添加时间过滤(例如仅过去5分钟内更新)
            // long cutoff = System.currentTimeMillis() - 5 * 60 * 1000;
            // if (lastUpdated <h3>? 注意事项与最佳实践</h3>
  • 权限必需:确保已在 AndroidManifest.xml 中声明 android:name="android.permission.READ_CONTACTS" />,并在运行时动态申请(Android 6.0+)。
  • 避免全量扫描:CONTACT_LAST_UPDATED_TIMESTAMP 是唯一可靠的变更标识,切勿依赖 onChange(boolean selfChange) 的 selfChange 参数——它仅表示变更是否由本应用触发,无法反映实际数据变化。
  • 性能优化建议:
    • 在 query() 后添加 WHERE 条件(如 CONTACT_LAST_UPDATED_TIMESTAMP > ?)限制时间范围,大幅减少结果集;
    • 使用 try-with-resources 确保 Cursor 及时关闭(示例已体现);
    • 若需获取号码/邮箱等详细字段,应以 contactId 为条件二次查询对应 Data 表,而非直接查 Phone.CONTENT_URI(该 URI 无 CONTACT_LAST_UPDATED_TIMESTAMP 字段)。
  • 生命周期管理:务必在 Activity.onDestroy() 或 Fragment.onDestroyView() 中调用 getContentResolver().unregisterContentObserver(observer),防止内存泄漏。

通过上述方式,你将获得真正意义上“被编辑过”的联系人列表,为同步、备份或实时 UI 更新提供精准、轻量的数据源。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

android

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
android开发三大框架
android开发三大框架

android开发三大框架是XUtil框架、volley框架、ImageLoader框架。本专题为大家提供android开发三大框架相关的各种文章、以及下载和课程。

2023.08.14

882

4

android是什么系统
android是什么系统

Android是一种功能强大、灵活可定制、应用丰富、多任务处理能力强、兼容性好、网络连接能力强的操作系统。本专题为大家提供android相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.22

2567

5

android权限限制怎么解开
android权限限制怎么解开

android权限限制可以使用Root权限、第三方权限管理应用程序、ADB命令和Xposed框架解开。详细介绍:1、Root权限,通过获取Root权限,用户可以解锁所有权限,并对系统进行自定义和修改;2、第三方权限管理应用程序,用户可以轻松地控制和管理应用程序的权限;3、ADB命令,用户可以在设备上执行各种操作,包括解锁权限;4、Xposed框架,用户可以在不修改系统文件的情况下修改应用程序的行为和权限。

2023.09.19

4837

7

android重启应用的方法有哪些
android重启应用的方法有哪些

android重启应用有通过Intent、PendingIntent、系统服务、Runtime等方法。本专题为大家提供Android相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

625

5

Android语音播放功能实现方法
Android语音播放功能实现方法

实现方法有使用MediaPlayer实现、使用SoundPool实现两种。可以根据具体的需求选择适合的方法进行实现。想了解更多语音播放的相关内容,可以阅读本专题下面的文章。

2024.03.01

924

5

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

120

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

100

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

60

26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 43.9万人学习

Java 教程
Java 教程

共578课时 | 189.8万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.5万人学习