React Native中如何在应用被杀死或后台状态下检测联系人更新？

实现核心逻辑 #

分平台原生侧事件监听 #

系统联系人变更的事件只能通过原生层系统接口监听，RN层无法直接感知后台/进程杀死状态的系统事件，需要按平台做原生适配：

• 安卓端：
  系统联系人变更时会发出android.intent.action.CONTENT_CHANGED系统广播，你需要在原生层静态注册BroadcastReceiver监听该广播，静态注册的广播不受应用进程状态影响，就算应用被杀死也能接收到对应广播。接收到广播后可以通过WorkManager触发后台同步任务，无需拉起应用前台页面。
  注意需要在AndroidManifest.xml中添加权限和广播配置：

  <!-- 联系人读取权限 -->
  <uses-permission android:name="android.permission.READ_CONTACTS" />
  <!-- 开机自启动权限，保证重启后广播依然生效 -->
  <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
  <!-- 广播注册配置 -->
  <receiver android:name=".ContactsChangeReceiver" android:exported="true">
    <intent-filter>
      <action android:name="android.intent.action.CONTENT_CHANGED" />
      <data android:scheme="content" android:host="com.android.contacts" />
    </intent-filter>
  </receiver>
  

• iOS端：
  系统提供CNContactStoreDidChange通知，在原生层注册该通知的全局观察者，应用处于后台挂起状态时可以正常收到该通知，收到通知后申请30s后台任务权限，即可执行同步逻辑。如果应用被用户手动划杀，iOS不允许接收该类通知，该场景下可以在应用每次冷启动时先做一次增量同步补全数据。

变更快速识别逻辑 #

你已经存储了全量联系人到本地SQLite，可以用增量同步的方式快速识别变更，不需要每次全量对比：

• 本地SQLite新增字段存储最后一次同步的时间戳last_sync_time
• 每次收到变更通知/应用启动时，只拉取系统联系人中修改时间大于last_sync_time的条目：安卓联系人的修改时间字段为ContactsContract.Contacts.CONTACT_LAST_UPDATED_TIMESTAMP，iOS的CNContact对象自带modificationDate属性
• 将拉取到的变更条目和本地数据库数据做对比，即可快速筛选出新增、修改、删除的记录，同步完成后更新last_sync_time的值
• 可选兜底逻辑：每7天做一次全量联系人对比校准，避免用户修改系统时间导致增量同步漏更

现有RN插件适配方案 #

如果不想从零写原生代码，可以基于成熟插件二次改造：

• 联系人基础读写能力用react-native-contacts插件封装好的接口即可，不需要自己封装原生联系人读写逻辑
• 后台任务调度可以用react-native-workmanager（安卓）/react-native-background-task（iOS），原生侧收到变更通知后调用对应插件的接口触发RN层的同步逻辑

高版本系统适配注意事项 #

• 安卓12+对后台广播和任务做了严格限制，需要引导用户手动给应用开启自启动、后台活动权限，避免广播被系统拦截
• iOS13+需要在Info.plist中申请NSContactsUsageDescription权限描述，同时开启后台刷新权限才能在后台接收联系人变更通知

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