怎样查看并且使用 Android 隐藏 API 和内部 API

Android 有两种类型的 API 不能通过 SDK 访问。一种是在 com.android.internal 包中的 API,称之为 internal API。另一种是被标记为 @hide 属性的类和方法,这是一组小级别的被隐藏的 API,称之为 hidden API。

当使用 Android SDK 进行开发的时候,应用默认引用了 android.jar,它位于 SDKDir\platforms\android-X 目录下(X 代表 API 级别),默认移除了所有的被@hide标识的方法或者类以及 internal 包下的类。。当应用在设备上运行时,它会加载 framework.jar。简单来说,framework.jar 和 android.jar 等同,但是没有移除 internal API 和 hidden API。Hidden API 之所以被隐藏,是想阻止开发者使用 SDK 中未完成或不稳定的部分。

举个栗子:这是没有移除 internal API 的 android.jar,可以看到包里的类是完整的。

internal api

比如 AssetManager 的 addAssetPath 方法被 @hide 标记,它属于 hidden API,我们无法直接调用该方法。

    /**
     * Add an additional set of assets to the asset manager.  This can be
     * either a directory or ZIP file.  Not for use by applications.  Returns
     * the cookie of the added asset, or 0 on failure.
     * {@hide}
     */
    public final int addAssetPath(String path) {
        synchronized (this) {
            int res = addAssetPathNative(path);
            makeStringBlocks(mStringBlocks);
            return res;
        }
    }

但是,人的需求是无限的。如果我们非要使用不可用的 API 怎么办呢?最简单的就是 Java 的反射,反射 @hiden 的方法或类,修改访问修饰符,然后就可以搞事情了~~还有一种方法是从设备中提取,简单说就是把设备上的 /system/framework/framework.jar 提取出来,经过一系列转换,最终得到完整的 android.jar,具体的步骤可以参考这篇文章:android怎样调用@hide和internal API。另外一种方式非常简单,GitHub 上有一个项目:android-hidden-api,里面提供了众多版本完整的 android.jar 包,下图所示。

android hidden api

我们把工程 clone 下来,找到对应平台的 android.jar 包,替换掉 Android SDK 下面的 jar,最好先备份一下原始的 jar,重新编译工程或者重启 Studio 就行了。

比如 AssetManager 的 addAssetPath 方法,没有替换之前是这样,Studio 提示错误,编译失败~o(>_<)o ~

can't resolve addAssetPath

但是在使用了完整的 android.jar 后,发现竟然不会报错了,代码可以通过编译,终于可以愉快地使用想要的方法了 O(∩_∩)O~

can resolve addAssetPath

这种方式对于个人开发来说没有问题,你把 android.jar 替换掉就好了,但是如果面对团队开发,就非常痛苦了 %>_<%,每个人都要替换 SDK 的 android.jar,代价和风险可想而知。那么有没有好的解决办法,既可以让工程编译通过,又能够免去多人替换 jar 的成本呢?答案是有的。

Studio 默认引用的是 SDK 下面的 android.jar,那我们把它的引用改成完整的 jar 的路径不就行了么?
我们把完整的 android.jar 放在工程 libs 目录下,也就是平时依赖 jar 的地方,然后在工程 build.gradle 配置的 dependencies 里,以 provided 的方式引用 android.jar。因为每个工程模块依赖 android.jar 的类型就是 provided,这样不会把 android.jar 打包到应用中,运行环境中存在 framework.jar,应用直接就可以使用。

dependencies {
     // compile fileTree(include: ['*.jar'], dir: 'libs')  这行一定要去掉,当然为 android.jar 换个目录也行
    testCompile 'junit:junit:4.12'
    provided files('libs/hidden_api_23.jar')
}

最后还要在工程根目录的 build.gradle 里面配置当前 project,加上下面的代码就行了。

project('app') { // app是你工程的名字,配置只对当前工程有效
    gradle.projectsEvaluated {
        tasks.withType(JavaCompile) {
            // 注意修改 jar 包的路径,替换 app/libs/hidden_api_23.jar,其他部分不要改
            // Xbootclasspath/p:是 Java 编译的寻址优先设置,先找缺省路径还是全路径
            options.compilerArgs.add('-Xbootclasspath/p:app/libs/hidden_api_23.jar')
        }
    }
}

现在重新编译工程,虽然会在代码中出现错误提示,但是编译打包运行都是正常的。_

在开发中使用隐藏 API 和内部 API 是不推荐的做法,但是为了实现一些「黑科技」,这些又是必须的~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 143,201评论 1 300
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 61,387评论 1 257
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 94,683评论 0 213
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 41,080评论 0 179
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 48,865评论 1 255
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 38,810评论 1 177
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 30,440评论 2 271
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 29,200评论 0 167
  • 想象着我的养父在大火中拼命挣扎,窒息,最后皮肤化为焦炭。我心中就已经是抑制不住地欢快,这就叫做以其人之道,还治其人...
    爱写小说的胖达阅读 29,019评论 6 231
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 32,540评论 0 213
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 29,337评论 2 215
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 30,658评论 1 231
  • 白月光回国,霸总把我这个替身辞退。还一脸阴沉的警告我。[不要出现在思思面前, 不然我有一百种方法让你生不如死。]我...
    爱写小说的胖达阅读 24,255评论 0 32
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 27,145评论 2 214
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 31,535评论 3 206
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 25,626评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,028评论 0 166
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 33,555评论 2 230
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 33,652评论 2 231

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,383评论 25 707
  • afinalAfinal是一个android的ioc,orm框架 https://github.com/yangf...
    passiontim阅读 14,948评论 2 44
  • 今天第一次做个人成长团辅,真的很感恩,这么好的机会大家给我了。职场关系最近几年一直是我的短板,我想过怎么怎么不被她...
    宁小小白阅读 343评论 0 2
  • 这个世界所有东西本不是非黑即白的,所以按照这个理论,除了文艺骚和非文艺骚,还有一类人叫伪文艺骚。 文艺骚通常看了一...
    安an安an阅读 108评论 0 0
  • 开发过程中真是会用到各种各样的方法,今天记录一下字符串和数组的相互转换的方法 1.将string字符串转换为arr...
    寻常_0阅读 369评论 0 0