Tar

封存檔名稱的附加部分 (若有)。

封存檔的基本名稱。

封存檔名稱的分類器部分 (若有)。

封存檔名稱的副檔名部分。

建構封存檔的 RegularFile。路徑僅為 destinationDirectory 加上 archiveFileName。

封存檔名稱。如果名稱未明確設定，則名稱的模式為：[archiveBaseName]-[archiveAppendix]-[archiveVersion]-[archiveClassifier].[archiveExtension]

封存檔名稱的版本部分。

指定是否應使用區分大小寫的模式比對。

用於此封存檔的壓縮方式。

將放置封存檔的目錄。

用於查詢和配置目錄存取權限的屬性。如果屬性未設定值，則表示保留現有權限。這些權限是否實際應用取決於複製動作實作。詳細資訊請參閱 ConfigurableFilePermissions。

嘗試將多個檔案複製到相同目的地時要使用的策略。

可以使用列舉值的區分大小寫字串設定值 (例如，'exclude' 代表 DuplicatesStrategy.EXCLUDE)。

可以使用 CopySpec.eachFile(org.gradle.api.Action) 或 CopySpec.filesMatching(java.lang.String, org.gradle.api.Action) 覆寫個別檔案的此策略。

排除模式的集合。

用於查詢和配置檔案存取權限的屬性。如果屬性未設定值，則表示保留現有權限。這些權限是否實際應用取決於複製動作實作。詳細資訊請參閱 ConfigurableFilePermissions。

告知是否將空目標目錄包含在複製中。

包含模式的集合。

指定是否應在封存檔中保留檔案時間戳記。

如果 false，這可確保封存檔項目在不同機器、Java 版本和作業系統之間的建置中具有相同的時間。

指定從目錄讀取檔案時是否強制執行可重現的檔案順序。

然後 Gradle 將以可重現的順序走訪磁碟上屬於此封存檔一部分的目錄，而與檔案系統和作業系統無關。這有助於 Gradle 可靠地產生位元組對位元組可重現的封存檔。

此 Task 的來源檔案。

新增要應用於每個檔案的動作，因為它即將複製到其目的地。給定的 closure 會以 FileCopyDetails 作為其參數呼叫。動作會依新增順序執行，並從父規範繼承。

新增要應用於每個檔案的動作，因為它即將複製到其目的地。動作可以變更檔案的目的地路徑、篩選檔案的內容，或將檔案完全排除在結果之外。動作會依新增順序執行，並從父規範繼承。

新增排除規範。此方法可以多次呼叫以附加新規範。給定的 closure 會傳遞 FileTreeElement 作為其參數。closure 應傳回 true 或 false。範例

copySpec {
  from 'source'
  into 'destination'
  //an example of excluding files from certain configuration:
  exclude { it.file in configurations.someConf.files }
}

如果沒有提供排除規則，則不會排除任何檔案。如果提供了排除規則，則檔案必須不符合任何排除模式才能被處理。

新增 ANT 樣式的排除模式。此方法可以多次呼叫以附加新模式，並且可以在單次呼叫中指定多個模式。如果未提供排除項，則不會排除任何檔案。如果提供排除項，則檔案不得符合任何排除模式才能進行處理。

新增 ANT 樣式的排除模式。此方法可以多次呼叫以附加新模式，並且可以在單次呼叫中指定多個模式。如果未提供排除項，則不會排除任何檔案。如果提供排除項，則檔案不得符合任何排除模式才能進行處理。

新增排除規範。此方法可以多次呼叫以附加新規範。如果未提供排除項，則不會排除任何檔案。如果提供排除項，則檔案不得符合任何排除模式才能進行處理。

在複製每個檔案時展開屬性參考。更具體地說，每個檔案都使用 Groovy 的 SimpleTemplateEngine 進行轉換。這表示您可以在檔案中使用簡單的屬性參考，例如 $property 或 ${property}。您也可以在檔案中包含任意 Groovy 程式碼，例如 ${version ?: 'unknown'} 或 ${classpath*.name.join(' ')}

請注意，所有跳脫序列（\n、\t、\\ 等）都會轉換為它們所代表的符號，例如，\n 會變成換行符號。如果這不是您所希望的行為，則應使用 ContentFilterable.expand(java.util.Map, org.gradle.api.Action) 來停用此行為。

在複製每個檔案時展開屬性參考。更具體地說，每個檔案都使用 Groovy 的 SimpleTemplateEngine 進行轉換。這表示您可以在檔案中使用簡單的屬性參考，例如 $property 或 ${property}。您也可以在檔案中包含任意 Groovy 程式碼，例如 ${version ?: 'unknown'} 或 ${classpath*.name.join(' ')}。可以使用提供的動作配置範本引擎。

請注意，預設情況下，所有跳脫序列（\n、\t、\\ 等）都會轉換為它們所代表的符號，例如，\n 會變成換行符號。此行為由 ExpandDetails.getEscapeBackslash() 屬性控制。應將其設定為 true 以停用跳脫序列轉換。

 expand(one: '1', two: 2) {
     escapeBackslash = true
 }

為路徑符合任何指定 Ant 樣式模式的每個檔案配置 FileCopyDetails。這相當於使用 eachFile() 並根據檔案的路徑選擇性地套用配置。

為路徑符合指定 Ant 樣式模式的每個檔案配置 FileCopyDetails。這相當於使用 eachFile() 並根據檔案的路徑選擇性地套用配置。

為路徑不符合任何指定 Ant 樣式模式的每個檔案配置 FileCopyDetails。這相當於使用 eachFile() 並根據檔案的路徑選擇性地套用配置。

為路徑不符合指定 Ant 樣式模式的每個檔案配置 FileCopyDetails。這相當於使用 eachFile() 並根據檔案的路徑選擇性地套用配置。

根據提供的 closure 新增內容篩選器。Closure 將以每一行 (去除行尾) 呼叫，並且應傳回要取代該行的 String，或傳回 null 以移除該行。如果移除每一行，則結果將會是空檔案，而不是不存在的檔案。

新增要在複製期間使用的內容篩選器。多次呼叫 filter 會將額外的篩選器新增至篩選器鏈。每個篩選器都應實作 java.io.FilterReader。包含 org.apache.tools.ant.filters.* 以存取所有標準 Ant 篩選器。

範例

   filter(StripJavaComments)
   filter(com.mycompany.project.CustomFilter)

新增要在複製期間使用的內容篩選器。多次呼叫 filter 會將額外的篩選器新增至篩選器鏈。每個篩選器都應實作 java.io.FilterReader。包含 org.apache.tools.ant.filters.* 以存取所有標準 Ant 篩選器。

可以使用 Groovy 映射語法指定篩選器屬性。

範例

   filter(HeadFilter, lines:25, skip:2)
   filter(ReplaceTokens, tokens:[copyright:'2009', version:'2.3.1'])

根據提供的轉換器新增內容篩選器。Closure 將以每一行 (去除行尾) 呼叫，並且應傳回要取代該行的 String，或傳回 null 以移除該行。如果移除每一行，則結果將會是空檔案，而不是不存在的檔案。

指定複製的來源檔案或目錄，並建立子 CopySourceSpec。給定的來源路徑會根據 Project.files(java.lang.Object[]) 進行評估。

指定複製的來源檔案或目錄，並建立子 CopySpec。給定的來源路徑會根據 Project.files(java.lang.Object[]) 進行評估。

指定複製的來源檔案或目錄。給定的路徑會根據 Project.files(java.lang.Object[]) 進行評估。

新增包含規範。此方法可以多次呼叫以附加新規範。給定的 closure 會傳遞 FileTreeElement 作為其參數。如果未提供包含項，則將包含此容器中的所有檔案。如果提供包含項，則檔案必須符合至少一個包含模式或規範才能包含在內。

新增 ANT 樣式的包含模式。此方法可以多次呼叫以附加新模式，並且可以在單次呼叫中指定多個模式。如果未提供包含項，則將包含此容器中的所有檔案。如果提供包含項，則檔案必須符合至少一個包含模式才能進行處理。

新增 ANT 樣式的包含模式。此方法可以多次呼叫以附加新模式，並且可以在單次呼叫中指定多個模式。如果未提供包含項，則將包含此容器中的所有檔案。如果提供包含項，則檔案必須符合至少一個包含模式才能進行處理。

新增包含規範。此方法可以多次呼叫以附加新規範。如果未提供包含項，則將包含此容器中的所有檔案。如果提供包含項，則檔案必須符合至少一個包含模式或規範才能包含在內。

指定檔案在封存檔*內部*的目的地目錄。目的地會根據 Project.file(java.lang.Object) 進行評估。請勿與 AbstractArchiveTask.getDestinationDirectory() 混淆，後者指定封存檔的輸出目錄。

建立並配置子 CopySpec，其中包含檔案在封存檔*內部*的目的地目錄。目的地會根據 Project.file(java.lang.Object) 進行評估。請勿與 AbstractArchiveTask.getDestinationDirectory() 混淆，後者指定封存檔的輸出目錄。

建立並配置子 CopySpec，其中包含檔案在封存檔*內部*的目的地目錄。目的地會根據 Project.file(java.lang.Object) 進行評估。請勿與 AbstractArchiveTask.getDestinationDirectory() 混淆，後者指定封存檔的輸出目錄。

重新命名來源檔案。closure 將以單一參數 (檔案名稱) 呼叫。closure 應傳回具有新目標名稱的 String 物件。closure 可以傳回 null，在這種情況下將使用原始名稱。

根據正則表達式重新命名檔案。使用 java.util.regex 類型的正則表達式。請注意，取代字串應使用 '$1' 語法來參考來源正則表達式中的擷取群組。不符合來源正則表達式的檔案將以原始名稱複製。

範例

rename '(.*)_OEM_BLUE_(.*)', '$1$2'

會將檔案 'style_OEM_BLUE_.css' 映射到 'style.css'

根據正則表達式重新命名檔案。請參閱 CopyProcessingSpec.rename(java.lang.String, java.lang.String)。

重新命名來源檔案。function 將以單一參數 (檔案名稱) 呼叫。function 應傳回新的目標名稱。function 可以傳回 null，在這種情況下將使用原始名稱。

將給定的規範新增為此規範的子規範。

def contentSpec = copySpec {
  from("content") {
    include "**/*.txt"
  }
}

task copy(type: Copy) {
  into "$buildDir/copy"
  with contentSpec
}