如何构建具有隐藏和可用内部 API 的 Android SDK？

Question

我想重建 Android SDK（或者更确切地说只是 android.jar）以包含隐藏的和内部的 API。

我找不到任何有关如何解决此问题的文档或讨论。我已经设置了能够构建 cm7 的 Ubuntu CyanogenMod 构建环境。

现在，我读到 make SDK 将构建 SDK，但我想构建一个 SDK，其中包含使用 @hide 标记为隐藏的方法和字段。这可能吗？

我想要做的是对使用隐藏 API 的应用程序进行更改，并且为了重建它，我想使用修改后的 SDK。

Answer 1

我们可以从Android平台重建*.jar文件。

首先，将 ADB 连接到您的设备。然后运行：

adb pull /system/framework/core.jar .
adb pull /system/framework/framework.jar .

core.jar 包含标准 Java 库 (java.*)，framework.jar 包含 Android 库 ( >android.*)。这尚不可用，因为实际文件是 DEX 格式，而不是 JAR 格式。

我们可以使用 dex2jar 等工具将这些 DEX 格式的 *.jar 转换为真正的 JAR：

dex2jar core.jar
dex2jar framework.jar

引入这些 jar

• 然后使用“添加外部 JAR...”（假设您使用的是 Eclipse ADT）右键单击 Project → Properties → Java Build Path → Libraries → Add external JARs... → （从上面选择 core-dex2jar.jar 和 framework-dex2jar.jar）。

这将使您能够使用内部 API 和一些 Java 7 API。 （据我所知，生成的 APK 不包含 JAR 中的任何实际代码。）

Answer 2

您可以从 此下载修改后的 android.jar 以用作隐藏 API存储库。按照那里的说明进行操作。

Answer 3

对于 Lollipop，流程略有不同：

1. 从 lollipop 设备获取 /system/framework/arm/boot.oat

2. 使用 'java - jar oat2dex.jar boot boot.oat'

3. 你会得到两个文件夹： dex和奥德克斯。转到 dex 并制作 'java -jar dex2jar.jar Framework.dex'
4. 将生成的 Framework.jar 重命名为.zip，解压并找到您需要的类
5. 转到[sdk_path]/platforms/[target_platform]并解压android.jar（首先将其重命名为zip）。
6. 将文件从提取的框架复制到提取的 android.jar。然后压缩为 zip 并重命名为 .jar :)

ps: 可能您需要对“framework_classes2.dex”重复步骤 4-6

Answer 4

DroidCon 2011

来自索尼爱立信的 Erik Hellman 解释了如何访问隐藏的 Android API :

http://vimeo.com/30180393
（嗯，链接似乎不起作用）。

转到DroidCon 网页第 2 天向下滚动到使用隐藏的 API 10 :15 你可以在那里观看。

链接正在消失！

我找到了这个： http://skillsmatter.com/podcast/os -mobile-server/hidden-api 我不知道，它会持续多久。

Android SDK 中的官方 API 通常足以满足大多数普通应用程序的需要。然而，有时开发人员需要访问官方 API 中未发布的内部系统服务、API 和资源。幸运的是，这些 API 仍然可以通过一些巧妙的技巧来使用，并且在 Android 上开发新的创新解决方案时通常很有用。在本次会议中，您将了解如何访问和使用这些隐藏和受保护的 API、它们的使用限制以及有关如何跨多个供应商设备和 Android 版本以安全和可控的方式使用它们的一些提示和技巧。观众将看到几个通常用 Android 无法做到的高级演示。期待一场相当高级的会议，其中包含有关 Android 平台内部的大量见解。

Answer 5

尝试看看这个：

这些文章的最终目标是为开发人员提供内部和隐藏 API 的强大功能，而无需使用反射。如果您完成接下来几个部分中描述的所有步骤，您将能够使用内部和隐藏 API，就像它们是公共开放 API 一样。无需反思。

但是，如果您使用这些非公共 API，那么您应该意识到您的应用程序面临巨大风险。基本上无法保证 API 不会因 Android 操作系统的下一次更新而被破坏。甚至无法保证不同供应商的设备之间的行为一致。你完全靠自己了。

您可能需要遵循三种情况：

1. 启用内部和隐藏 API（场景 A）
2. 仅启用隐藏 API（场景 B）
3. 仅启用内部 API（场景 C）

场景 A 是 B 和 C 的总和。场景 B 是最简单的一个（不需要修改 eclipse ADT 插件）。

场景 A：阅读部分 1，2，3, 4，5

场景 B：阅读部分 1，2，3, 5

场景 C：阅读部分 1，2，3, 4，5

Answer 6

我曾经编写过一些 Groovy 脚本，用于从 http://source.android.com/ 然后编译它们，而不需要完整的工具链来编译所有 Android 源代码，包括所需的其他步骤（打包、生成资源等）。

它们可以在这里找到：

https://github.com/thoutbeckers/CollectAndroid

但是肯定的是 这将需要在 Gingerbread 之后更新任何内容，主要是通过在配置文件 (CollectConfig.groovy) 的“rootdirs”中设置正确的目录。

当时我经常使用它进行开发，并提供所有隐藏的 API 和源（当时也有问题）。

正如其他地方提到的，由于添加了访问规则，com/android/internal/** 在最新版本的 ADT 中仍将被隐藏。

Answer 7

Long的答案对我有用，但我仍然缺少一些我需要的课程，特别是 android.provider.Telephony。我可以像这样添加它：

1. 提取framework.jar文件

   mkdir /tmp/framework
   cp 框架.jar /tmp
   cd /tmp/框架
   jar xvf ../framework.jar
   mv android 课程
   

2. 构建Android存储库，这将创建out/target/common/obj/JAVA_LIBRARIES目录

3. 查找缺少的类的位置

   $ cd /path/to/out/target/common/obj/JAVA_LIBRARIES
   $ 查找 . | grep "/Telephony.class"
   ./telephony-common_intermediates/classes/android/provider/Telephony.class
   ./android_stubs_current_intermediates/classes/android/provider/Telephony.class
   

4. 添加新类并重建框架 JAR 文件

   cd /tmp/framework
   cp -r /path/to/out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes 。
   cp -r /path/to/out/target/common/obj/JAVA_LIBRARIES/telephony-common_intermediates/classes 。
   光盘课程
   jar cvf ../framework.jar 。
   

或者您可以偷懒，将所有类包含到一个巨大的 jar 文件中：

cd /tmp/framework
cp -r /path/to/out/target/common/obj/JAVA_LIBRARIES/*/classes .
cd classes
jar cvf ../framework.jar .

Answer 8

我无法发表评论，但这基本上是对 @KennyTM 的评论 (https://stackoverflow.com/a/13550030/2923406) 优秀的答案：

如果您发现自己在 Eclipse 中出现以下错误：（

The type com.android.internal.util.Predicate cannot be resolved. It is indirectly referenced from required .class   files

即 android.internal.* 不可用）

那么一种可能的解决方案是应用/system/framework/framework2.jar 的方法相同。使用 SDK19 的 Android 模拟器我有这个额外的 jar。在我的 HTC One 上甚至还有一个 Framework3.jar。

Answer 9

这就是我使用隐藏 api 时经常做的事情。

1. 构建存储库或从 https:/ 下载 jar /sites.google.com/site/hippunosource/home/android/androidnohide-apiwo-shi-yongsuru-rifurekushonha-wei-shi-yong
2. 复制out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar （最好将其重命名为类似framework_all.jar 的名称）
3. 配置您的项目构建路径 --> 库 -->添加这个外部罐子。在 Order and Export 中，将其向上移动到 android.jar 之前

Answer 10

我对此进行了一些调查，我的结论很简单：如果没有大量工作，这是不可能完成的。阅读本答案的其余部分，了解我发现的详细信息。

---

android.jar 实际上由 framework.jar 和 core.jar 的“公共 api”组成，可以在 system/ 中找到设备上的框架/。 android.jar 是一种我所说的 Java 库头，实际字节码中的所有实现都只是一个 throw new RuntimeException("stub");，这个允许您针对 android.jar 进行构建（例如在 Eclipse 中），但必须在设备或模拟器上执行。

Android SDK 的公共 API 由类/方法/字段定义，这些类/方法/字段不以 @{hide} javadoc 注释为前缀。即，未注释的所有内容都包含在 SDK 中。

android.jar 是根据 out/target/common/obj/JAVA_LIBRARIES/android_stubs_current_intermediates 中的源代码构建的，它本身是由工具 DroidDoc 生成的位于 build/tools/droiddoc 中。

DroidDoc 是生成实际 Android SDK 文档的工具（可能改编自 javadoc，或使用 javadoc）。作为副作用，可能是因为它已经解析了所有 javadoc，它还生成了 android 存根，然后这些存根被编译到在 SDK 中分发的 android.jar 中。

因此，要包含隐藏的内容，如果您只想包含特定部分，只需删除 @hide 注释并重建 SDK 即可。

但是，如果您想包含所有隐藏部分，事情就会变得更加复杂。您可以修改DroidDoc（相关源位于build/tools/droiddoc/src/Stubs.java中），这样就不会检测到任何隐藏内容。这是非常简单的，我已经尝试过了，但是随后生成的存根根本无法编译。

我现在的结论是，这根本不可行。如果删除 DroidDoc 中检测隐藏注释的部分，生成的存根根本无法编译，并且需要大量工作才能正确编译。

所以我对你的问题的回答是：不，如果不做大量工作，这是不可能完成的。抱歉。

---

关于 mkstubs 工具的旁注。 mkstubs 在您构建 SDK 插件时使用，即您可以在供应商的 Android SDK 管理器中找到的插件，例如三星为您提供了针对特定内容的附加 API三星手机。 mkstubs 与 DroidDoc 存根生成过程大致相同，但它不使用 @hide 注释，它使用 .defs 文件描述要包含或排除在 SDK 插件中的包/类/字段。

然而，这与问题无关，因为 Android SDK 构建不使用 mkstubs 工具。 （很遗憾。）