记录项目适配安卓14的过程

原项目的开发环境

Studio Chipmunk //2021.2.1版开发
gradle-6.7.1-all
gradle:4.2.2
targetSdk 29
compileSdk 29

旧项目已经老掉牙了，准备适配到安卓14记录一下。

新版的安卓新增细化了了不少权限，如蓝牙连接和图片访问等。
如果用新的安卓14手机启动应用时会有一个“该应用使用旧版打造..”之类的提示，理论上使用是不会有影响。

但最近客户在一台oppo手机使用时，捕获到“ Need android.permission.BLUETOOTH_CONNECT permission”的异常。

分析为新版安卓的蓝牙权限改动导致。

该异常在同事的华为以及我的三台小米手机均无法复现，因此决定对项目进行升级适配。

1、升级studio
下载新的studio hedgehog 2023.1.1版本
因为原先使用的 Studio Chipmunk //2021.2.1支持AGP版本为3.2-7.2
而如果要适配SDK34则需要AGP版本8.1.1

https://developer.android.com/studio/releases?hl=zh-cn#api-level-support
https://developer.android.com/studio?hl=zh-cn

SDK对应Android版本
*   Android 10：SDK 29
*   Android 11：SDK 30
*   Android 12：SDK 31
*   Android 13：SDK 32
*   Android 14：SDK 33
*   Android 15：SDK 34

2、项目gradle设置

这里有个技巧，就是下好新的studio后，新建一个 Project ，看看新的 Project 里的 build.gradle 等配置文件是怎么写的，参照一下即可。

新建对比之后发现确实相差很多，一步一步解决

1.升级 gradle\wrapper\gradle-wrapper.properties 里的版本：
distributionUrl=https://services.gradle.org/distributions/gradle-8.2-bin.zip

2.修改根目录 build.gradle 文件
原来的格式：

buildscript {
    repositories {
        google()
        jcenter()//jcenter可以删了
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.2.2'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url '[https://jitpack.io](https://jitpack.io/)' }
        mavenCentral()
    }
}

新的格式内容：

plugins {
    id 'com.android.application' version '8.0.0' apply false
    id 'com.android.library' version '8.0.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.8.10' apply false
}

只标注agp版本号和kotlin版本号。

仓库依赖则移动到setting.gradle里去了

pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
        maven { url '[https://www.jitpack.io](https://www.jitpack.io/)' }
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url '[https://www.jitpack.io](https://www.jitpack.io/)' }
    }
}

pluginManagement 对应原来 repositories 内容

dependencyResolutionManagement 对应原来 allprojects 里的内容。

3.flatDir和aar的迁移

如果原来的项目有使用flatDir方式导入arr如在app\build.gradle有

    repositories {
        flatDir {
            dirs 'libs'
        }
    }
...
implementation(name: 'BaiduLBS_Android_', ext: 'aar')

则会提示

A problem occurred evaluating project ':app'.
> Build was configured to prefer settings repositories over project repositories but repository 'flatDir' was added by build file 'app\build.gradle'

我这里采用的方法是在项目中新建一个module,如"aar_module",在里面创建一个libs文件夹,把所有aar文件全部放进去

Image.png

在 app\build.gradle 添加依赖的地方 dependencies 里添加

    if (project.plugins.hasPlugin("com.android.application")) {
        implementation fileTree(include: ["*.aar"], dir: rootDir.absolutePath + '/aar_module/libs')
    }

这样就行了，原先 dependencies 里导入 aar 的命令如

implementation(name: 'BaiduLBS_Android_', ext: 'aar')

都可以删掉了

4.修改app\build.gradle内容

AGP8.0之后使用java17，而且使用kotlin作为jvm的编译器，

compileOptions {
    sourceCompatibility JavaVersion.VERSION_17
    targetCompatibility JavaVersion.VERSION_17
}
kotlin {
    jvmToolchain(17)
}
kotlinOptions {
    jvmTarget = '17'
}

如果module里有用到kotlin都要添加.

按F12打开 project structure 把里面的对应的都要改成 jdk 17

file-setting-gradle里的gradle JDK 也要改成17

Image.png

如果之前有用依赖方式添加kotlin和协程，如

   //kotlin
    implementation "org.jetbrains.kotlin:kotlin-reflect:$kotlin_version"
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
    implementation 'androidx.core:core-ktx:1.6.0'

    //协程
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.4.1'
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.4.1'

这样的代码可以全部删除了，新版本已经自带kotlin和协程

剩下的还有 build.gradle 已经改成 build.gradle.kts 等等，可以继续使用 Groovy DSL方式继续使用，也可以改成 Kotlin DSL方式编写。

还有一些小问题编译的时候会给出提示，做相对应的就该就行，比如

添加namespace

android {
         namespace 'com.example.namespace'
}

约等于包名，每个moudle都要添加。

flavorDimensions版本差异，暂时可以添加

buildFeatures {
   buildConfig true
}

来避免错误提示

编译完没有报错之后就可以开始添加蓝牙权限了

    <!-- SD卡读写权限 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 
    <!-- Android 13版本适配，细化存储权限 -->
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
    <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />

    <!--Android12 蓝牙适配-->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    <uses-permission
        android:name="android.permission.BLUETOOTH"
        android:maxSdkVersion="30" />
    <uses-permission
        android:name="android.permission.BLUETOOTH_ADMIN"
        android:maxSdkVersion="30" />

添加完在需要用的地方动态获取即可。