Android10小米设备Compose组件深色模式文本颜色异常及ForceDarkAllowed问题

问题背景 #

我在部分Android 10小米设备上遇到深色模式下文本颜色异常问题：组件为带文本的可点击Box，选中时文本应为黑色、背景为白色，反之亦然，颜色已直接指定，且应用使用自定义配色方案与主题（非Material主题）。
注：我有5台Android10+小米设备，仅一台出现选中项文本颜色异常——浅色背景上文本为白色（应为黑色），且无法提供该组件代码。
附：将组件放入带shadowElevation的Surface内可临时修复，但用户交互后异常复现。

咨询问题 #

1. 如何在不全局禁用ForceDarkAllowed、不新增主题的前提下修复该问题？（全局方案不可行）
2. 能否仅为特定Compose组件（非Android View）设置ForceDarkAllowed？
3. 是否有其他修复方式？
4. 若仅能全局禁用ForceDarkAllowed，想了解非小米设备该属性的默认值，以及全局修改后可能遇到的问题？

解决方案与解答 #

问题1：局部修复（不全局禁用/新增主题） #

• 直接为Text组件硬编码指定颜色，不要依赖主题动态颜色。比如选中状态设color = Color.Black，未选中设Color.White，彻底避免系统颜色反转干扰。
• 通过Modifier.semantics为目标Box绑定View级属性，局部关闭强制深色适配：

  Box(
      modifier = Modifier
          .clickable { /* 点击逻辑 */ }
          .semantics {
              this[androidx.compose.ui.semantics.ViewSemanticsAttrs.ViewAttrs] = 
                  mapOf(android.R.attr.forceDarkAllowed to false)
          }
  ) {
      Text(text = "目标文本", color = if (selected) Color.Black else Color.White)
  }
  

问题2：为特定Compose组件设置ForceDarkAllowed #

Compose没有直接的专属API，但可以通过上述semantics绑定View属性的方式间接实现——本质是给组件对应的底层View添加forceDarkAllowed属性，达到局部控制强制深色适配的效果。

问题3：其他修复方式 #

• 给Box设置明确的背景色，不要留透明或依赖父组件背景。比如选中时设background = Color.White，未选中设深色背景，让系统能正确识别背景色调，避免错误反转文本。
• 避免使用alpha调整文本/背景透明度，部分小米设备的强制深色逻辑对透明元素的颜色处理存在异常。
• 手动判断系统强制深色状态，动态锁定文本颜色：

  val context = LocalContext.current
  val isForceDarkEnabled = context.resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK == Configuration.UI_MODE_NIGHT_YES
  Text(
      text = "目标文本",
      color = if (selected && isForceDarkEnabled) Color.Black else if (selected) Color.Black else Color.White
  )
  

问题4：全局禁用的影响与默认值 #

• 非小米设备默认值：原生Android（如Pixel）及多数品牌设备中，ForceDarkAllowed默认值为true，允许系统对未适配深色模式的应用做强制颜色反转，但逻辑更规范，不会随意修改已明确指定颜色的组件。
• 全局禁用后的问题：
  • 应用内未适配深色模式的老旧View、第三方库组件，将无法获得系统强制深色适配效果，可能出现浅色背景+浅色文本的异常。
  • 依赖系统强制深色的自定义组件，颜色适配会失效，需确保所有组件的深色模式逻辑完全手动实现。

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