android.support.design库的引用和冲突解决

转 https://www.jianshu.com/p/2a0a2af9f2b4

最近在工程中使用到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为例.

<android.support.design.widget.FloatingActionButton
            android: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了，如图：

float_button.jpg

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/ButtonTheme</item>
    </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 <init>(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.<init>(FloatingActionButton.java:133)
                                                     at android.support.design.widget.FloatingActionButton.<init>(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为例，其它的依赖冲突同理。

然后就，项目运行起来啦~