android修改开放类方法
当我们修改了google 开放出来的类。所谓开放的类与开放的API,这个只是javadoc的范畴,并不是java中public和private,也就是说,对于源码的编译无所谓,只是对javadoc的生成有影响关于类的开放和隐藏,是通过doc的注释{@hide}来控制的。比如 Environment
******************************You have tried to change the API from what has been previously approved.
To make these errors go away, you have two choices:
但是如果修改的是google没有开放出来的类,比如RIL,PhoneFactory,就不会出现这个问题。
google 给了两个选择:
1. 在你添加的API或者变量前面,增加javadoc 注释@hide。但是要注意的是,并不是简单写个@hide 或者 就可以了,这些都是错误的javadoc注释格式,标准的javadoc都是这样的 而且对于 format 变量 应该加上 {
2. 你就是想要生成的javadoc里面出现这个方法或者变量,你必须输入:
以上两个方案可以很好的解决新增API的问题,而这个问题是我们以后常常遇到的。