如何开发可修改Android系统全局深色/夜间模式设置的应用

核心结论 #

普通第三方应用无法在未获得系统特殊权限的前提下修改全局系统深色模式，你遇到的调用不生效问题是Android系统的权限限制导致的。

失效原因 #

• 权限级别不足：你在清单中声明的CHANGE_CONFIGURATION权限属于系统签名级权限，普通第三方应用即使动态申请也无法获得完整权限，仅能修改应用内配置，无法触发系统级修改。WRITE_SETTINGS权限仅支持修改Settings.System公开表中的配置项，而全局深色模式的配置存放在Settings.Secure非公开表中，该权限不满足修改要求。
• 参数匹配错误：你代码中传入setNightMode的参数是AppCompatDelegate的常量值，和UiModeManager要求的常量虽数值相同，但应用内配置和系统配置的逻辑有差异，不过这不是核心失效原因。
• 版本兼容问题：原生Android 9没有官方全局深色模式开关，你测试的三星S8的深色模式是厂商自定义实现，没有适配原生UiModeManager接口，因此调用无效。

可行实现方案 #

• 无障碍权限适配：如果是自用或者小范围使用的应用，可以申请无障碍权限，通过模拟点击系统设置页的深色模式开关实现全局切换，需要针对不同厂商的系统UI做适配，不需要root权限。
• Root设备修改配置：root后的设备可以直接修改Settings数据库的对应字段实现切换，参考命令：

# 切换深色模式
content update --uri content://settings/secure --bind value:i:2 --where "name='ui_night_mode'"
# 切换浅色模式
content update --uri content://settings/secure --bind value:i:1 --where "name='ui_night_mode'"
# 切换自动模式
content update --uri content://settings/secure --bind value:i:0 --where "name='ui_night_mode'"

• 引导用户手动切换：如果是上架应用，只能引导用户跳转到系统显示设置页手动修改，跳转代码参考：

Intent intent = new Intent(Settings.ACTION_DISPLAY_SETTINGS);
startActivity(intent);

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