一、使用场景

• 增加系统API
• 修改@hide的API
• 修改公共API

         存在以上修改后，都需要先执行make update-api，然后再make

二、缘起

1. 在以上使用场景下，编译系统源码都会出现如下提示

see build/core/apicheck_msg_current.txt
******************************
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.txt by executing the following command:
         make update-api

      To submit the revised current.txt to the main Android repository,
      you will need approval.
******************************

2. 提示信息表明API存在错误

谷歌对于所有的类和API，分为开方和非开放两种，而开放的类和API，可以通过“Javadoc标签”与源码同步生成“程序的开发文档”；当我们修改或者添加一个新的API时，我们有两种方案可以避免出现上述错误.

方案1：将该接口加上非公开的标签：/** @hide */ ；
方案2：修改后执行：make update-api(公开)，将修改内容与API的doc文件更新到一致。

-------------------------------------------------------------------------------------------------------------------

关于“方案1”需要注意的是，并不是简单写个＠hide 或者 /*@hide*/ 就可以了，这些都是错误的javadoc注释格式，标准的javadoc都是这样的 /**  */ 而且对于 format 变量 应该加上 {  }。以我们应该这样写  /** {@hide} */

错误javadoc注释格式
  示例1： /* @hide */
  示例2： /*
                    *@hide
                    */