使用内部(com.android.internal)和隐藏(@hide)API[第1部分，介绍]

浏览数：192 / 时间：2015年06月11日

本文翻译自http://devmaze.wordpress.com/2011/01/18/using-com-android-internal-part-1-introduction/#more-79

Android有两类API在SDK中不能使用。

第一类就是位于包com.android.internal的API，我将这些API称为内部API。第二类API就是用@hide标记的类和函数，虽然严格说这不是一个API而是一系列隐藏API的集合，我仍然假定这是一个API，称为隐藏API。

隐藏API的例子

你阅读android的源码，就会发现有些常量、函数和类标记为@hide.

这里有一个隐藏常量的例子，来自WifiManager(source code of API Level 10).

另外一个例子是隐藏函数setWifiAppEnabled，来自WifiManager(source code of API Level 10).

所以您只要看到@hide属性，这就是一个隐藏API。

内部API和隐藏API的不同

隐藏API隐藏是为了防止开发人员使用SDK中未完成或者未稳定（接口和架构方面看）的部分。比如，Bluetooth API在API Level 5（android 2.0）之前就存在，但在API Level 3和4（android 1.5和1.6）中使用@hide隐藏起来了。当该API稳定下来，google的开发人员移除@hide属性，在API Level 5中就有Bluetooth API了。还有很多东西在Level 4和5之间发生了变化。如果程序依赖于某些隐藏API，可能会在新版本的Android OS上运行出现问题。

而内部API则不计划对外开放。这是android的内部餐厅，开发人员可以视为黑盒子。这里面的东西同样可能发生改变。同样的，如果您的程序依赖于内部API，在新的Android发布后，可能遇到麻烦。

下面总结它们之间的不同：

隐藏API = 正在开发中；

内部API = 黑盒

内部和隐藏API的编译时和运行时对比

当您使用Android SDK进行开发时，会引用一个非常重要的jar文件android.jar。它位于Android SDK的平台目录SDK_DIR/platforms/platform-X/android.jar（其中X为API Level，可以是5或者10或其它的数字）。在android.jar中，com.android.internal中所有的类移除了，同样的，所有标记为@hide的类、枚举、字段、方法也移除了。

但是当您在设备中运行应用程序时，加载的是framework.jar（大约等价于android.jar），它没有被裁减，包含所有的内部类和隐藏API。所以您可以使用反射机制来访问隐藏API和内部API（当然，这种方法使用起来不太方便，下面我将介绍不使用反射机制访问这些API的方法）。

关于内部API还有一些特别。Eclipse的ADT插件增加了一条额外规则，禁止使用来自com.android.internal包的任何东西。所以，即使您使用了原始（未裁减）的android.jar，也不容易在eclipse中使用内部API。

您可以自己检查一下。在eclipse中创建一个新的Android工程（或使用现有的），查看它的引用库（右键点击工程，Properties –> Java Build Path –> Libraries）。