放置 Gradle 的配置文件以及 wrapper 等，projects 目录用来存放所有研发项目，deps 目录用于存放 projects中项目依赖的项目，一般是外部的git源项目。

实际项目存放的地点。

这些项目也可能是来自不同的仓库，例如 git、subversion 等，不同的项目组可能会下载不同的项目于依赖模块，这时候只需要配置一下顶级目录中的 settings.gradle，管理好 include 即可。

• 所有子项目
  • eclipse： 用于生成 eclipse 配置
  • idea： 用于生成 intelliJ IDEA 配置
  • java
• Web 子项目
  • war： 用于打 war 包，注意：这儿做了一些处理，war默认打的包带有 SNAPSHOT 后缀，如果想打发布版的 war 包，可采用 gradle release
  • eclipse-wtp： 用于生成 wtp 配置，建议配合 eclipse 的 Gradle 插件使用，很方便地将项目依赖的 jar 作为 eclipse 的 libraries，保持 WEB-INF/lib 目录干净清爽

• versions： 用于检测jar包是否有新版本，命令为 gradle dependencyUpdates
• gradle.templates： 用于生成项目目录结构，命令较多，可采用 gradle tasks 查看。顶级目录下有个 templates 目录，里面可以自己定义一些模板来代替这个工具的默认模板

将所有的 jar 的定义放置到了 dependencyDefinitions.gradle 中，然后在顶级目录的 build.gradle 中引入：

apply from: 'dependencyDefinitions.gradle'

该文件内容为：

 ext.versions = [
     spring: '3.2.5.RELEASE',
     security: '3.1.4.RELEASE',
     jackson: '1.9.13',
     logback: '1.0.13',
     slf4j: '1.7.5',
     httpclient: '4.3.1',
 ]

 
ext.libraries = [
	"servlet-api": "javax.servlet:servlet-api:2.5",
	"jsp-api": "javax.servlet:jsp-api:2.0",

	"ebean": "org.avaje.ebeanorm:avaje-ebeanorm:3.2.4",
	"persistence-api": "javax.persistence:persistence-api:1.0",

	"aspectjweaver": "org.aspectj:aspectjweaver:1.7.4",
	...
]

在各个子项目的 build.gradle 中就只需要写 libraries.'ebean' 即可，将来升级的时候方便。

这个命令可以很方便地检查 jar 的依赖情况，显示的是简单的树形结构，因为在命令行下会显示太多行，所以可以将其输出到一个文本中再看：

gradle dependencies > depend.log

通过这个命令极大简化了 ext.libraries 定义，那些自动会依赖的 jar 包就不需要再写了。

这是个经典的问题，当然，用了IDE 之后已经见不到此问题，所以在 gradle 编译的时候再次发现此问题的时候都有点故人复见的感觉了。

想当年初学 java 的时候采用命令行编译的诸位应该都会有这个感觉吧。

解决办法很简单，增加一行设置即可：

[compileJava, compileTestJava]*.options*.encoding = 'UTF-8'

在顶级目录下有个 .gradle 文件夹，这个是 gradle 自动生成的，可以在 git 的 .gitignore 文件中增加一条忽略掉：

.gradle/

顶级目录libs 文件夹里面的 jar 是对所有项目都起作用的。

如果是某个项目自用的，则可以在该项目的 source 下面创建个 libs，具体实现是在顶级目录下的 build.gradle 中：

ext.jarTree = fileTree(dir: 'libs', include: '**/*.jar')
ext.rootProjectLibs = new File(rootProject.rootDir, 'libs').getAbsolutePath()
ext.jarTree += fileTree(dir: rootProjectLibs, include: '**/*.jar')

compile jarTree

Gradle 有几种办法可以用来管理这些设置，例如将配置文件按环境写在 build 文件的不同块中。

• resources： 通用配置放在这儿
• resources-dev： 开发环境配置
• resources-prod： 生产环境配置

在用 gradle eclipse 命令生成 IDE 配置的时候，会默认将前两个目录包含在 eclipse 中，只有通过 gradle release 生成 war 包的时候才会忽略 dev，使用 prod。

打 war 包时候有两种方式：

• gradle war： 测试用的 war 包，文件后缀增加 SNAPSHOT，采用的是 resources-dev。
• gradle release： 生产用的 war 包，采用的是 resources-prod。