android.support.design库的引用和冲突解决
最近在工程中使用到android.support.design库里的一些控件,在导入、编译、运行的时候踩到了一些坑,在这里大概总结下,以成前车之鉴。
1.design库的引入
在application或者library的build.gradle文件的dependencies加入compile'com.android.support:design:26.1.0' 。这里的版本号26.1.0,要和项目中“com.android.support:appcompat-v7”的版本号保持一致。
2.design控件使用
design库引入之后,就可以在xml文件和java文件里面使用design控件,这里以FloatingActionButton为例.
id="@+id/btn_float"
android:layout_width="45dp"
android:layout_height="45dp"
android:layout_alignParentBottom="true" android:layout_alignParentEnd="true" android:layout_margin="16dp" android:src="@drawable/ic_add" app:backgroundTint="#2d7ad0" />
注意:当使用到控件特有属性的时候,如backgroundTint的时候,要使用自定义的xmlns,xmlns:app="http://schemas.android.com/apk/res-auto"。
在完成如上两步之后,在自己的demo里面,就可以显示该button了,如图:
3.design库排雷过程
3.1 theme主题导致控件不可用
然鹅,在项目工程中使用的时候,可以正常编译,但是运行的时候崩溃,报错日志如下:
E/AndroidRuntime: FATAL EXCEPTION: main
Process: com.guazi.android.expert, PID: 1390
android.view.InflateException: Binary XML file line #325: Binary XML file line #325: Error inflating class android.support.design.widget.FloatingActionButton
Caused by: android.view.InflateException: Binary XML file line #325: Error inflating class android.support.design.widget.FloatingActionButton Caused by: java.lang.reflect.InvocationTargetException Caused by: java.lang.IllegalArgumentException: You need to use a Theme.AppCompat theme (or descendant) with the design library. at android.support.design.widget.ThemeUtils.checkAppCompatTheme(ThemeUtils.java:33) at android.support.design.widget.FloatingActionButton.<init>(FloatingActionButton.java:157)
这一段报错日志很简单,从最后给出的建议就可以得出结论,使用到design控件的activity必须使用Theme.AppCompat的主题。在style文件里定义parent为AppCompat的主题:
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar"> <item name="android:buttonStyle">@style/ButtonThemeitem> style> <style name="ButtonTheme" parent="@style/Widget.AppCompat.Button.Borderless">style>
然后在AndroidManifest文件里改变activity或者application主题即可。
3.2 不同库之间的冲突问题
改完theme,满心欢喜,以为终于可以在项目里使用design控件了,然后编译,运行,到了程序中再一次crash。。。
这时的日志是这样的:
E/AndroidRuntime: FATAL EXCEPTION: main
Process: com.guazi.android.expert, PID: 1390 android.view.InflateException: Binary XML file line #325: Binary XML file line #325: Error inflating class android.support.design.widget.FloatingActionButton Caused by: android.view.InflateException: Binary XML file line #325: Error inflating class android.support.design.widget.FloatingActionButton Caused by: java.lang.reflect.InvocationTargetException Caused by: java.lang.NoSuchMethodError: No direct method (Landroid/widget/ImageView;Landroid/support/v7/widget/AppCompatDrawableManager;)V in class Landroid/support/v7/widget/AppCompatImageHelper; or its super classes (declaration of 'android.support.v7.widget.AppCompatImageHelper' appears in /data/app/com.guazi.android.expert-1/base.apk:classes38.dex) at android.support.design.widget.FloatingActionButton.(FloatingActionButton.java:133) at android.support.design.widget.FloatingActionButton.(FloatingActionButton.java:110)
这一次的日志看起来不太好分析,No direct method等等一大坨,这时就分析项目工程和自己的demo到底还有哪里不一样呢?经过仔细排查,发现项目工程里面多引入了一个
compile 'com.androidkun:XTabLayout:1.1.3'
这个开源组件是依赖于com.android.support:design库的,进入FloatingActionButton的类发现,External Libraries里design库的版本是23.4.0,而我们项目中appcompat-v7的版本是26.1.0,这就和我们第一点提示的有冲突了。但是这个com.android.support:design库是我们使用的XTabLayout自动引入的啊,我们要做的就是不使用它自动引入的design库,而是使用我们 想要的、 版本和appcompat-v7一致的design库。
针对这种情况,我们在gradle里如下配置:
compile ('com.androidkun:XTabLayout:1.1.3') {
transitive = false
}
compile 'com.android.support:design:26.1.0'
transitive字段为false代表项目不会自动引入该库所依赖的父库,若项目使用到父库,则自行引入。这里以XTabLayout和android.support.design为例,其它的依赖冲突同理。
然后就,项目运行起来啦~