android SDK中有些JAVA類是開放的,有些是不開放的,API同樣如此。這裡所謂開放的類或API,只是javadoc的範疇,並不是java中public和private,也就是說,對於源碼的編譯無所謂,只是對javadoc的產生有影響關於類的開放和隱藏,但是對android的上層應用有影響,因為非開放的類或API,android上層應用無法直接存取。
類或API是否開放,是通過doc的注釋{@hide}來控制的。比如android.media.Metadata 這個類就是android沒有公開的類,因為在frameworks\base\media\libmedia\Metadata.java檔案中,定義Metadata類之前有/**{@hide}*/此doc注釋,所以Metadata類被定義為了非公開類,即是在android應用程式中無法直接存取的類。
但是如果我們在Android的公開類中添加了一些自訂的成員方法或成員變數,產生我們修改後的sdk(jar包)供上層應用程式使用,此時在編譯源碼產生SDK的過程中會出現這個問題:
******************************
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 commands:
p4 edit frameworks/base/api/current.xml
make update-api
To check in the revised current.xml, you will need OWNERS
approval.
******************************
google 給了兩個選擇:
1. 在你添加的API或者變數前面,增加javadoc 注釋@hide。但是要注意的是,並不是簡單寫個@hide 或者 /*@hide*/ 就可以了,這些都是錯誤的javadoc注釋格式,標準的javadoc都是這樣的 /** */ 而且對於 format 變數 應該加上 { }。
所以我們應該這樣寫 /** {@hide} */
2. 你就是想要產生的javadoc裡面出現這個方法或者變數,你必須輸入:
make update-api
但是如果修改的是google沒有開放出來的類,比如RIL,PhoneFactory,就不會出現這個問題,