Android Studio Canary版build.gradle可用函数官方文档查询问询

官方文档查询方式 #

• 打开对应Canary版本的Android Studio，在build.gradle文件中将光标定位到需要查询的函数上，按Ctrl+Q（Windows/Linux系统）或F1（macOS系统）即可呼出对应函数的官方原生说明，包含参数定义、适用版本、废弃提示等内容，是和你当前使用的Android Gradle Plugin（AGP）版本完全匹配的最权威信息。
• 如需查看全量AGP可用API列表，可打开本地SDK存储目录，找到docs/android gradle plugin/reference/路径，该目录下的离线文档和你通过SDK Manager下载的AGP版本完全对应，Canary版本的预览API也会在对应版本的离线文档中同步更新。

函数合法性核对操作 #

• 首先确认项目根目录build.gradle文件中声明的com.android.tools.build:gradle插件版本号，Canary版本对应的AGP版本一般为带-alpha/-beta后缀的预览版本，所有build.gradle的函数可用性都和该版本严格绑定，和Android Studio本身的版本无直接关联。
• 遇到报错函数时先检查Android Studio的语法高亮提示：如果函数被标记为红色，或者代码补全列表中没有对应选项，基本可以判定该函数在当前AGP版本中不存在、已废弃或已更名。
• 对于从旧版本AGP迁移来的配置，优先使用Android Studio提供的快速修复功能：把光标放在报错的配置项上，按Alt+Enter（Windows/Linux系统）或Option+Enter（macOS系统），系统会自动给出适配当前AGP版本的替换方案。

注意事项 #

• 不要直接复制非对应AGP版本的构建配置代码：网上公开的大部分配置都是针对稳定版AGP编写的，Canary预览版的AGP会频繁调整API，直接套用很容易出现函数不存在的报错。
• 如果你需要测试预览版的新API，可参考Android Studio内置新建项目模板中的build.gradle配置，模板中用到的所有函数都是当前版本合法可用的标准写法。

内容的提问来源于stack exchange，提问作者Zacki