Android中使用@hide成员

@hide

Android中使用@hide（javadoc格式）标记的API，在编译时不对外开放，但在运行时可以正确访问。之所以要将一些API隐藏，很大的原因是Android本身还在不断的进化发展，这些隐藏的API本身可能是不稳定的，使用隐藏API意味着程序的兼容性更差。但是，在进行底层开发、系统级应用开发或者是定制Android版本时，对@hide的使用必不可少。

Android音效基类AudioEffect中，包括构造函数在内的几乎所有成员均被@hide，导致自定义的派生类不能使用super访问基类构造函数。

使用@hide成员

方法有二：

• Java反射机制（灵活但繁琐，量少时推荐使用）
• 导入未@hide的jar包（需编译AOSP，但一劳永逸），两种方式：
  
  • 去掉AOSP源码中的@hide标记，重新编译SDK，得到未标记的android.jar包进行替换
  • 将AOSP framework编译出来的classes.jar作为User Library导入Eclipse（推荐）

本文记录的是导入classes.jar包的方法：

编译AOSP时，framework模块被编译到一个临时的classes.jar包中。该包中的API还未重新打包，里面@hide标记的API还未被去掉，所以依然能够被引用。该包的位置一般为：out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar

classes.jar作为User Library导入Eclipse：

1. 在Eclipse右击Android项目 -> Build Path -> Configure Build Path
2. Libraries选项卡：Add Library -> User Library -> User Libraries （进入到User Libraries管理界面 -> New新建一个User Library，name比如android_framework，勾选system library -> Add External Jars 把classes.jar加入到新建立的User Library中） -> OK
3. Order and Export选项卡：使用Up键，把含classes.jar的User Libraries移到Android SDK的上面（优先使用classes.jar中的API，其次使用SDK android.jar中的API） -> OK

注意，第2步中new一个User Library时需要勾选system library （added to the boot class path），否则编译时会出现“Java heap space”的错误导致Eclipse崩溃。此外，若导入jar后找不到API，请注意第3步中jar包的顺序。

参考

1. Java内存管理与反射机制
2. android使用隐藏api的方法(使用被@hide的api)
3. Eclipse中添加Android系统jar包