API 21环境下Bottom-bar膨胀异常问题求助

你遇到的情况很典型——第三方UI组件在低版本Android系统上的兼容性坑。既然移除bottom-bar后异常消失，而且API24上一切正常，基本可以确定是这个组件没做好API21的适配。下面给你几个针对性的解决思路：

• 检查bottom-bar依赖的版本兼容性
  先看你用的bottom-bar库的最低支持SDK版本。比如有些热门的第三方bottom-bar库（比如com.roughike:bottom-bar），后期版本可能把minSdk提高到了24，导致API21直接跑不起来。你可以降级到明确支持API21的版本，比如2.3.1版本（这个版本支持API14+）。修改Module级别的build.gradle里的依赖：

  implementation 'com.roughike:bottom-bar:2.3.1'
  

• 排查Tabs配置XML的兼容性问题
  你提供的tabs XML没写完，但要注意有没有用到API24及以上才支持的属性。比如：

  • android:fontFamily的某些系统字体，API21不支持；
  • 矢量图资源没有开启兼容；
  • 某些自定义属性在低版本系统无法解析。
    解决办法：
  • 把android:fontFamily换成库提供的app:fontFamily（如果支持的话），或者用兼容的字体文件；
  • 在Module的build.gradle的android块里添加矢量图兼容配置：

    android {
      defaultConfig {
        vectorDrawables.useSupportLibrary = true
      }
    }
    

• 确认Activity的主题与继承关系
  API21对AppCompat主题的依赖更严格，如果你用的是原生的Activity而非AppCompatActivity，或者主题不是Theme.AppCompat系列，可能会导致bottom-bar初始化失败。确保：

  • 你的Activity继承AppCompatActivity；
  • 主题设置为Theme.AppCompat.Light.NoActionBar这类AppCompat主题（在AndroidManifest.xml或者styles.xml中配置）。

• 一定要看崩溃日志！
  你说“无代码错误”，但崩溃时的Stack Trace是定位问题的关键。比如如果是java.lang.NoSuchMethodError，说明组件调用了API24才有的方法；如果是XmlPullParserException，就是XML里有不兼容的属性。打开Android Studio的Logcat，过滤你的包名，找到崩溃时的报错信息，能精准解决问题。

• 替代方案：改用原生BottomNavigationView
  如果第三方组件的适配实在搞不定，建议换成AndroidX提供的原生BottomNavigationView，它天然支持API21+，稳定性拉满。只需要依赖com.google.android.material:material库，然后用menu文件定义tabs，配置起来也很简单。

内容的提问来源于stack exchange，提问作者Hatay Berkay Işıkoğlu