Android Studio 4.1 Kotlin开发:BottomNavigationView的setItemIconTintList()不可用,需设图标tint为null
问题根因
出现方法无法调用的核心原因是Google Material组件库的版本不匹配:setItemIconTintList()方法是从Material组件库1.4.0版本开始才正式公开提供的API,低于这个版本的依赖中,该方法属于隐藏API,无法直接在代码中调用,自然会报方法不可用的错误。
可落地的解决方案
方案1:升级Material组件库(最推荐)
这是最稳定无兼容问题的实现方式:
- 打开app模块下的
build.gradle (Module : app)文件,找到dependencies块中的Material依赖项 - 将原有依赖调整为1.4.0及以上的稳定版本,示例写法:
implementation 'com.google.android.material:material:1.9.0' - 修改完成后点击Gradle同步按钮等待依赖加载完成,此时即可在现有代码的基础上直接将图标tint置空,Kotlin写法示例:
navView.itemIconTintList = null
说明:Kotlin环境下可以直接通过属性语法调用set方法,无需手动书写
setItemIconTintList()的全方法名。
方案2:XML布局直接配置(无需改依赖版本)
如果项目因为兼容问题无法升级Material库,可以直接在布局文件中完成配置,不需要在代码中调用任何方法:
- 找到布局文件中的
BottomNavigationView节点 - 添加app命名空间下的属性:
app:itemIconTint="@null" - 重新运行项目即可看到图标不再被默认的主题色tint染色。
注意:该属性必须使用
app:命名空间,不能用android:前缀,否则会出现属性识别失败的问题。
方案3:反射兜底(仅特殊场景使用)
如果需要在代码中动态修改、且无法升级依赖、也不适合改布局的场景,可以通过反射修改组件内部的tint参数,参考代码:
try { val tintField = BottomNavigationView::class.java.getDeclaredField("itemIconTintList") tintField.isAccessible = true tintField.set(navView, null) } catch (e: Exception) { e.printStackTrace() }
注意:反射实现依赖组件内部的字段定义,不同版本的Material库内部字段名可能存在差异,稳定性较弱,仅作为兜底方案使用。
内容的提问来源于stack exchange,提问作者Sabarinath
相关产品推荐
相关产品推荐

