第14章 Tutorial - 'This and That' 教程-這個那個

14.1. Directory creation 創(chuàng)建目錄

多個 task 依賴于現(xiàn)存的目錄，這是常見的情況。當然，你可以在 task 前添加?mkdir?但這不是好辦法，因為你只需要一次，卻要不斷重復代碼序列（看看 DRY principle ）。好的做法是在 task 間使用 dependsOn 來重用 task 創(chuàng)建目錄

Example 14.1. Directory creation with mkdir

build.gradle

def classesDir = new File('build/classes')

task resources << {
    classesDir.mkdirs()
    // do something
}
task compile(dependsOn: 'resources') << {
    if (classesDir.isDirectory()) {
        println 'The class directory exists. I can operate'
    }
    // do something
}

執(zhí)行 gradle -q compile 輸出

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

14.2. Gradle properties and system properties 屬性

Gradle 提供了許多方式將屬性添加到您的構建中。 從 Gradle 啟動的 JVM，你可以使用 -D 命令行選項向它傳入一個系統(tǒng)屬性。 Gradle 命令的 -D 選項和 java 命令的 -D 選項有著同樣的效果。

此外，您也可以通過屬性文件直接向您的 project 對象添加屬性。您可以把一個 gradle.properties 文件放在 Gradle 的用戶主目錄 （默認如果不是 USER_HOME /.gradle 設置的話，就由 “GRADLE_USER_HOME” 環(huán)境變量定義 ） ，或您的項目目錄中。對于多項目構建，您可以將 gradle.properties 文件放在任何子項目的目錄中。通過 project 對象，可以訪問到 gradle.properties 里的屬性。用戶的主目錄中的屬性文件比項目目錄中的屬性文件更先被訪問到。

你還可以通過使用 -P 命令行選項來直接向您的 project 對象添加屬性。

也可以通過 特別命名的系統(tǒng)屬性 或者環(huán)境屬性把屬性設置 project 屬性。這個特性非常有用，通常出于安全原因，當你在持續(xù)集成的服務器沒有管理員權限時，對于設置屬性值你是不可見的。在這種情況下，你就不能使用 -P 選項，也不能修改系統(tǒng)級別的配置文件。正確的策略是，要改變你的持續(xù)集成配置建設工作，增加一個環(huán)境變量設置符合預期的模式。這不會對系統(tǒng)正常的用戶可見的。（ Jenkins, Teamcity, 或者 Bamboo 是這些 CI （Continuous Integration 持續(xù)集成）服務商，提供這些功能）

如果環(huán)境變量名稱類似與 ORG_GRADLE_PROJECT_prop=somevalue, Gradle 將會設置 prop 屬性到你的 project 對象，值就是 somevalue 。Gradle 也提供了系統(tǒng)屬性的支持，但有著不同命名方式，類似的 org.gradle.project.prop

也可在 gradle.properties 設置系統(tǒng)屬性。如果此類文件中的屬性有一個?systemProp.?的前綴，像systemProp.propName,該屬性和它的值會被添加到系統(tǒng)屬性，且不帶此前綴。在多 project 構建中，除了在根項目之外的任何項目里的systemProp.?屬性集都將被忽略。也就是，只有根 project 的 gradle.properties 文件里的?systemProp.前綴的 屬性會被作為系統(tǒng)屬性。

Example 14.2. Setting properties with a gradle.properties file

gradle.properties

gradlePropertiesProp=gradlePropertiesValue
sysProp=shouldBeOverWrittenBySysProp
envProjectProp=shouldBeOverWrittenByEnvProp
systemProp.system=systemValue

build.gradle

task printProps << {
    println commandLineProjectProp
    println gradlePropertiesProp
    println systemProjectProp
    println envProjectProp
    println System.properties['system']
}

執(zhí)行 gradle -q -PcommandLineProjectProp=commandLineProjectPropValue -Dorg.gradle.project.systemProjectProp=systemPropertyValue printProps 輸出

> gradle -q -PcommandLineProjectProp=commandLineProjectPropValue -Dorg.gradle.project.systemProjectProp=systemPropertyValue printProps
commandLineProjectPropValue
gradlePropertiesValue
systemPropertyValue
envPropertyValue
systemValue

14.2.1. Checking for project properties 檢查 project 屬性

當你要使用一個變量時，你可以僅通過其名稱在構建腳本中訪問一個項目的屬性。如果此屬性不存在，則會引發(fā)異常，并且構建失敗。如果您的構建腳本依賴于一些可選屬性，而這些屬性用戶可能在比如 gradle.properties 文件中設置，您就需要在訪問它們之前先檢查它們是否存在。你可以通過使用方法 hasProperty('propertyName') 來進行檢查，它返回 true 或 false。

14.3. Configuring the project using an external build script 使用外部構建腳本配置項目

你可以使用一個外部構建腳本配置當前 project 。所有的 Gradle 構建語言都可用在外部腳本。。您甚至可以在外部腳本中應用其他腳本。

Example 14.3. Configuring the project using an external build script

build.gradle

apply from: 'other.gradle'
other.gradle

println "configuring $project"
task hello << {
    println 'hello from other script'
}

執(zhí)行 gradle -q hello 輸出

> gradle -q hello
configuring root project 'configureProjectUsingScript'
hello from other script

14.4. Configuring arbitrary objects 配置任意對象

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

Example 14.4. Configuring arbitrary objects

build.gradle

task configure << {
    def pos = configure(new java.text.FieldPosition(10)) {
        beginIndex = 1
        endIndex = 5
    }
    println pos.beginIndex
    println pos.endIndex
}

執(zhí)行 gradle -q configure 輸出

> gradle -q configure
1
5

14.5. Configuring arbitrary objects using an external script 使用外部腳本配置任意對象

Example 14.5. Configuring arbitrary objects using a script

build.gradle

task configure << {
    def pos = new java.text.FieldPosition(10)
    // Apply the script
    apply from: 'other.gradle', to: pos
    println pos.beginIndex
    println pos.endIndex
}

other.gradle

執(zhí)行 gradle -q configure 輸出

> gradle -q configure
1
5

14.6. Caching 緩存

為了提高響應速度，默認情況下 Gradle 會緩存所有已編譯的腳本。這包括所有構建腳本，初始化腳本和其他腳本。你第一次運行一個項目構建時， Gradle 會創(chuàng)建 .gradle 目錄，用于存放已編譯的腳本。下次你運行此構建時， 如果該腳本自它編譯后沒有被修改，Gradle 會使用這個已編譯的腳本。否則該腳本會重新編譯，并把最新版本存在緩存中。如果您通過 --recompile-scripts 選項運行 Gradle ，會丟棄緩存的腳本，然后重新編譯此腳本并將其存在緩存中。通過這種方式，您可以強制 Gradle 重新生成緩存