如何向android的framework里添加新API
http://yueguc.iteye.com/blog/806730
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把你的目錄加進去。然后就好了。
http://yueguc.iteye.com/blog/806730
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把你的目錄加進去。然后就好了。