@hide
当对包,类,方法和域使用时,@hide从文档中删除相关节点和所有子节点。
Android有两种不能通过SDK访问的API。
第一种是在com.android.internal
包中的类。 第二种API类型是标记有@hide javadoc属性的类和方法的集合。
隐藏方法仍可以通过反射访问。@hide
属性只是javadoc的一部分(droiddoc也是),所以@hide
只是简单将方法/类/字段从API文档中排除。
例如,ActivityManager.Java中的checkUidPermission
标记为@hide
:
/** @hide */
public static int checkUidPermission(String permission, int uid) {
try {
return AppGlobals.getPackageManager()
.checkUidPermission(permission, uid);
} catch (RemoteException e) {
// Should never happen, but if it does... deny!
Slog.e(TAG, "PackageManager is dead?!?", e);
}
return PackageManager.PERMISSION_DENIED;
}
- 1
- 4
不过,我们可以使用反射调用它。
Class c;
c = Class.forName("android.app.ActivityManager");
Method m = c.getMethod("checkUidPermission", new Class[] {String.class, int.class});
Object o = m.invoke(null, new Object[]{"android.permission.READ_CONTACTS", 10010});
在你添加的API或者变量前面增加javadoc 注释@hide,但是要注意并不是简单写个@hide 或者 /@hide/ 就可以了,这些都是错误的javadoc注释格式。标准的javadoc都是这样的 /* / 而且对于 format 变量应该加上 { },所以我们应该这样写 /* {@hide} /