Android AndroidX的迁移

1. 前言

AndroidX replaces the original support library APIs with packages in the androidx namespace. Only the package and Maven artifact names changed; class, method, and field names did not change.，Google不再对android support库进行维护，android support中的API由命名空间AndroidX下的软件包进行替换，即相应的包名和Maven工件名发生改变。

2. 迁移AndroidX

2.1 迁移之前的准备

原有项目的support库版本升级至28(Android 9)，这也是support library的最后版本，SDK 28 和AndroidX 1.0 是等效的。This is because AndroidX artifacts with version 1.0.0 are binary equivalent to the Support Library 28.0.0 artifacts.，

compileSdkVersion 28

建议使用Android studio 3.2或更高版本，(当前最新版已经到了4.0)。

gradle-wrapper.properties中Gradle插件版本不低于4.6。

distributionUrl=https\://services.gradle.org/distributions/gradle-5.4.1-all.zip

如果代码在版本控制器中，建议在单独的分支中迁移。

2.2 执行迁移

在gradle.properties文件中添加下列项。

# Android 插件会使用对应的 AndroidX 库而非支持库。
android.useAndroidX=true
# Android 插件会通过重写现有第三方库的二进制文件，自动将这些库迁移为使用 AndroidX，但并不完全自动。
android.enableJetifier=true

如果是AS 3.2或更高版本，则提供了一键迁移，选择菜单Refactor-> Migrate to AndroidX，会提示备份当前工程，勾选Backup project as Zip file，可以自动帮你备份。

左下角提示，点击Do Refactor

3 迁移结果

在一键迁移之后，gradle文件中implementation的所有support库被androidx替换，比如

implementation 'com.android.support:appcompat-v7:28.0.0'
变为
implementation 'androidx.appcompat:appcompat:1.0.0'

相应类名也会发生改变

import android.support.v7.app.AppCompatActivity;
变为
import androidx.appcompat.app.AppCompatActivity;

所以，可以先看看上面两项结果，如果没有替换成功，可手动替换，相应替换可查阅官方提供的CSV格式的依赖库映射文件和类映射文件。

rebuild project，如果编译通过，那么恭喜你了，我反正是失败了。

4 迁移出错

4.1 可手动纠正的错

有的文件中没能替换掉，需要按照上述两项映射手动替换。

检查gradle中通过implementation引入的库，比如implementation androidx.recyclerview:recyclerview:1.0.0'，则一键迁移后导入的类为import androidx.appcompat.widget.RecyclerView;，需要替换为import androidx.recyclerview.widget.RecyclerView;，猜测只是全局替换掉support字样。因为类似还有GridLayoutManager、FragmentTransaction;`等。

4.2 第三方库冲突

support库和androidx是不能共存的，

  • 情况1 ：当迁移结束之后，理论上讲自己的项目使用的是androidx，但是老项目中导入了许多第三方的库，这些旧版本的库使用的是support。
  • 情况2：这种情况发生在未进行迁移的项目中，由于导入了最新版的第三方库，而该库使用了androidx，也会报错。

解决方法：

  • 情况1，更新第三方库到最新版本或使用androidx的版本，如果这个库没有使用androidx的版本，那就要找其他的方案代替吧（不知道是否是正确的解决方案）。
  • 情况2：使用旧版本的第三方库。

总之，就是多build，根据异常信息解决问题。

5 参考资料

AndroidX预览

官方迁移教程

谷歌开发者-是时候迁移至 AndroidX 了

到此这篇关于Android AndroidX的迁移的文章就介绍到这了,更多相关AndroidX迁移内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！

赞 (0)

相关推荐

  • Android项目迁移到AndroidX的方法步骤

    1. 写在前面 迁移前请确认所有代码都已提交至代码托管平台或已手动备份! 迁移前请确认所有代码都已提交至代码托管平台或已手动备份! 迁移前请确认所有代码都已提交至代码托管平台或已手动备份! 重要的事情说三遍! 2. 前提条件 将AS更新至 AS 3.2及以上,最好是3.5 Gradle 插件版本改为 4.6及以上,项目下gradle/wrapper/gradle-wrapper.propertie文件中的distributionUrl改为:distributionUrl= https://ser

  • Android AndroidX的迁移

    1. 前言 AndroidX replaces the original support library APIs with packages in the androidx namespace. Only the package and Maven artifact names changed; class, method, and field names did not change.,Google不再对android support库进行维护,android support中的API由命名

  • 详解Android Studio3.5及使用AndroidX的一些坑

    google的更新优化往往会牵动一大批开发者的心.去年的androidx,到今年studio3.5后都默认使用androidx了.其实对于我们开发者而言,我们都只是调用他的api,对我们的影响不大??!可是人性的习惯,还是比较不那么容易改变的.现在我就来说说我遇到的一些坑吧.话说还是很严重.不知道androidx的请自行百度. 一.我们从新建一个项目说. 3.5新建项目,是默认使用androidx的 看最后一样,Use androidx.* artifacts.而且不能取消掉的. 那么到我们项目

  • clipse项目迁移到android studio的方法(图文最新版)

    clipse项目迁移到android studio的方法(图文最新版)

    前言 最近Android studio(下文简称AS)官方发布了正式版,目前火得不行.个人认为主要是因为android是google自家的产品,AS也是他自己搞的IDE,以后的趋势android开发肯定会用AS,至于eclipse的adt插件是否继续更新就不可而知了.最近我也在android官网找了一下集成好的adt-bundle,但没有找到,可能是路径变了(搜索也没有找到)或者是真的为了支持AS就下架了.Github上现在也是一大堆的AS项目,所以这是个趋势啊. 之所以写本文是因为网上找的ec

  • Eclipse NDK迁移到Android Studio的方法示例

    最近看一个NDK项目,因为源码使用Eclipse IDE写的,想把代码导入Android Studio使用,毕竟好用很多,使用AS导入后,第一个问题就是编码问题,项目之前竟然使用的是GBK编码.首先就是改变编码问题.我先在设置中将项目编码改为UTF-8,build结果显示一堆错误的乱码,在网上逛了一圈,找到解决方案. 编码 将AS右下角的UTF-8换成GBK. 跳出提示选择"reload",此时注释之类的乱码会显示正确. 右下角再选择UTF-8 跳出提示选择"convert&

  • android项目从Eclipse迁移到Android studio中常见问题解决方法

    (1)将Eclipse项目导入到Android studio 中出现9-patch image问题解决方法: 在build.gradle里添加以下两句: aaptOptions.cruncherEnabled = false aaptOptions.useNewCruncher = false 用来关闭Android Studio的PNG合法性检查的,直接不让它检查. (2)Android Studio 错误: 非法字符: '\ufeff' 解决方案|错误: 需要class, interface

  • Android Studio项目适配AndroidX(Android 9.0)的方法步骤

    说在前面: 老项目.大项目适配Android X 注意了,一定要谨慎.谨慎.再谨慎.项目中用到的第三方库多的话会很麻烦,有些第三方库还没有适配Android X. 适配Android X的两种情况:一种是老项目适配Android X ,另外一种是新项目要求适配Android 9.0 硬核要求 Android studio 版本升级到3.2.0 以上的版本, distributionUrl的版本升级为 4.10.1以上 targetSdkVersion 28 gradle 插件的版本升级为 3.2

  • Android Studio 实现将support库改成Androidx

    方法一:在IDE中Refactor栏选择 Migrate to Androidx 这个操作会提醒我们备份数据 方法二:修改gradle.properties,加入一下两行 android.useAndroidX=true android.enableJetifier=true 如果你有包名命名不规范的现象存在,可能会出现转化错误,需要你手动修改不规范的包名 补充知识:解决Android Studio无法导入android.support.v4.app.Fragment 运行别人的项目的时候代码中

  • Android studio 禁用AndroidX方式

    gradle.properties文件中添加 android.useAndroidX=false #禁用AndroidX android.enableJetifier=false #禁止第三方jar包使用androidX 补充知识:解决Android Studio androidx 包冲突问题 如果包冲突了会包如下这样的错: Android dependency 'androidx.core:core' has different version for the compile (1.0.0)

  • Android 10 适配攻略小结

    相比较去年写的Android 9适配,这次Android 10的内容有点多.没想到写了我整整两天,吐血中... 准备工作 老规矩,首先将我们项目中的 targetSdkVersion 改为 29. 1.Scoped Storage(分区存储) 说明 在Android 10之前的版本上,我们在做文件的操作时都会申请存储空间的读写权限.但是这些权限完全被滥用,造成的问题就是手机的存储空间中充斥着大量不明作用的文件,并且应用卸载后它也没有删除掉.为了解决这个问题,Android 10 中引入了 Sco

随机推荐