微信号:mobdev

介绍:分享 kvh 对于技术、创业的理解和实践

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

2016-06-06 08:22 kvh

命令行

很多做 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』微信公众号二维码


可以通过点击【阅读原文】访问文中的链接。

 
KVH 更多文章 Android开发如何选择测试机列表 面向开发者服务的用户体验 拥抱 Android Studio 一从 ADT 到 Android Studio 拥抱 Android Studio 之二:Android Studio 与 Gradle 深入 拥抱 Android Studio 之三:溯源,Groovy 与 Gradle 基础
猜您喜欢 阿里云ecs上用nginx+uwsgi搭建flask运行环境 快来看程序员必备的网站,哪个你不知道? 还在用 Toast?试试 Snackbar! 数据说话:怎样的程序员最抢手? AWS 及 IAM 答疑