Android Gradle 技巧之二： 最爱命令行

Posted 2020-07-23 Bugtags

命令行

很多做 android 开发不久的同学，习惯于使用图形界面，对命令行操作很陌生甚至恐惧。遇到 AS 运行错误，束手无策。
AS 为了确保易用性，也在 UI 界面上屏蔽了很多命令行运行的细节，导致很多人觉得 AS 难用。
这种情况，我在解决用户集成使用 Bugtags SDK 的问题的时候，经常能遇到。其实 GUI 界面的操作，绝大部分情况下，也是基于命令工具的。如果你习惯了命令行，你会爱上它的，因为它简单、直接，深入。

典型错误

AS 刚推出的时候，stackoverflow 上询问最多的问题，便是进入项目的时候，一直处于：

Gradle: resolve dependancies \'_debugCompile\'

状态，一直无法前进，到底 IDE 在做什么呢？看不出来。

一句命令行

当用户遇到问题时，我最常提醒用户使用的是在项目根目录下，运行如命令行：

mac:
./gradlew clean build --info > bugtags.log
windows:
gradlew.bat clean build --info > bugtags.log

这个命令行的意思，是运行 clean 和 build 两个 gradle task，并且打开 info 参数使得输出更多的信息，最终把所有输出的信息，输出到项目根目录下的 bugtags.log 文件。用户把这个文件发给我，我根据这个输出文件，通常就能分析出问题所在。
假设命令行去除重定向输指令：

./gradlew clean build --info

信息将会输出在控制台，刚才提到的那个典型错误，可能是这样的：

其实是在下载一个比较大的文件，不用惊慌，你要做的就是 just wait! 至于是在下载什么。我想在下一篇详细描述。
如果你对基本的命令行知识有所了解，前面就已经足够了，如果你想了解更多，请继续。

扩展

在哪运行

当我给出这个命令的时候，最常见的问题，就是在哪运行。答案是控制台（Terminal）。

控制台

在 mac 下，有 terminal（bash/zsh 等），在 windows 下，则是 powershell 或者 cmd。
关键一点：

├── gradlew
├── gradlew.bat

AS 在使用 Gradle 的时候，为了灵活，或者为了应对 Gradle 系统的快速迭代，推荐使用在项目根目录中放置 Gradle 的 wrapper：gradlew 来实现对不同版本的使用。
因此，在控制台运行命令，主要是跟 gradlew 打交道。这个 wrapper，在 mac 下是一个具有执行权限的文件：gradlew，在 windows 下，是一个批处理文件：gradlew.bat。
通常，mac 下在当前目录下运行可执行文件是这样：

./gradlew xxx

windows 下在当前目录下运行批处理文件是这样：

gradlew.bat xxx

Terminal 插件

AS（Intellij IDEA）已经做了一个很实用的插件：

点击 Terminal，AS 会帮你完成下面的操作：

• 模拟打开 terminal
• cd 到当前项目根目录下

  快速定位文件夹

  IDE 还支持将项目中的某个文件夹拖放到 Terminal 窗口中实现快速定位到这个文件夹：
  

  使用 help

  要知道都有哪些 gradle 命令运行的参数，可以使用：

  $ ./gradlew --help
  USAGE: gradlew [option...] [task...]
  ...
  

  来获取。下面列举几个重要的参数。

  build 某个指定 module

  AS 推荐的结构是 multiple project 结构，即一个 project 下，管理多个 module，如果每次都要 build 全部的 project 的话，有点浪费时间，则可以使用 -p module 参数，其中 module 是你要 build 的 module：

  $ ./gradlew -p app clean build
  

  明确指定不执行某个 task

  Gradle 的命令存在依赖，例如 build task，是依赖于一系列的其他的 task，如果想要指定不执行某个 task，则可以使用 -x task 参数，其中 task 是要忽略的那个，这个参数可以传递多次。

  $ ./gradlew build -x test -x lint
  

  总结

  Gradle 的命令行还有很多其他技巧，上面只是列举到了本人日常用到最多的几个。有兴趣可以留言深入讨论。

  参考资料

  mac-terminal
  windows-terminal
  有问题？在文章下留言或者加 qq 群：453503476，希望能帮到你。
  想要及时收到最新博客文章，请关注：
  『mobdev』微信公众号二维码
  

​