Chapter 12. Using the Gradle Graphical User Interface 使用 Gradle 图形化用户界面

除了支持传统的命令行界面,Gradle 也提供了一个图形化用户界面(GUI)。这是一个独立的用户界面,可以通过加上 —gui 选项来启动。

Example 12.1. Launching the GUI

  1. gradle --gui

注意:此命令行窗口被将锁定,直到 Gradle GUI 被关闭。如果是在 *nix 系统下,则可以通过 (gradle —gui&) 让它作为后台任务运行。

如果你在你的 Gradle 项目目录下运行 Gradle GUI,你应该会看到一个task 树。

Figure 12.1. GUI Task Tree

Chapter 12. Using the Gradle Graphical User Interface 使用 Gradle 图形化用户界面 - 图1

最好是从 Gradle 项目目录运行此命令,这样对 UI 的设置就可以存储在你的项目目录中。当然,你也可以先运行它,然后通过在 UI 中的设置Setup 选项卡,改变工作目录。

这个 UI 上面是4个选项卡,下面则是输出窗口。

12.1. Task Tree 任务树

Task 树显示了所有项目和它们的 task 的层次结构。双击一个 task 可以执行它。

这里还提供了一个过滤器,可以把比较少用的 task 隐藏。你可以通过过滤器(Filter)按钮切换是否进行过滤。通过编辑过滤器,你可以对哪些任务和项目要显示进行配置。隐藏的任务显示为红色。注意:新创建的任务默认情况下是显示状态(而不是隐藏状态)

任务树的上下文菜单会提供以下选项:

  • 执行忽略依赖关系。这使得重新构建时不去依赖项目(与 -a 选项一样)
  • 将任务添加到收藏夹(见收藏夹 Favourites 选项卡)
  • 隐藏选择的任务。这将会把它们添加到过滤器中。
  • 编辑 build.gradle 文件。注意:该操作需要 Java 1.6 或更高的版本,并且要求在你的操作系统中关联 gradle 文件。

12.2. Favorites 收藏夹

收藏夹选项卡用来储存经常执行的命令。这些命令可以是复杂的命令(只要它们符合 Gradle 的语法),你可以给它们设置一个显示名称。它用于创建一个自定义的命令,来显示地跳过测试,文档,例子。你可以称之为“快速构建”。

你可以根据自己的喜好,对收藏夹进行排序,甚至可以把它们导出到磁盘,并在其他地方导入。如果你在编辑它们的时候,选上“始终显示实时输出”,它只有在你选上“当发生错误时才显示输出”时有效。它会始终强制显示输出。

12.3. Command Line 命令行

命令行选项卡是直接执行单个的 Gradle 命令的地方。你只需要输入在 ‘gradle’ 后面经常输入的命令即可 。它也对要添加到收藏夹的命令提供了先去尝试的地方。

12.4. Setup 设置

用来设置常用的配置

Figure 12.2. GUI Setup

Chapter 12. Using the Gradle Graphical User Interface 使用 Gradle 图形化用户界面 - 图2

Current Directory (当前目录)

定义了你的 Gradle 项目(通常是 build.gradle 所在的位置)的根目录。

Stack Trace Output (堆栈跟踪输出)

这决定了当出现错误时,有多少信息定到堆栈跟踪。注意:如果你在命令行或收藏夹选项卡上指定了堆栈跟踪级别,将会覆盖这里的设置。

Only Show Output When Errors Occur(只在出现错误时显示输出)

启用此选项将在 task 执行时隐藏任何输出,除非构建失败。

Use Custom Gradle Executor - Advanced feature(使用自定义的 Gradle 执行器 - 高级功能)

这为你提供了启动 Gradle 命令行的替代方法。这是很有用的。如果你的项目需要在另一个批处理文件或 shell 脚本中做一些额外的配置(比如指定一个初始化脚本)。