1. 为什么需要集成framework.jar在Android系统开发中framework.jar是个特殊的存在。它包含了Android框架层的核心类和方法很多系统级API比如SystemProperties、UserHandle等都定义在这里。但如果你打开Android Studio的SDK Manager会发现platforms目录下的android.jar里这些关键类和方法都被标记为hide无法直接调用。我最近在开发一个需要修改system_server的功能时就遇到了这个问题。当时需要新增20多个类用纯文本编辑器开发效率太低而配置VS Code插件又太麻烦。最理想的方案就是把代码导入Android Studio开发再打包成jar放回源码编译。但实际操作起来从framework.jar的获取到集成每个环节都暗藏玄机。2. 获取正确的framework.jar文件2.1 常见误区与正确路径网上大多数教程都会告诉你framework.jar在out/target/common/obj/JAVA_LIBRARY/framework_interminate/classes.jar。但如果你用的是较新的Android版本Android 9及以上这个路径根本不存在这是因为Android编译系统从Nougat开始引入了Soong构建系统目录结构发生了重大变化。正确的路径应该是Android 9/10: out/soong/.intermediates/frameworks/base/framework/android_common/combined/framework.jarAndroid 11: out/soong/.intermediates/frameworks/base/framework-minus-apex/android_common/combined/framework-minus-apex.jar我第一次操作时就踩了这个坑在旧路径下找了半天都没找到文件。后来查看编译日志才发现路径已经变了。建议在编译完整系统后直接用find命令搜索framework.jar文件find out/soong/.intermediates -name framework*.jar2.2 文件验证技巧拿到jar包后别急着用先用JD-GUI等工具打开看看内容是否完整。重点检查是否包含android.os、android.content等关键包检查SystemProperties等关键类是否存在确认hide方法是否可见比如UserHandle.myUserId()有次我拿到的jar包只有200KB左右明显不正常。后来发现是编译时没加完整编译参数导致生成的jar包不完整。3. Android Studio 3.x集成方案3.1 基础配置步骤以Android Studio 3.6.3为例首先把framework.jar拷贝到模块的libs目录下比如app/libs或framework-ext/libs。然后在build.gradle中添加依赖dependencies { compileOnly files(libs/framework.jar) }sync之后你会发现hide的类可以找到了但调用hide方法时还是会报错。这是因为Android SDK的优先级高于我们的framework.jar。3.2 关键调整修改iml文件需要在模块的build.gradle中添加preBuild任务来调整iml文件preBuild { doLast { def imlFile file(framework-ext.iml) try { def parsedXml (new XmlParser()).parse(imlFile) def jdkNode parsedXml.component[1].orderEntry.find { it.type jdk } parsedXml.component[1].remove(jdkNode) def sdkString Android API android.compileSdkVersion.substring(android-.length()) Platform new Node(parsedXml.component[1], orderEntry, [type: jdk, jdkName: sdkString, jdkType: Android SDK]) groovy.xml.XmlUtil.serialize(parsedXml, new FileOutputStream(imlFile)) } catch (FileNotFoundException e) { println no iml found } } }这个脚本会把Android SDK的顺序调到最后让framework.jar优先被引用。执行后hide方法就不会标红了。3.3 编译参数调整但编译还是会失败因为bootclasspath没包含framework.jar。需要在项目build.gradle中添加allprojects { gradle.projectsEvaluated { tasks.withType(JavaCompile) { options.compilerArgs.add(-Xbootclasspath/p:libs/framework.jar) } } }注意路径是相对模块的不要写绝对路径。如果需要多个jar比如services.core.priorityboosted.jar用冒号分隔options.compilerArgs.add(-Xbootclasspath/p:libs/framework.jar:libs/services.core.priorityboosted.jar)千万不能分开写两个add后者会覆盖前者我曾经在这里浪费了两小时排查为什么第二个jar包不生效。4. Android Studio 4.x的适配方案4.1 Arctic Fox (2020.3.1)的变化Android Studio 4.x移除了iml文件机制之前的方案不再适用。新的解决方案是在模块build.gradle中直接修改bootstrapClasspathandroid { gradle.projectsEvaluated { tasks.withType(JavaCompile) { SetFile fileSet options.bootstrapClasspath.getFiles() ListFile newFileList new ArrayList() newFileList.add(new File(libs/framework.jar)) newFileList.addAll(fileSet) options.bootstrapClasspath files(newFileList.toArray()) } } }4.2 Electric Eel (2022.1.1)的调整这个版本开始bootclasspath参数被移除需要改为调整classpathandroid { gradle.projectsEvaluated { tasks.getByName(compileDebugJavaWithJavac) { dependsOn(processDebugResources) classpath reorderClasspath(classpath.getFiles()) } } } def reorderClasspath(SetFile classpathSet) { ListFile newFileList new ArrayList() File sdkFile null for (File f : classpathSet) { if (android.jar f.getName()) { sdkFile f } else { newFileList.add(f) } } if (sdkFile ! null) { newFileList.add(sdkFile) } return files(newFileList.toArray()) }这里有个关键点必须显式声明task依赖否则会报找不到R.class的错误。这个坑特别隐蔽我当初是通过分析gradle编译日志才发现的。4.3 Giraffe版本的解决方案最新版Android Studio Giraffe又有了变化推荐使用以下方案在gradle.properties中添加android.overridePathChecktrue在模块build.gradle中添加android { sourceSets { main { java.srcDirs libs } } }将framework.jar放在模块的libs目录下5. 常见问题排查指南5.1 编译成功但运行崩溃如果APK运行时报ClassNotFound或MethodNotFound很可能是没有正确处理多jar包依赖顺序混淆配置有问题运行时环境缺少framework.jar解决方案检查-Xbootclasspath参数是否正确在proguard-rules.pro中添加keep规则确保测试设备是userdebug版本5.2 代码提示不正常如果Android Studio能编译通过但代码提示有问题可以尝试File - Invalidate Caches删除.idea和.gradle目录后重新sync确保没有多个版本的framework.jar冲突5.3 多模块依赖问题当主模块依赖的库模块也用了framework.jar时需要在主模块的build.gradle中添加afterEvaluate { def libModule project(:your-lib-module) def libJar file(${libModule.projectDir}/libs/framework.jar) if (libJar.exists()) { dependencies { compileOnly libJar } } }6. 版本兼容性矩阵为了帮助大家快速选择适合自己环境的方案我整理了各版本Android Studio的适配方案Android Studio版本核心调整点关键配置3.ximl文件调整 bootclasspath-Xbootclasspath/p参数4.0-4.2bootstrapClasspath修改options.bootstrapClasspath设置Electric Eelclasspath重排序reorderClasspath方法Giraffe路径检查绕过android.overridePathCheck在实际项目中我建议创建一个gradle脚本专门处理framework.jar集成比如framework.gradleext { setupFramework { Project project, String jarName - project.android { gradle.projectsEvaluated { tasks.withType(JavaCompile) { // 根据版本选择不同配置 if (androidStudioVersion 2022.1) { // Electric Eel方案 } else { // 旧版本方案 } } } } } }然后在各模块build.gradle中应用apply from: ../framework.gradle setupFramework(project, framework.jar)这种方案最大的好处是当Android Studio升级时只需要修改一个脚本文件就能完成全局调整。我在一个涉及5个模块的实际项目中采用这种方案版本迁移时节省了大量时间。