為android開放類增加自訂成員方法

來源:互聯網
上載者:User

    android SDK中有些JAVA類是開放的,有些是不開放的,API同樣如此。這裡所謂開放的類或API,只是javadoc的範疇,並不是java中public和private,也就是說,對於源碼的編譯無所謂,但是對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,就不會出現這個問題,

相關文章

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.