Android -- AndroidX库

前言

今天在 Android Studio 上新建了个项目，引入 butterknife:10.0.0，运行后居然抛出了异常：

Manifest merger failed : Attribute application@appComponentFactory value=(android.support.v4.app.CoreComponentFactory) from [com.android.support:support-compat:28.0.0] AndroidManifest.xml:22:18-91
	is also present at [androidx.core:core:1.0.0] AndroidManifest.xml:22:18-86 value=(androidx.core.app.CoreComponentFactory).
	Suggestion: add 'tools:replace="android:appComponentFactory"' to <application> element at AndroidManifest.xml:5:5-19:19 to override.

按照日志提示
在 AndroidManifest.xml 中添加
tools:replace=“android:appComponentFactory”

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.example.testdemo1">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        tools:replace="android:appComponentFactory">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

运行后，仍抛出异常：

Manifest merger failed with multiple errors, see logs

显示 AndroidManifest.xml 文件里出错
查看 AndroidManifest.xml 文件里的 Merged Manifest：

折腾几番后，仍找不到解决方法，就直接上 butterknife 的 issue 上寻找答案。

发现 butterknife:10.0.0 已经不支持 support 老版库，如果需要使用，只能使用9.0.0这版。 butterknife:10.0.0 只支持新的 AndroidX 库。

ButterKnife的github地址
Github: https://github.com/JakeWharton/butterknife

1. AndroidX库

Google 2018 IO 大会推出了 Android 新的扩展库 AndroidX，用于替换原来的 Android support 扩展库，将原来的 android.替换成 androidx.；只有包名和 Maven 工件名受到影响，原来的类名，方法名和字段名不会更改。

1.1 AndroidX变化

1、常用依赖库对比

Old build artifact	AndroidX build artifact
com.android.support:appcompat-v7:28.0.2	androidx.appcompat:appcompat:1.0.0
com.android.support:design:28.0.2	com.google.android.material:material:1.0.0
com.android.support:support-v4:28.0.2	androidx.legacy:legacy-support-v4:1.0.0
com.android.support:recyclerview-v7:28.0.2	androidx.recyclerview:recyclerview:1.0.0
com.android.support.constraint:constraint-layout:1.1.2	androidx.constraintlayout:constraintlayout:1.1.2

2、常用支持库类对比

Support Library class	AndroidX class
android.support.v4.app.Fragment	androidx.fragment.app.Fragment
android.support.v4.app.FragmentActivity	androidx.fragment.app.FragmentActivity
android.support.v7.app.AppCompatActivity	androidx.appcompat.app.AppCompatActivity
android.support.v7.app.ActionBar	androidx.appcompat.app.ActionBar
android.support.v7.widget.RecyclerView	androidx.recyclerview.widget.RecyclerView

更多详细变化内容，可查看官方文档

AndroidX了解一下

2. 解决第三方库只支持 AndroidX 库问题

2.1 方法一：将项目的 support 库统一转换成 AndroidX 库

1、AS 更新升级配置

• 将 AS 更新至 AS 3.2 及以上
• Gradle 插件版本改为 4.6 及以上，gradle 版本至少为3.2.0以上
  
  
• compileSdkVersion 版本升级到 28及以上
  
• buildToolsVersion 版本改为 28.0.2及以上

2、开始迁移AndroidX

方法一：一键迁移AndroidX库

在 AS 3.2 Canary 中添加了一键迁移的功能，Refactor -> Migrate to AndroidX 。

选择Migrate

选择要转换的项目

选择需要转换为 AndroidX 包的库，点击 Do Refactor

方法二：配置 gradle.properties 迁移AndroidX库

除了 Do Refactor 方法外，还可以通过配置 gradle.properties 引入 AndroidX 库。

android.useAndroidX=true
android.enableJetifier=true

其中：

• android.useAndroidX=true 表示当前项目启用 AndroidX
• android.enableJetifier=true 表示将依赖包也迁移到 AndroidX 。如果取值为 false ,表示不迁移依赖包到 AndroidX，但在使用依赖包中的内容时可能会出现问题。当然了，如果你的项目中没有使用任何三方依赖，那么，此项可以设置为false

在使用 android.enableJetifier=false 时，需要注意：
引入某些第三方的最新库时，如 butterknife:10.0.0，是只支持新的 AndroidX 库，所以要将整个项目的依赖都转换为 AndroidX，否则编译就会报错。

3、对比 Android support 库和 AndroidX 库

转换前和转换后类库对比
Android support 库

AndroidX 库

4、androidx.constraintlayout.widget.ConstraintLayou 异常

当将所有库的依赖都转换为 AndroidX 后，运行项目，居然抛出 androidx.constraintlayout.widget.ConstraintLayout 的错误：

附上 build.gradle 文件和布局 xml 文件
build.gradle

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
    implementation 'androidx.appcompat:appcompat:1.0.0-beta01'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.2'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test:runner:1.1.0-alpha4'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.0-alpha4'
}

布局 xml 文件

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

所有的 support 库都已改成 AndroidX 了，而且布局中 ConstraintLayout 控件的引入也改成了 androidx，为什么还会抛出 Error inflating class androidx.constraintlayout.widget.ConstraintLayout 异常？？

解法：
原来是 androidx.constraintlayout:constraintlayout:1.1.2 中的一个bug，将

implementation 'androidx.constraintlayout:constraintlayout:1.1.2'

改成

implementation 'androidx.constraintlayout:constraintlayout:1.1.3'

编译后，即可成功运行出来。

2.2 方法二：降低第三方库的版本，使其兼容 Android support 库

使用第三方依赖库时，如果最新版本适配的是 AndroidX 库，可降低第三方的库的版本。
如 butterknife，从 butterknife 的 issue 上可知，butterknife:9.0.0 是适配 Android support 库的，如果你的项目仍想使用 Android support 老库，引入 butterknife:9.0.0 即可。

PS：

依赖库的时候，尽量不要使用 latest.release，而使用具体的版本。
原因：

1. 不会因为依赖库更新，引起兼容问题
2. 减少每次去检查最新版本，可以节省编译时间

3. 引入 butterknife:10.0.0

在整个项目转换为 AndroidX 库后，引入 butterknife:10.0.0
在 build.gradle 里添加 butterknife:10.0.0

android {
    compileSdkVersion 28
    defaultConfig {
        applicationId "com.example.testdemo1"
        minSdkVersion 16
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

        //AndroidStudio 3.0 canary 8 Annotation processors must be exp
        //添加部分
        javaCompileOptions {
            annotationProcessorOptions {
                includeCompileClasspath true
            }
        }
    }
   .......
}

dependencies {
   ......
    implementation 'com.jakewharton:butterknife:10.0.0'
    implementation 'com.jakewharton:butterknife-compiler:10.0.0'
}

添加后，运行，抛出异常：

Error: Static interface methods are only supported starting with Android N (--min-api 24): void butterknife.Unbinder.lambda$static$0()

原因分析： java8才支持静态接口方法，Android N 要求 jdk 版本为1.8
解决方案：定义和调用静态接口方法的 module 编译时都使用 jdk1.8 即可

原来 butterknife:10.0.0 需要指定 java的 jdk 版本
在 app 的 build.gradle 中添加如下：

android {
     ......
    // 指定jdk版本
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

编译后，即可成功运行出来。

4. 总结

AndroidX 虽然目前对我们没有多大的影响，我们可以不使用它，仍然使用旧版本支持库，毕竟没有强制，但从长远来看还是有好处的。AndroidX 重新设计了包结构，旨在鼓励库的小型化，支持库和架构组件包的名字也都简化了，而且也是减轻Android生态系统碎片化的有效方式。之后Android 的一些新的特性，也都会被写在 AndroidX 库中。

5. 附

如果在老版本转换到 AndroidX 的过程中遇到 Program type already present 报错，可参考这个连接，使用androidx时Program type already present报错的一种解决尝试