Android后台检测系统主题（深色/浅色）变更方案咨询

为什么ACTION_CONFIGURATION_CHANGED后台不生效 #

从Android 8.0（API 26）开始，系统对隐式广播实施严格限制，Intent.ACTION_CONFIGURATION_CHANGED属于后台受限的隐式广播范畴：静态注册的BroadcastReceiver无法在后台接收该广播，动态注册的Receiver会随应用进程被杀而失效，因此这个方案无法满足后台检测的需求。

WorkManager + ContentUriTrigger不可行的原因 #

系统主题的配置信息并未暴露可监听的Content URI，addContentUriTrigger没有对应的主题相关URI可以绑定，所以这条路走不通。

可行的实现方案 #

1. 使用JobScheduler监听配置变更 #

JobScheduler支持设置系统配置变化的触发条件，即使应用未运行也能触发任务，是后台检测的可靠方案：

val jobInfo = JobInfo.Builder(1001, ComponentName(context, ThemeChangeJobService::class.java))
    .setRequiresDeviceIdle(false)
    .setRequiresCharging(false)
    .addTriggerContentUri(
        JobInfo.TriggerContentUri(
            Settings.System.getUriFor(Settings.System.UI_NIGHT_MODE),
            JobInfo.TriggerContentUri.FLAG_NOTIFY_FOR_DESCENDANTS
        )
    )
    .build()

val jobScheduler = context.getSystemService(Context.JOB_SCHEDULER_SERVICE) as JobScheduler
jobScheduler.schedule(jobInfo)

对应的JobService实现：

class ThemeChangeJobService : JobService() {
    override fun onStartJob(params: JobParameters): Boolean {
        // 获取当前主题模式
        val nightMode = Settings.System.getInt(
            contentResolver,
            Settings.System.UI_NIGHT_MODE,
            Settings.System.UI_NIGHT_MODE_NO
        )
        when(nightMode) {
            Settings.System.UI_NIGHT_MODE_YES -> // 处理深色模式逻辑
            Settings.System.UI_NIGHT_MODE_NO -> // 处理浅色模式逻辑
            Settings.System.UI_NIGHT_MODE_AUTO -> // 处理自动模式逻辑
        }
        // 任务完成返回false；若需后台持续执行则返回true，后续调用jobFinished结束任务
        return false
    }

    override fun onStopJob(params: JobParameters): Boolean {
        // 任务被系统中断时返回true，表示需要重新调度
        return true
    }
}

需在Manifest中注册JobService：

<service
    android:name=".ThemeChangeJobService"
    android:permission="android.permission.BIND_JOB_SERVICE" />

2. ContentObserver监听（适用于进程存活场景） #

如果应用进程偶尔能保持存活，可以注册ContentObserver监听Settings.System.UI_NIGHT_MODE的变化，但进程被杀后监听会失效，适合轻量后台场景：

class ThemeChangeObserver(private val handler: Handler) : ContentObserver(handler) {
    override fun onChange(selfChange: Boolean, uri: Uri?) {
        super.onChange(selfChange, uri)
        if (uri == Settings.System.getUriFor(Settings.System.UI_NIGHT_MODE)) {
            // 处理主题变更逻辑
        }
    }
}

// 在合适的时机注册监听
contentResolver.registerContentObserver(
    Settings.System.getUriFor(Settings.System.UI_NIGHT_MODE),
    true,
    ThemeChangeObserver(Handler(Looper.getMainLooper()))
)

注意事项 #

• JobScheduler仅在API 21及以上可用，若需兼容更低版本，可通过WorkManager封装的JobScheduler/AlarmManager实现，但WorkManager本身没有直接监听主题变更的API，需结合上述JobScheduler逻辑自定义Worker。
• 无论采用哪种方案，都需注意系统电池优化策略，可能需要引导用户将应用加入电池白名单，避免任务被系统强制终止。

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