编译包含隐藏API的Android SDK(被@hide隐藏)

Android 官方对应用开发者隐藏了很多 API,在一般开发中,我们很少需要使用它们,但并不是说这些API很鸡肋,相反的,利用这些API往往能够实现一些神奇的效果

1. 为何对开发者隐藏?

Android 提供给开发人员的SDK 不是完整的系统API,这么做是有原因的:

  1. 一般的应用并不需要使用到一些系统级的功能
  2. Android 并不能保证所有API能够保持稳定兼容

所以,使用隐藏API意味着程序兼容性变差,一般不推荐使用。但是有时候调用这些API能够实现一些特殊需求。

2. 如何使用隐藏API?

然而这些API虽然没有在SDK中提供出来,我们仍然可以使用,有两种方式:

  1. 通过反射调用隐藏的类,方法或者字段
  2. 自己编译完整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.jarcore.jar 拷贝到该目录下。
修改app下的build.gradle,在 dependencies 增加

dependencies {
    //...
    provided fileTree(dir: 'sdk', include: ['*.jar'])
    //...       
}

同步工程,直到添加进的 core.jarframework.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.jarframework.jar 和官方SDK中的 android.jar,合并以 core.jarframework.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

上述操作中需要注意两点:

  1. 备份原版 android.jar
  2. 压缩jar包时,保证工作目录里的 jar包被移开,不然会被打包进去

你可能感兴趣的:(编译包含隐藏API的Android SDK(被@hide隐藏))