Android 更新系统api接口需要同时提交current.txt

修改framework/base下面的api要注意更新api/current.txt文件

更新android系统接口后,只是提交java文件会导致其他人编译不通过,需要提交/framework/base/api下面更新的三个问文件:

 

如果修改了Android原有API的 ,需要update frameworks/base/api/current.txt。否则编译被中断并出现编译错误提示。

否则,编译时会报以下错误:

frameworks/base/services/java/com/android/server/SystemServer.java:592: cannot find symbol
symbol  : variable PPPOE_SERVICE
location: class android.content.Context

可以通过运行 make update-api 后,自动更新此文件,检查确认正确后,跟代码一起提交即可。

切记:不能手动更改api/current.txt文件去更新。
--------------------------------------------------------------------------------------------------------------------------------------

 

当我们对framework/base/下新增aidl,也就是新增向上api的时候,编译容易出现以下的错误:

frameworks/base/api/system-current.txt:25031: error 8: Removed public class android.os.IXxxService
frameworks/base/api/system-current.txt:25036: error 8: Removed public class android.os.IXxxService.Stub
out/target/common/obj/PACKAGING/system-api.txt:25035: error 3: Added class IXxxService to package android.os
out/target/common/obj/PACKAGING/system-api.txt:25040: error 3: Added class IXxxService.Stub to package android.os

这是因为新增或者修改的api没有及时同步到/frameworks/base/api/system-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.
******************************

这个时候我们就需要先执行:

# make update-api

进行同步,再对代码进行编译便可解决上面的问题。
-------------------------------------------------------------------------------------------------------------------------------------

何时需要执行make update-api命令

添加系统API或者修改@hide的API后,需要执行
make update-api,然后再make
修改公共api后,需要
make update-api

1、在修改完系统Api或部分公共Api后(常见于修改Intent.java、KeyEvent.java等等),执行源码编译时会有如下提示
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时,我们有两种方案可以避免出现上述错误.

一是将该接口加上 非公开的标签:/*{@hide}/;
二可以在修改后执行:make update-api(公开),将修改内容与API的doc文件更新到一致。
3、解决办法:
执行: make update -api ;
修改后相应API文件后,在base库下面会产生“.current.txt”文件的差异,提交时将该差异一并提交审核即可。

 

posted @ 2019-08-02 10:12  YOUNG++  阅读(8148)  评论(0编辑  收藏  举报