如何向Android的framework里添加新类 &&& android修改开放类方法

http://www.61ic.com/Mobile/Android/201106/35020.html

google对于所有的类和API，分为开放式和不开放式两种。

所谓的开放式就是值javadoc所包含的，并不是java中有public和private，而是跟javadoc有关系，代码没有关系。
在开放式的类中增加了一个变量，而又没隐藏，导致和原API的doc不一致造成的就会有错。
通过提示，有2个方法可以解决该问题：
1、将新增加的变量或方法加上"@hide" 的注释，注意一点，加"@hide" 不是简简单单的/*@hide */就行了，标准的javadoc要这样 /** */ 而且对于 format 变量应该加上 { }，也就是/**{@hide}*/
2、如果想在生成的doc中增加该变量或方法的话，必须输入：
make update-api
这样的话，系统自动将新增加的API添加到current.xml中了。

所以如果要加方法就是按上面的方法加。
如果需要加进新的类这时候又分2种一种是原有的包下面加类这个最简单加完之后直接make update－api就好了还有一种是加在framework/base下面这个时候你make update－api是不会在current。xml里生成你的类的。看了Android。mk才知道原来需要修改android源码根目录下的build/core/pathmap.mk把你的目录加进去。然后就好了。

android修改开放类方法
http://blog.sina.com.cn/s/blog_5f35912f0100rwnx.html

当我们修改了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: 1) You can add "@hide" javadoc comments to the methods, etc. listed in the errors above.
2) You can update current.xml by executing the following command: make update-api
To submit the revised current.xml to the main Android repository, you will need approval. ******************************
但是如果修改的是google没有开放出来的类，比如RIL，PhoneFactory，就不会出现这个问题。
google 给了两个选择:
1. 在你添加的API或者变量前面，增加javadoc 注释＠hide。但是要注意的是，并不是简单写个＠hide 或者就可以了，这些都是错误的javadoc注释格式，标准的javadoc都是这样的而且对于 format 变量应该加上 { }，所以我们应该这样写
2. 你就是想要生成的javadoc里面出现这个方法或者变量，你必须输入: make update-api，即编译时，输入make update-api PRODUCT-***-eng，但是输入 make PRODUCT-***-eng update-api 这样是有问题的，因为后面的update-api会被忽略掉，这样系统就会自动的把我们新增的API 写入 frameworks/base/api/current.xml 文件中。
以上两个方案可以很好的解决新增API的问题，而这个问题是我们以后常常遇到的。

更多相关文章

随机推荐