Android 官方对应用开发者隐藏了很多 API,在一般开发中,我们很少需要使用它们,但并不是说这些API很鸡肋,相反的,利用这些API往往能够实现一些神奇的效果
1. 为何对开发者隐藏?
Android 提供给开发人员的SDK 不是完整的系统API,这么做是有原因的:
- 一般的应用并不需要使用到一些系统级的功能
- Android 并不能保证所有API能够保持稳定兼容
所以,使用隐藏API意味着程序兼容性变差,一般不推荐使用。但是有时候调用这些API能够实现一些特殊需求。
2. 如何使用隐藏API?
然而这些API虽然没有在SDK中提供出来,我们仍然可以使用,有两种方式:
- 通过反射调用隐藏的类,方法或者字段
- 自己编译完整SDK,公开隐藏的API
本文主要记录第二种。
3. 编译完整的SDK
我已经编译好一份上传了,可以直接下载下来。
方式一产生的 core.jar 和 framework.jar,
方式二产生的 android.jar
3.1 下载AOSP源码
1. 搭建编译环境
具体参照官方指南
2. 下载源码
参照官方指南 ,推荐使用 清华的镜像, 将 https://android.googlesource.com/
全部使用 https://aosp.tuna.tsinghua.edu.cn/
代替即可。
在执行repo init
时,需要注意根据自己需要的SDK版本检出特定分支,不然检出的默认是 master 分支
3.2 编译SDK
跳转到源代码根目录,执行如下命令开始编译SDK。
1、 在当前shell中初始化编译环境
source build/envsetup.sh
2、检测编译环境是否正确,并且清理上次编译的结果(make clean)
make clobber
3、编译SDK
make sdk
最后一步执行比较慢,可以使用多线程加速编译,make sdk -j 8
3.3 手动导出SDK
拷贝出 out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar
, 重命名为 framework.jar
,
拷贝出
out/target/common/obj/JAVA_LIBRARIES/core_all_intermediates/classes.jar
,重命名为 core.jar
。
这两个 jar 包就是我们需要的包含了隐藏API的SDK
3.4 导入SDK到 Android Studio
1. 调整工程SDK版本
使用 AS 新建 Android 工程,将 app下的 build.gradle
compileSdkVersion 改为 25 (上一步产生的Sdk 对应的 版本号是25,需要确保一致),使用 gradle 同步一下工程,保证没有错误
2. 导入jar包
在 app下新建 sdk 目录,把上一步产生的 framework.jar
和 core.jar
拷贝到该目录下。
修改app下的build.gradle
,在 dependencies
增加
dependencies {
//...
provided fileTree(dir: 'sdk', include: ['*.jar'])
//...
}
同步工程,直到添加进的 core.jar
和 framework.jar
被工程识别
3. 调整jar包优先级
修改app下的build.gradle
在文件末尾增加
preBuild {
doLast {
def imlFile = file(project.name + ".iml")
println 'Change ' + project.name + '.iml order'
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) {
// nop, iml not found
}
}
}
再同步一次工程,这样就能使用一些隐藏API了。
3.5 另一种导入SDK的方式
上面的方式不涉及修改原来的SDK,只对当前工程有效,侵入性比较小。
还有一种方式,通过生成自己的android.jar,替换掉官方的jar包,对所有工程有影响,一次修改,终生有效。
原理是合并 core.jar
,framework.jar
和官方SDK中的 android.jar
,合并以 core.jar
和 framework.jar
为主,去覆盖 android.jar
中的 class文件。
我这里生成sdk 的 api level 是25,我需要替换的android.jar
位于 sdk目录的 platforms\android-25 中,jar包解压与合并主要通过 JDK自带的 jar 命令。
jar -xvf xxx.jar // 解压xxx.jar 到当前目录
jar -cvfM xxx.jar . // 将当前目录的所有文件压缩成一个jar包,名字为 xxx
上述操作中需要注意两点:
- 备份原版 android.jar
- 压缩jar包时,保证工作目录里的 jar包被移开,不然会被打包进去