Android Studio 工程导入 AOSP编译的 android.jar

news2025/1/10 20:55:54

使用场景
　　1.需要使用 framework 中的 @SystemApi 文件或者 @hide 的 API 接口
　　2.定制 Framework 层业务，即有客制化的 API 接口
补充知识点
　　1.framework 源码即 AS 工程目录中 External Libraries 下的 < Android API xx Platform > 下的原生 SDK 的 android.jar
　　　　所在路径：Sdk\platforms\android-29\android.jar
　　2.compileSdkVersion：AS 本地开发环境中的依赖的 sdk 编译版本，即决定了 < Android API xx Platform > 中 xx 的值，如 < Android API 29 Platform >
　　3.targetSdkVersion：APP版本开发中的适配版本
　　4.buildToolsVersion：工程的构建工具版本，即 Gradle 版本
备注：
　　以下内容使用的 framework.jar 为个人源码编译得的，才有其中的如 SystemProperties 类。

实际场景

在这里插入图片描述
　　如上图所示，当我们在项目中使用一些 @SystemApi 文件或者 @hide 接口时，直接使用工程中 Gradle 为我们加载的 sdk 中 android.jar 时会出现无法使用的异常报错，这将导致无法正常编译，或者哪怕你做的是系统应用开发，可以使用源码正常编译，但整个工程都是红色提示，这也会愁死那些有强迫症的码农。
　　那么解决方案就来了，如何正常使用它或者消除红色提示呢？

导入离线 android.jar

这边以原生 sdk 中的 30 android.jar 为例，客制化的平台源码编译的 framework 包请注意注释

配置 jar 包的优先级

将工程想要依赖的 framework 包放置 app module 的 libs 下，

dependencies {
    //Android N/O:
    //out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar
    //Android P/Q:
    //out/soong/.intermediates/frameworks/base/framework/android_common/combined/framework.jar
    //Android R:
    //out/soong/.intermediates/frameworks/base/framework-minus-apex/android_common/combined/framework-minus-apex.jar
    compileOnly files('libs/framework9.jar')
//    implementation files('libs\\framework30.jar')
}

将其配置加载优先于原生 sdk 的 android.jar
Project 的 build.gradle

allprojects {
    ......
    gradle.projectsEvaluated {//Gradle 提供的生命周期回调方法：所有project配置完成后调用
        tasks.withType(JavaCompile) {
            options.compilerArgs.add('-Xbootclasspath/p:app\\libs\\framework9.jar')
        }
    }
}