第20章 The Build Environment 构建环境
最后更新于：2022-04-01 02:33:06
## 20.1\. 通过 gradle.propert 配置构建环境
Gradle 提供几个选项,使它容易配置将用于执行构建的 Java 进程。同时可以通过 GRADLE_OPTS 或 JAVA_OPTS 配置这些在你本地环境,包含的设置包括比如 JVM 内存设置,Java home,守护进程开/关,它们可以和你的项目在你的版本控制系统中被版本化的话，将会更有用，这样整个团队就可以使用一致的环境了。在你的构建当中，建立一致的环境，就和把这些配置放进 gradle.properties 文件一样简单。这些配置将会按以下顺序被应用（以防在多个地方都有配置时只有最后一个 生效）
* 从 gradle.properties 在项目构建 dir。
* 从 gradle.properties 在 gradle user home.
* 从系统属性,例如当 -Dsome.property 在命令行上设置。
可以使用以下属性来配置 Gradle 构建环境:
org.gradle.daemon
当设置为true 时，Gradle 守护进程会运行构建。对于本地开发者的构建而言，这是我们最喜欢的属性。开发人员的环境在速度和反馈上会优化，所以我们几乎总是使用守护进程运行 Gradle 作业。由于 CI 环境在一致性和可靠性上的优化，我们不通过守护进程运行 CI 构建（即长时间运行进程）
org.gradle.java.home
为 Gradle 构建进程指定 java home 目录。这个值可以设置为 jdk 或jre 的位置，不过，根据你的构建所做的，选择 jdk 会更安全。如果该设置未指定，将使用合理的默认值。
org.gradle.jvmargs
指定用于该守护进程的 jvmargs。该设置对调整内存设置特别有用。目前的内存上的默认设置很大方。
org.gradle.configureondemand
启用新的孵化模式，可以在配置项目时使得 Gradle 具有选择性。只适用于相关的项目被配置为在大型多项目中更快地构建。请参阅 [Section 57.1.1.1, “Configuration on demand”.](http://gradle.org/docs/current/userguide/multi_project_builds.html#sec:configuration_on_demand)
org.gradle.parallel
如果配置了这一个，Gradle 将在孵化的并行模式下运行。
### [](https://github.com/waylau/Gradle-2-User-Guide/blob/master/Chapter%2020.%20The%20Build%20Environment%20%E6%9E%84%E5%BB%BA%E7%8E%AF%E5%A2%83.md#2011-forked-java-processes)20.1.1\. Forked Java processes
许多设置（如 Java 版本和最大堆大小）只能在启动一个新的 JVM 构建进程时指定。这意味着 Gradle 在分析了各种 gradle.properties 文件之后，必须启动一个单独的 JVM 进程，以执行构建操作。当通过守护进程运行时，带有正确参数的 JVM 会启动一次，并在每次的守护进程构建执行时复用。当不通过守护进程执行 Gradle 时，在每次构建执行中都必须启动一个新的 JVM ，除非 JVM 是由 Gradle 启动脚本启动的，并且恰好具有相同的参数。
在执行每个构建时运行一个额外的 JVM 的代价是非常昂贵的，这就是为什么我们强烈推荐您使用 Gradle 守护进程，如果你指定了org.gradle.java.home 或 org.gradle.jvmargs。更多详细信息，请参阅[Chapter 19\. The Gradle Daemon 守护进程](https://github.com/waylau/Gradle-2-User-Guide/blob/master/Chapter%2019.%20The%20Gradle%20Daemon%20%E5%AE%88%E6%8A%A4%E8%BF%9B%E7%A8%8B.md)。
## [](https://github.com/waylau/Gradle-2-User-Guide/blob/master/Chapter%2020.%20The%20Build%20Environment%20%E6%9E%84%E5%BB%BA%E7%8E%AF%E5%A2%83.md#202-accessing-the-web-via-a-proxy-通过代理访问-web)20.2\. Accessing the web via a proxy 通过代理访问 web
配置 HTTP 代理服务器 （例如用于下载依赖） 是通过标准的 JVM 系统属性来做的。这些属性可以直接在构建脚本中设置；例如设置代理主机为System.setProperty （'http.proxyHost', '[www.somehost.org'）。或者，可以在构建的根目录或](http://www.somehost.org%27%29.xn--%2C-306a34nlzd97mvpa77mga126j0vb7y9enbbcy4e/)Gradle 主目录中的 gradle.properties 文件中指定这些属性。
xample 20.1\. Configuring an HTTP proxy
gradle.properties
~~~
systemProp.http.proxyHost=www.somehost.org
systemProp.http.proxyPort=8080
systemProp.http.proxyUser=userid
systemProp.http.proxyPassword=password
systemProp.http.nonProxyHosts=*.nonproxyrepos.com|localhost
~~~
对于 HTTPS 有单独的设置。
Example 20.2\. Configuring an HTTPS proxy
gradle.properties
~~~
systemProp.https.proxyHost=www.somehost.org
systemProp.https.proxyPort=8080
systemProp.https.proxyUser=userid
systemProp.https.proxyPassword=password
systemProp.https.nonProxyHosts=*.nonproxyrepos.com|localhost
~~~
我们无法很好地概述所有可能的代理服务器设置。其中可以去看的一个地方是 Ant 项目的一个文件中的常量。这里是Subversion 的视图的[链接](http://svn.apache.org/viewvc/ant/core/trunk/src/main/org/apache/tools/ant/util/ProxySetup.java?view=markup&pathrev=556977)。另一个地方是 JDK 文档的[Networking Properties(网络属性)](http://download.oracle.com/javase/6/docs/technotes/guides/net/properties.html)。如果有人知道更好的概述，请发邮件让我们知道。
### [](https://github.com/waylau/Gradle-2-User-Guide/blob/master/Chapter%2020.%20The%20Build%20Environment%20%E6%9E%84%E5%BB%BA%E7%8E%AF%E5%A2%83.md#2021-ntlm-authentication)20.2.1\. NTLM Authentication
如果您的代理服务器需要 NTLM 身份验证，您可能需要提供验证域，以及用户名和密码。有两种方法可以向 NTLM 代理提供验证域：
* 将 http.proxyUser 系统属性设置为一个这样的值：域/用户名。
* 通过 http.auth.ntlm.domain 系统属性提供验证域。