最近在项目开发中遇到AndroidX兼容性问题,如下图
BUILD FAILED in 15s
*******************************************************************************************
The Gradle failure may have been because of AndroidX incompatibilities in this Flutter app.
See https://goo.gl/CP92wY for more information on the problem and how to fix it.
*******************************************************************************************
Gradle task assembleDebug failed with exit code 1
Exited (sigterm)
具体来说就是项目中同时用到了AndroidX包和Support包,而这两种包只能存在一个,要么全部引用AndroidX包,要么全部引用Support包。
一.AndroidX是什么
根据官方文档,AndroidX 是对 android.support.xxx 包的整理后产物。由于之前的support包过于混乱,所以,google推出了 AndroidX。由于在后续版本中,会逐步放弃对support 的升级和维护,所以,我们的项目后续得逐步迁移到 AndroidX.
当然,官方博客中也有说道,为了给开发者一定迁移的时间,28.0.0的稳定版本还是采用android.support,但是所有后续的功能版本都将采用androidx。
二.解决冲突
解决AndroidX包冲突有两种方式:
- 全部引用AndroidX包
- 全部引用Support包
首先我们来讲讲转AndroidX包的方法,这里官方提供了两种方法,一种是自动转(官方推荐),一种是手动转(麻烦,容易出错)。
使用Android Studio自动升级AndroidX包
Flutter中,首先确保Android Studio版本是最新版,或者至少3.2以上。然后在我们在项目上右键选择.android文件件,Flutter -> Open Android module in Android Studio
在新建的Android Studio窗口中选择Refactor -> Migrate to AndroidX
在接下来的步骤中点击Do Refactor按钮即可完成AndroidX的迁移工作。
手动升级AndroidX
1)打开android/gradle/wrapper/gradle-wrapper.properties,修改distributionUrl的值,
distributionUrl=https\://services.gradle.org/distributions/gradle-4.10.2-all.zip
2)打开android/build.gradle,修改com.android.tools.build:gradle 到3.3.0
dependencies {
classpath 'com.android.tools.build:gradle:3.3.0'
}
3)打开android/gradle.properties,添加两行
android.enableJetifier=true
android.useAndroidX=true
4)打开android/app/build.gradle,在android{}里面,确保compileSdkVersion 和 targetSdkVersion 值为28,
替换所有过时的依赖库android.support到androidx。
不升级AndroidX包,全部引用Support包
这种方式也就是将项目中用到AndroidX包的地方全部转为引用Support包。在Flutter中,有些第三方库在最近一段时间陆续都改为支持AndroidX包,而我们项目中需要全部只支持Support包,就必须将第三方库的版本号改为其转AndroidX前的最后一个版本号。
参考Flutter官方文档上对AndoridX迁移的工作:https://flutter.dev/docs/development/packages-and-plugins/androidx-compatibility
这些是flutter/plugins AndroidX之前的所有软件包的最新可用版本:
android_intent:0.2.1
battery:0.3.0
camera:0.2.9 + 1
cloud_firestore:0.8.2 + 3
cloud_functions:0.0.5
connectivity:0.3.2
device_info:0.3.0
firebase_admob:0.7.0
firebase_analytics:1.1.0
firebase_auth:0.7.0
firebase_core:0.2.5 + 1
firebase_database:1.0.5
firebase_dynamic_links:0.1.1
firebase_messaging:2.1.0
firebase_ml_vision:0.2.1
firebase_performance:0.0.8 + 1
firebase_remote_config:0.0.6 + 1
firebase_storage:1.0.4
google_maps_flutter:0.1.0
google_sign_in:3.2.4
image_picker:0.4.12 + 1
local_auth:0.3.1
package_info:0.3.2 + 1
path_provider:0.4.1
quick_actions:0.2.2
sensors:0.3.5
share:0.5.3
shared_preferences:0.4.3
url_launcher:4.1.0 + 1
video_player:0.9.0
webview_flutter:0.2.0
总结
Android在后续版本中,会逐步放弃对support 的升级和维护,所有项目转到AndroidX是大势所趋。但目前很多第三方库还没升级到AndroidX,如果项目中用到的第三方库有的升级了,有的没升级,而没升级的第三方库也必须要用到,为了避免出现AndroidX兼容性问题,我们就得看看项目中用到的已经升级到AndroidX的第三方库在升级前的最后一个版本号是多少,然后将引入的版本号改为对应的版本号就可以了。