Android自定义Toolbar代码创建时主题未生效问题排查

我之前也碰到过纯代码实现Toolbar+DrawerLayout时主题不生效的坑，尤其是自定义Toolbar的场景，文本和图标颜色总是不对。咱们一步步来排查解决：

你遇到的深色文本/图标问题，本质是自定义Toolbar没有正确关联到指定的主题上下文，或者布局结构缺失导致主题样式无法被正确应用。纯代码创建时不像XML布局会自动继承父布局的主题，得手动处理。

1. 初始化自定义Toolbar时传入主题包裹的上下文 #

直接用Activity的上下文会继承Activity的全局主题，咱们需要给Toolbar单独套一个ContextThemeWrapper，让它使用专门的Toolbar主题：

第一步：先在styles.xml定义Toolbar主题 #

<style name="ThemeOverlay.MyApp.Toolbar" parent="ThemeOverlay.MaterialComponents.Dark.ActionBar">
    <!-- 自定义Toolbar的文本、图标颜色 -->
    <item name="android:textColorPrimary">@color/white</item>
    <item name="colorOnPrimary">@color/white</item>
    <item name="actionMenuTextColor">@color/white</item>
    <item name="toolbarNavigationButtonStyle">@style/MyToolbarNavigationIcon</item>
</style>

<!-- 单独定义返回箭头的样式 -->
<style name="MyToolbarNavigationIcon" parent="Widget.MaterialComponents.Toolbar.Button.Navigation">
    <item name="tint">@color/white</item>
</style>

第二步：用主题上下文初始化自定义Toolbar #

// 用主题包裹上下文，确保Toolbar使用咱们定义的样式
val toolbarContext = ContextThemeWrapper(requireActivity(), R.style.ThemeOverlay_MyApp_Toolbar)
val customToolbar = CustomToolbar(toolbarContext)

2. 确保Toolbar被嵌套在AppBarLayout中 #

纯代码创建时，不能直接把Toolbar丢进DrawerLayout，必须先放到AppBarLayout里——它会负责Toolbar的样式继承、滚动行为等逻辑：

val drawerLayout = DrawerLayout(requireContext())
val appBarLayout = AppBarLayout(requireContext())

// 设置Toolbar的布局参数，让它填充AppBarLayout
customToolbar.layoutParams = AppBarLayout.LayoutParams(
    ViewGroup.LayoutParams.MATCH_PARENT,
    resources.getDimensionPixelSize(R.dimen.toolbar_height)
)

appBarLayout.addView(customToolbar)
// 把AppBarLayout作为DrawerLayout的第一个子View
drawerLayout.addView(appBarLayout)

// 后续添加内容布局、侧滑菜单...

3. 手动修复菜单图标/文本颜色（兜底方案） #

如果主题还是没生效，可以在代码里强制设置菜单的样式：

override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
    // 给MenuInflater也套上Toolbar主题，确保菜单样式正确
    val themedInflater = inflater.cloneInContext(ContextThemeWrapper(requireActivity(), R.style.ThemeOverlay_MyApp_Toolbar))
    themedInflater.inflate(R.menu.toolbar_menu, menu)

    // 遍历菜单设置图标颜色
    for (i in 0 until menu.size()) {
        val item = menu.getItem(i)
        item.icon?.setColorFilter(
            ContextCompat.getColor(requireContext(), R.color.white),
            PorterDuff.Mode.SRC_ATOP
        )
    }
    super.onCreateOptionsMenu(menu, inflater)
}

4. 检查自定义Toolbar的构造函数 #

确保你的自定义Toolbar构造函数正确处理了样式属性，不要硬编码覆盖主题样式：

class CustomToolbar @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = androidx.appcompat.R.attr.toolbarStyle // 必须指定Toolbar的默认样式属性
) : Toolbar(context, attrs, defStyleAttr) {
    init {
        // 这里不要硬设置setTextColor、setNavigationIcon之类的，让主题来控制
        // 只添加自定义的逻辑，比如设置默认标题等
    }
}

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