Android 使用internal和hidden

原文链接地址：http://www.eoeandroid.com/thread-83194-1-1.html

1.

Android有两种类型的API是不能经由SDK访问的。

       第一种是位于com.android.internal包中的API。 我将称之为internal API。第二种API类型是一系列被标记为@hide属性的类和方法。从严格意义上来讲，这不是一个单一的API，而是一组小的被隐藏的API，但我仍将 其假设为一种API，并称之为hidden API。

        Hidden API 例子 
       你可以查看一下android的源码，并能找到一些变量、函数和类等，都被@hide属性标记了。下面的例子就是在WifiManager中隐藏的变量。



        另一个例子是在WifiManager中隐藏了setWifiApEnabled函数。

         Internal和hidden API的区别
        Hidden API之所以被隐藏，是想阻止开发者使用SDK中那些未完成或不稳定的部分（接口或架构）。举个例子，Bluetooth API在API 5上才开放；在API 3 和4上都是用@hide属性隐藏了。当这些API被验证和清理后，Google的开发者会移除@hide属性，并让其在API 5官方化。很多地方在API 4 和5之间发生了变化。如果你的程序依赖某些隐藏的API，当其部署到新的平台上时，就有可能陷入困境。

        对于internal API来说，从来都没有计划将其开放出来。它就是Android的“内部厨房”，对开发者来说，应该将其视作黑盒。凡事都会有变化的。如果你依赖某些 internal API，也有可能在新的Android release上，这些internal API发生变化，从而令你失望。

         总结一下区别：

        Hidden API = 进行中的工作；

        Internal API = 黑盒；

         Internal和hidden API的编译时 vs. 运行时
        当你使用Android SDK进行开发的时候，你引用了一个非常重要的jar文件——android.jar。它位于Android SDK平台的文件夹中（SDK_DIR/platforms/platform-X/android.jar，其中，X表示API等级）。这个 android.jar移掉了com.android.internal包中所有的类，也移掉了所有标记有@hide的类，枚举，字段和方法。

        但当你在设备上启动应用程序时，它将加载framework.jar（简单来说，它和android.jar等同），而其未移掉internal API和hidden API。（但它对开发者来说，并不能友好地访问，因此，我将向大家展示不通过反射如何使用这些API）。

       关于internal API，还有一件事需要说明。Eclipse的ADT插件增加了一个额外的规则，那就是禁止使用com.android.internal包中的任何东 西。所以，即便是我们可以拿到最原始的android.jar（未删减版），也没有轻松的办法通过Eclipse使用这些internal API。

        你可以亲自检查一下。创建一个新的Android工程（或者使用已有的）。查看一下它引用的类库（右击project Properties –> Java Build Path –> Libraries）。

        重要的总结：internal和hidden API在SDK中是按照一样的方式处理的（都从android.jar中移除了），但internal API更惨的是，还被Eclipse的ADT插件显式禁止了。

        不通过反射使用internal和hidden API

         这些的终极目标是让开发者能够不通过反射使用Internal和Hidden API。如果你完成了接下来部分中描述的步骤，你将能使用这些Internal和Hidden API，如同公开的API。你不再需要使用反射。

2

在上一篇中，我解释了为什么我们不通过反射就会很难使用internal和hidden API。这是因为android.jar中就没包含这些API，因此，没人能够在编译时引用这些类。

       这篇文章将描述如何还原最初的android.jar。这将允许我们像使用公开的API那样使用internal和hidden API。

       如何得到原版android.jar？

       我们需要修改android.jar，这样它才能包含所有的*.class文件（包括internal和hidden API类）。有两种办法：
       1） Android是一个开源工程。我们可以下载源码并搭建编译环境，这样它就不能移除那些internal和hidden的类了。这个办法比较困难；
        2） 每个模拟器或真机在运行时都会有一个等同android.jar的东西。我们可以从这里拿到jar文件，提取出原始的.class文件，并拷贝到Android SDK的android.jar中。

        我将采用方案2。它易于开始，还不需要搭建Linux环境及编译环境等。

        从设备上获取framework.jar

        你可以使用命令行（adb pull）从模拟器或设备上下载文件，或者使用DDMS（借助Eclipse或SDK中的应用）。

        注意：模拟器通常在.dex文件中包含代码，而真机一般在优化版的dex文件中包含代码——odex文件。操作odex文件比较困难，这也是为什么我选择模拟器的原因。

        与Android SDK中的android.jar等同的文件是framework.jar。这个文件位于设的：/system/framework/framework.jar
adb pull /system/framework/framework.jar当framework.jar从设备上下下来之后，重命名为framework.zip并解压到独立的文件夹中，看起来是这个样子的：

       classes.dex正是我们需要的。

        创建framework-classes.zip

       首先，我们需要把.dex文件转换成.jar格式。你可以使用通用的工具dex2jar。只需要运行：

dev2jar classes.dex

        当转换结束时，你应该得到了classes.dex.dex2jar.jar文件。重命名为framework-classes.zip。使用zip查看器，进入到framework-classes.zip/com/android/internal/：

         创建original-android.jar

       Android SDK的android.jar位于ANDROID_SDK/platforms/android-X/android.jar（X表示API等级）。

       拷贝android.jar成custom-android.jar。解压至custom-android文件夹。将framework- classes.zip中所有的.class文件拷贝到custom-android文件夹中（你需要覆盖所有已经存在的.class文件）。

       然后，压缩custom-android文件成original-android.zip。

       步骤总结
       1. 选择你的目标平台X
       2. 创建目标平台X的模拟器
       3. 启动模拟器，下载/system/framework/framework.jar
       4. 重命名framework.jar -> framework.zip
       5. 从framework.zip中抽取classes.dex
       6. 使用dex2jar工具，将其转换成classes.jar
       7. 重命名classes.jar -> framework-classes.zip
       8. 拷贝android.jar –> custom-android.zip
       9. 解压custom-android.zip至custom-android文件夹
       10. 将framework-classes.zip中所有文件拷贝至custom-android文件夹（覆盖存在的文件）
       11. 压缩custom-android文件夹成original-android.zip
       12. 重命名original-android.zip ->  original-android.jar

3.

 在上一篇中，我已经展示了如何创建一个包含所有internal和hidden API的original-android.jar。
接下来的工作就是要修改已经存在的Android平台（SDK_DIR/platforms/platform-X/android.jar，X表示API 等级）。你可以直接使用Part2中创建的original-android.jar替换android.jar。但这样的话，你的所有工程都将直接使用 internal和hidden API而没有任何限制。这不够方便，因为在多数的工程中你不希望这样。甚至，你可能更希望禁止这些API（ADT/android.jar的默认行为）。 但对于一些特定的工程，你希望能够使用这些internal和hidden API。
为了达到这样的灵活性，你需要创建一个新的自定义的Android平台。当不需要访问internal和hidden API时，你只需使用原有的Android平台。当你使用这些API时，你使用自定义的Android平台。

       Android SDK文件夹结构

       让我们看一下Android SDK树是如何组织的：

        我们需要“platforms”文件夹。看一下里面：

       这里列出了支持的Android平台。

       现在，我们看一下它是如何与Eclipse设定关联的。选择你的工程，右击–> Properties –> Android。你将会看到一组支持的Android平台（与…/platforms/folder相似）。下面是截图：

       创建新的平台

       为了创建一个新的平台，我们需要拷贝android-9文件夹 -> android-9-internals。让我们做一些修正：

       1. 删除其中的android.jar

       2. 拷贝original-android.jar，并改名为android.jar

       3. 修改build.prop文件：

        重启Eclipse。并确认你能看到新的平台。下面是我所看到的：

       为什么我选择API等级为9？这是因为它必须是一个数字，而且它不能是9（或者其它已经存在的API等级）。否则，你自定义的平台将不能被使用（它在列表里可见，但选中后也不能正常工作，编译时仍然使用相应API等级的原始平台）。

       下面是引用类库的截图（当前工程选中了自定义的平台）：

         总结

       在上一篇中，我已经告诉你如何创建一个未删节版的 android.jar。在这一篇中，我向你展示了如何创建一个自定义的Android平台，并在其中使用original-android.jar。这 对于hidden API来说已经足够了。但对于internal API来说，还需要另一步。这是因为ADT仍然不允许使用com.android.internal包中的类。下一节我将向你展示如何定制ADT来允许使用internal包中的类。


4.
在上一篇文章里，我描述了如何创建一个自定义的original-android.jar，以及如何创建一个自定义的Android平台来使用这个 original-android.jar。这对Hidden API来说足够了。但对Internal API来说，仍然还有一个包袱：Eclipse的ADT插件。它限制使用com.android.internal包中的任何类。

         有几种方法可以解决这个访问限制。

        1） ADT源码可以下载。因此，删除/修改代码中的某些代码，从而编译出一个新的ADT是可以的。麻烦的是你需要搭建64位Linux系统，下载源码，编译等。它需要花费一些时间。当有新的ADT版本时，你需要重来一遍。

        2） 另外的方法就是修改ADT的字节码。用一个类似于“com/android/internax/**”的字符串替换“com/android/internal/**”。

       第二种方法可以用脚本实现。并且不需要访问源码以及可在Windows上操作。这也是为什么我在这篇中选用第二种解决方案的原因。

         修改ADT的字节码
       进入Eclipse的plugins文件夹。找到文件名看起来像“com.android.ide.eclipse.adt_*.jar”的文件。备份一下 这个文件（以防中间有错误发生）。并拷贝这个文件到一个“experimental”文件夹，在这里，我们要完成对其字节码的修改。

       重命名*.jar为*.zip。解压这个文件到单独的文件夹。参看以下图片：

        现在，进入到com/android/ide/eclipse/adt/internal/project子文件夹。
        找到AndroidClasspathContainerInitializer.class文件。

        这个文件包含“com/android/internal/**”字符串。接下来就是要替换这个字符串，例如“com/android/internax/**”。改变字符串的长度理论上是安全的，但最好还是替换其中的一个字母，并保持长度一致。

        我使用notepad++修改的，它支持非可印刷字符，因此在对其修改时，不要触碰修改非可印刷字符。

        当做完这个，保存文件。压缩这个文件夹，保证文件名与原始文件一模一样。在我这里，文件名是：com.android.ide.eclipse.adt_8.0.1.v201012062107-82219.zip。

        注意：确保压缩文件的正确性。比较原始文件和修改文件的根文件结构。现在，用修改后的版本替换原来的ADT的*.jar文件。然后，启动Eclipse。在使用库窗口，你应该看到下面的样子，一切都变得那么的美好：

         步骤总结

        1. 关闭Eclipse

        2. 从Eclipse的plugin文件夹中拷贝出ADT插件的jar文件

        3. 重命名.jar -> .zip，然后解压至独立的文件夹

        4. 找到com/android/ide/eclipse/adt/internal/project/AndroidClasspathContainerInitializer.class文件

        5. 用“com/android/internax/**”替换“com/android/internal/**”

        6. 压缩这个文件夹

        7. 重命名 .zip -> .jar

        8. 用修改后的jar替换原始的ADT jar文件

        9. 启动Eclipse

注意： 关于第4条，即修改android.jar 的Access Rules问题，可以不修改Eclipse中的插件adt相关的jar，而是通过在修改java的编译方式，即Windows-------->Preferences------->Java----------->Compiler------------->Errors/Warnings---------->Deprecated and restricted Api--------->Forbidden references(access rules)将其改成Ignore 或者 Warning。而且在按第四条进行的时候，Android工程中的System Library都出问题了，即不能找到android.jar。所以感觉还是修改编译选项比较好。