Chapter 14. Tutorial - ‘This and That’ 教程-这个那个

    Example 14.1. Directory creation with mkdir

    build.gradle

    执行 gradle -q compile 输出

    1. > gradle -q compile
    2. The class directory exists. I can operate

    14.2. Gradle properties and system properties 属性

    Gradle 提供了许多方式将属性添加到您的构建中。 从 Gradle 启动的 JVM，你可以使用 -D 命令行选项向它传入一个系统属性。 Gradle 命令的 -D 选项和 java 命令的 -D 选项有着同样的效果。

    此外，您也可以通过属性文件直接向您的 project 对象添加属性。您可以把一个 gradle.properties 文件放在 Gradle 的用户主目录 （默认如果不是 USER_HOME /.gradle 设置的话，就由 “GRADLE_USER_HOME” 环境变量定义 ） ，或您的项目目录中。对于多项目构建，您可以将 gradle.properties 文件放在任何子项目的目录中。通过 project 对象，可以访问到 gradle.properties 里的属性。用户的主目录中的属性文件比项目目录中的属性文件更先被访问到。

    你还可以通过使用 -P 命令行选项来直接向您的 project 对象添加属性。

    也可以通过 特别命名的系统属性 或者环境属性把属性设置 project 属性。这个特性非常有用，通常出于安全原因，当你在持续集成的服务器没有管理员权限时，对于设置属性值你是不可见的。在这种情况下，你就不能使用 -P 选项，也不能修改系统级别的配置文件。正确的策略是，要改变你的持续集成配置建设工作，增加一个环境变量设置符合预期的模式。这不会对系统正常的用户可见的。（ Jenkins, Teamcity, 或者 Bamboo 是这些 CI （Continuous Integration 持续集成）服务商，提供这些功能）

    如果环境变量名称类似与 ORG_GRADLE_PROJECT_prop=somevalue, Gradle 将会设置 prop 属性到你的 project 对象，值就是 somevalue 。Gradle 也提供了系统属性的支持，但有着不同命名方式，类似的 org.gradle.project.prop

    Example 14.2. Setting properties with a gradle.properties file

    gradle.properties

    1. gradlePropertiesProp=gradlePropertiesValue
    2. sysProp=shouldBeOverWrittenBySysProp
    3. envProjectProp=shouldBeOverWrittenByEnvProp

    build.gradle

    执行 gradle -q -PcommandLineProjectProp=commandLineProjectPropValue -Dorg.gradle.project.systemProjectProp=systemPropertyValue printProps 输出

    1. > gradle -q -PcommandLineProjectProp=commandLineProjectPropValue -Dorg.gradle.project.systemProjectProp=systemPropertyValue printProps
    3. gradlePropertiesValue
    4. systemPropertyValue
    5. envPropertyValue
    6. systemValue

    当你要使用一个变量时，你可以仅通过其名称在构建脚本中访问一个项目的属性。如果此属性不存在，则会引发异常，并且构建失败。如果您的构建脚本依赖于一些可选属性，而这些属性用户可能在比如 gradle.properties 文件中设置，您就需要在访问它们之前先检查它们是否存在。你可以通过使用方法 hasProperty(‘propertyName’) 来进行检查，它返回 true 或 false。

    你可以使用一个外部构建脚本配置当前 project 。所有的 Gradle 构建语言都可用在外部脚本。。您甚至可以在外部脚本中应用其他脚本。

    Example 14.3. Configuring the project using an external build script

    build.gradle

    1. apply from: 'other.gradle'
    2. other.gradle
    4. println "configuring $project"
    5. task hello << {
    6.     println 'hello from other script'

    14.4. Configuring arbitrary objects 配置任意对象

    您可以用以下非常易理解的方式配置任意对象。

    Example 14.4. Configuring arbitrary objects

    build.gradle

    2.     def pos = configure(new java.text.FieldPosition(10)) {
    3.         beginIndex = 1
    4.         endIndex = 5
    5.     }
    6.     println pos.beginIndex
    7.     println pos.endIndex
    8. }

    执行 gradle -q configure 输出

    1. > gradle -q configure
    2. 1
    3. 5

    Example 14.5. Configuring arbitrary objects using a script

    build.gradle

    other.gradle

    执行 gradle -q configure 输出

    1. > gradle -q configure
    2. 5

    14.6. Caching 缓存