make update-api的使用

背景

需要在framework/base/core目录下添加一个变量

1.png

问题

在添加完变量之后，编译代码，发现报错

2.png

原因

错误信息表明是由于API错误导致，查阅相关文档发现：谷歌对于所有的类和API，分为开放和非开放两种，而开放的类和API可以通过“javadoc标签”与源码同步生成“程序的开发文档”；当我们修改或者添加一个新的API时，我们有两种方法可以避免出现上述错误，第一种是将该接口加上非公开的标签：/*{@hide}/;再者可以在修改后执行：make update-api(公开)，将修改内容与API的doc文件更新到一致。
解决方法

1.在根目录下执行make update-api
2.提交framework/base/api/current.txt中更新的部分

3.png

3.整编代码确认无误，代码上库

福利：最近写公众号都会自己在本地写好md文档，然后放入公众号排版的网页中先排版预览，调整效果，然后复制粘贴到公众号里面进行发布；这里推荐两个公众号排版的网址链接：https://knb.im/mp/，https://www.mdnice.com/