Android 快速迁移到Android X

╰+哭是因爲堅強的太久メ 2023-10-10 10:36 41阅读 0赞

越来越多的第三方库新版本开始只支持Android X，为了支持新特性，需要将项目迁移至Android X。经历三个公司项目Android X项目的迁移，感觉Android studio 自带的 `Refactor > Migrate to AndroidX`只会查找出所有需要替换的代码，具体的替换还是需要自己一个一个替换，过于繁琐。可以使用全局替换进行迁移，相对还是比较简单的，现对此进行总结。

#### 1.配置启用Android X ####

在Android Studio3.2及以上版本，将gradle.properties添加以下配置

#启用Android X
    android.useAndroidX=true 
    #迁移未使用任何第三方库但带有需要转换的依赖项的现有项目
    android.enableJetifier=true

#### 2.将旧的引用改为新引用 ####

具体详见[官方文档][Link 1]

##### 3.替换如下配置 #####

Android Studio有全局替换的功能，`shift+ctrl+R`  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V0aGFuQ28_size_16_color_FFFFFF_t_70]  
下面将常见的一些替换列举出来  
需将如下代码替换为 `->`后的代码，注意**代码、布局文件、Manifest都要进行替换**

//注解
    android.support.annotation.Nullable
    ->
    androidx.annotation.Nullable
    
    android.support.annotation.NonNull
    ->
    androidx.annotation.NonNull
    
    android.support.annotation.DrawableRes
    ->
    androidx.annotation.DrawableRes
    
    android.support.annotation.IntDef
    ->
    androidx.annotation.IntDef
    
    android.support.annotation.StringDef
    ->
    androidx.annotation.StringDef
    
    android.support.annotation.CallSuper
    ->
    androidx.annotation.CallSuper
    
    android.support.annotation.IdRes
    ->
    androidx.annotation.IdRes
    
    android.support.annotation.LayoutRes
    ->
    androidx.annotation.LayoutRes
    
    android.support.annotation.ColorRes
    ->
    androidx.annotation.ColorRes
    
    android.support.annotation.ColorInt
    ->
    androidx.annotation.ColorInt
    
    //控件
    android.support.v4.app.FragmentActivity
    ->
    androidx.fragment.app.FragmentActivity
    
    android.support.v4.app.Fragment
    ->
    androidx.fragment.app.Fragment
    
    android.support.v4.view.PagerAdapter
    ->
    androidx.viewpager.widget.PagerAdapter
    
    android.support.v4.view.ViewPager
    ->
    androidx.viewpager.widget.ViewPager
    
    android.support.v4.app.ActivityCompat
    ->
    androidx.appcompat.app.AppCompatActivity
    
    android.support.v4.content.ContextCompat
    ->
    androidx.core.content.ContextCompat
    
    android.support.v7.widget.RecyclerView
    ->
    androidx.recyclerview.widget.RecyclerView
    
    android.support.v7.widget.AppCompatImageView
    ->
    androidx.appcompat.widget.AppCompatImageView
    
    android.support.v4.widget.NestedScrollView
    ->
    androidx.core.widget.NestedScrollView
    
    android.support.v4.view.ViewCompat
    ->
    androidx.core.view.ViewCompat
    
    android.support.v7.widget.CardView
    ->
    androidx.cardview.widget.CardView
    
    android.support.v4.content.FileProvider
    ->
    androidx.core.content.FileProvider
    
    android.support.constraint.ConstraintLayout
    ->
    androidx.constraintlayout.widget.ConstraintLayout
    
    android.support.constraint
    ->
    androidx.constraintlayout.widget.Guideline
    
    android.support.v7.widget.SwitchCompat
    ->
    androidx.appcompat.widget.SwitchCompat
    
    android.support.design.widget.CoordinatorLayout
    ->
    androidx.coordinatorlayout.widget.CoordinatorLayout
    
    android.support.v7.widget.Toolbar
    ->
    androidx.appcompat.widget.Toolbar
    
    android.arch.lifecycle.MutableLiveData
    ->
    androidx.lifecycle.MutableLiveData
    
    android.support.v7.app.AppCompatActivity
    ->
    androidx.appcompat.app.AppCompatActivity
    
    android.support.v7.widget.GridLayoutManager
    ->
    androidx.recyclerview.widget.GridLayoutManager
    
    android.arch.lifecycle.OnLifecycleEvent
    ->
    androidx.lifecycle.OnLifecycleEvent
    
    android.support.v7.widget.AppCompatTextView
    ->
    androidx.appcompat.widget.AppCompatTextView
    
    android.support.design.widget.BottomSheetDialog
    ->
    com.google.android.material.bottomsheet.BottomSheetDialog
    
    android.support.design.widget.TabLayout
    ->
    com.google.android.material.tabs.TabLayout
    
    android.arch.lifecycle.Observer
    ->
    androidx.lifecycle.Observer
    
    android.support.v7.widget.LinearLayoutManager
    ->
    androidx.recyclerview.widget.LinearLayoutManager
    
    android.support.v7.widget.CardView
    ->
    androidx.cardview.widget.CardView
    
    android.support.v7.widget.AppCompatRatingBar
    ->
    androidx.appcompat.widget.AppCompatRatingBar
    
    android.support.v4.widget.NestedScrollView
    ->
    androidx.core.widget.NestedScrollView
    
    android.support.v7.widget.AppCompatEditText
    ->
    androidx.appcompat.widget.AppCompatEditText
    
    android.support.v7.widget.AppCompatButton
    ->
    androidx.appcompat.widget.AppCompatButton
    
    //MultiDex
    android.support.multidex.MultiDex
    ->
    androidx.multidex.MultiDex
    
    //单元测试，如果有用到，需要进行替换
    android.support.test.InstrumentationRegistry
    ->
    androidx.test.InstrumentationRegistry
    
    android.support.test.runner.AndroidJUnit4
    ->
    androidx.test.runner.AndroidJUnit4
    
    android.support.test.runner.AndroidJUnitRunner
    ->
    androidx.test.runner.AndroidJUnitRunner

##### 4.查看漏网之鱼 #####

可能会有一些小众的漏网之鱼，需要全局逐个搜索`shift+ctrl+F`

android.support.v7
    android.support.v4
    android.support.v13
    android.support.

将遗漏的相关这些代码也进行替换

> 或者此时再使用Android Studio的Refactor > Migrate to AndroidX也可以

至此，重新编译，运行，可以迁移至AndroidX

#### 其他 ####

##### android.support.FILE\_PROVIDER\_PATHS #####

Manifest中一般有这个provider，不需要替换，详见 [Migrating to AndroidX - android.support.FILE\_PROVIDER\_PATHS location][Link 1]

##### 参考 #####

[Android:你好,androidX！再见,android.support][Android_androidX_android.support]  
[官网:迁移到 AndroidX][Link 1]

[Link 1]: https://developer.android.google.cn/jetpack/androidx/migrate
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V0aGFuQ28_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191115102451150.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0V0aGFuQ28=,size_16,color_FFFFFF,t_70
[Android_androidX_android.support]: https://www.baidu.com/link?url=agpV_i8n2qNGnpxBFcKTcvHYQOAWHZLN-5UlCiAakKV4188eOtE8y9PCsBEz5vBa&wd=&eqid=c61b26c800090e17000000055dce094e