Jar

屬性
方法
腳本區塊
屬性詳細資訊
方法詳細資訊

API 文件	`Jar`

已知子類型

Jar

組裝 JAR 封存檔。

屬性

屬性	描述
`archiveAppendix (封存檔附錄)`	封存檔名稱的附錄部分 (如果有的話)。
`archiveBaseName (封存檔基本名稱)`	封存檔的基本名稱。
`archiveClassifier (封存檔分類器)`	封存檔名稱的分類器部分 (如果有的話)。
`archiveExtension (封存檔副檔名)`	封存檔名稱的副檔名部分。
`archiveFile (封存檔檔案)`	建構封存檔的 `RegularFile`。路徑僅為 `destinationDirectory` 加上 `archiveFileName`。
`archiveFileName (封存檔檔案名稱)`	封存檔名稱。如果名稱尚未明確設定，則名稱的模式為：`[archiveBaseName]-[archiveAppendix]-[archiveVersion]-[archiveClassifier].[archiveExtension]`
`archiveVersion (封存檔版本)`	封存檔名稱的版本部分。
`caseSensitive (區分大小寫)`	指定是否應使用區分大小寫的模式比對。
`destinationDirectory (目的地目錄)`	將放置封存檔的目錄。
`dirPermissions (目錄權限)`	用於查詢和配置目錄存取權限的屬性。如果屬性未設定值，則表示保留現有權限。這些權限是否實際應用取決於複製動作的實作。有關詳細資訊，請參閱 `ConfigurableFilePermissions`。
`duplicatesStrategy (重複策略)`	嘗試將多個檔案複製到相同目的地時要使用的策略。
`entryCompression (條目壓縮)`	封存檔條目的壓縮等級。如果設定為 `ZipEntryCompression.DEFLATED` (預設值)，則每個條目都使用 DEFLATE 演算法壓縮。如果設定為 `ZipEntryCompression.STORED`，則封存檔的條目將保持未壓縮狀態。
`excludes (排除)`	排除模式的集合。
`filePermissions (檔案權限)`	用於查詢和配置檔案存取權限的屬性。如果屬性未設定值，則表示保留現有權限。這些權限是否實際應用取決於複製動作的實作。有關詳細資訊，請參閱 `ConfigurableFilePermissions`。
`includeEmptyDirs (包含空目錄)`	告知是否要在複製中包含空的目標目錄。
`includes (包含)`	包含模式的集合。
`manifest (Manifest)`	此 JAR 封存檔的 manifest。
`metadataCharset (元數據字元集)`	用於編碼 ZIP 元數據 (如檔案名稱) 的字元集。預設為平台的預設字元集。
`preserveFileTimestamps (保留檔案時間戳記)`	指定是否應在封存檔中保留檔案時間戳記。
`reproducibleFileOrder (可重現的檔案順序)`	指定從目錄讀取檔案時是否強制執行可重現的檔案順序。
`source (來源)`	此任務的來源檔案。
`zip64`	zip 是否可以包含超過 65535 個檔案和/或支援大於 4GB 的檔案。

方法

方法	描述
`eachFile(closure)`	新增一個動作，以應用於即將複製到其目的地的每個檔案。給定的 closure 會以 `FileCopyDetails` 作為其參數來呼叫。動作會依新增順序執行，並從父規格繼承。
`eachFile(action)`	新增一個動作，以應用於即將複製到其目的地的每個檔案。動作可以變更檔案的目的地路徑、篩選檔案的內容，或完全從結果中排除檔案。動作會依新增順序執行，並從父規格繼承。
`exclude(excludeSpec)`	新增一個排除規格。可以多次呼叫此方法以附加新的規格。給定的 closure 會傳遞一個 `FileTreeElement` 作為其參數。closure 應傳回 true 或 false。範例
`exclude(excludes)`	新增一個 ANT 樣式的排除模式。可以多次呼叫此方法以附加新的模式，並且可以在單次呼叫中指定多個模式。如果未提供排除項，則不會排除任何檔案。如果提供了排除項，則檔案不得符合任何排除模式才能進行處理。
`exclude(excludes)`	新增一個 ANT 樣式的排除模式。可以多次呼叫此方法以附加新的模式，並且可以在單次呼叫中指定多個模式。如果未提供排除項，則不會排除任何檔案。如果提供了排除項，則檔案不得符合任何排除模式才能進行處理。
`exclude(excludeSpec)`	新增一個排除規格。可以多次呼叫此方法以附加新的規格。如果未提供排除項，則不會排除任何檔案。如果提供了排除項，則檔案不得符合任何排除模式才能進行處理。
`expand(properties)`	展開複製的每個檔案中的屬性參考。更具體地說，每個檔案都使用 Groovy 的 `SimpleTemplateEngine` 進行轉換。這表示您可以在檔案中使用簡單的屬性參考，例如 `$property` 或 `${property}`。您也可以在檔案中包含任意 Groovy 程式碼，例如 `${version ?: 'unknown'}` 或 `${classpath*.name.join(' ')}`
`expand(properties, action)`	展開複製的每個檔案中的屬性參考。更具體地說，每個檔案都使用 Groovy 的 `SimpleTemplateEngine` 進行轉換。這表示您可以在檔案中使用簡單的屬性參考，例如 `$property` 或 `${property}`。您也可以在檔案中包含任意 Groovy 程式碼，例如 `${version ?: 'unknown'}` 或 `${classpath*.name.join(' ')}`。可以使用提供的動作來配置範本引擎。
`filesMatching(patterns, action)`	為路徑符合任何指定 Ant 樣式模式的每個檔案配置 `FileCopyDetails`。這相當於使用 eachFile() 並根據檔案的路徑選擇性地應用配置。
`filesMatching(pattern, action)`	為路徑符合指定 Ant 樣式模式的每個檔案配置 `FileCopyDetails`。這相當於使用 eachFile() 並根據檔案的路徑選擇性地應用配置。
`filesNotMatching(patterns, action)`	為路徑不符合任何指定 Ant 樣式模式的每個檔案配置 `FileCopyDetails`。這相當於使用 eachFile() 並根據檔案的路徑選擇性地應用配置。
`filesNotMatching(pattern, action)`	為路徑不符合指定 Ant 樣式模式的每個檔案配置 `FileCopyDetails`。這相當於使用 eachFile() 並根據檔案的路徑選擇性地應用配置。
`filter(closure)`	根據提供的 closure 新增內容篩選器。將使用每一行 (去除行尾符號) 呼叫 Closure，並應傳回一個字串以取代該行，或傳回 `null` 以移除該行。如果移除每一行，則結果將會是空檔案，而不是不存在的檔案。
`filter(filterType)`	新增要在複製期間使用的內容篩選器。多次呼叫 filter 會將其他篩選器新增至篩選器鏈。每個篩選器都應實作 `java.io.FilterReader`。包含 `org.apache.tools.ant.filters.*` 以存取所有標準 Ant 篩選器。
`filter(properties, filterType)`	新增要在複製期間使用的內容篩選器。多次呼叫 filter 會將其他篩選器新增至篩選器鏈。每個篩選器都應實作 `java.io.FilterReader`。包含 `org.apache.tools.ant.filters.*` 以存取所有標準 Ant 篩選器。
`filter(transformer)`	根據提供的轉換器新增內容篩選器。將使用每一行 (去除行尾符號) 呼叫 Closure，並應傳回一個字串以取代該行，或傳回 `null` 以移除該行。如果移除每一行，則結果將會是空檔案，而不是不存在的檔案。
`from(sourcePath, c)`	指定複製的來源檔案或目錄，並建立子 `CopySourceSpec`。給定的來源路徑會依照 `Project.files(java.lang.Object[])` 評估。
`from(sourcePath, configureAction)`	指定複製的來源檔案或目錄，並建立子 `CopySpec`。給定的來源路徑會依照 `Project.files(java.lang.Object[])` 評估。
`from(sourcePaths)`	指定複製的來源檔案或目錄。給定的路徑會依照 `Project.files(java.lang.Object[])` 評估。
`include(includeSpec)`	新增一個包含規格。可以多次呼叫此方法以附加新的規格。給定的 closure 會傳遞一個 `FileTreeElement` 作為其參數。如果未提供包含項，則將包含此容器中的所有檔案。如果提供了包含項，則檔案必須符合至少一個包含模式或規格才能包含在內。
`include(includes)`	新增一個 ANT 樣式的包含模式。可以多次呼叫此方法以附加新的模式，並且可以在單次呼叫中指定多個模式。如果未提供包含項，則將包含此容器中的所有檔案。如果提供了包含項，則檔案必須符合至少一個包含模式才能進行處理。
`include(includes)`	新增一個 ANT 樣式的包含模式。可以多次呼叫此方法以附加新的模式，並且可以在單次呼叫中指定多個模式。如果未提供包含項，則將包含此容器中的所有檔案。如果提供了包含項，則檔案必須符合至少一個包含模式才能進行處理。
`include(includeSpec)`	新增一個包含規格。可以多次呼叫此方法以附加新的規格。如果未提供包含項，則將包含此容器中的所有檔案。如果提供了包含項，則檔案必須符合至少一個包含模式或規格才能包含在內。
`into(destPath)`	指定檔案在封存檔內部的目的地目錄。目的地會依照 `Project.file(java.lang.Object)` 評估。請勿與 `AbstractArchiveTask.getDestinationDirectory()` 混淆，後者指定封存檔的輸出目錄。
`into(destPath, configureClosure)`	建立並配置子 `CopySpec`，其中包含檔案在封存檔內部的目的地目錄。目的地會依照 `Project.file(java.lang.Object)` 評估。請勿與 `AbstractArchiveTask.getDestinationDirectory()` 混淆，後者指定封存檔的輸出目錄。
`into(destPath, copySpec)`	建立並配置子 `CopySpec`，其中包含檔案在封存檔內部的目的地目錄。目的地會依照 `Project.file(java.lang.Object)` 評估。請勿與 `AbstractArchiveTask.getDestinationDirectory()` 混淆，後者指定封存檔的輸出目錄。
`manifest(configureClosure)`	配置此 JAR 封存檔的 manifest。
`manifest(configureAction)`	配置此 JAR 封存檔的 manifest。
`metaInf(configureClosure)`	將內容新增至此 JAR 封存檔的 META-INF 目錄。
`metaInf(configureAction)`	將內容新增至此 JAR 封存檔的 META-INF 目錄。
`rename(closure)`	重新命名來源檔案。將使用單一參數 (檔案名稱) 呼叫 closure。closure 應傳回具有新目標名稱的字串物件。closure 可以傳回 null，在這種情況下，將使用原始名稱。
`rename(sourceRegEx, replaceWith)`	根據正則表達式重新命名檔案。使用 java.util.regex 類型的正則表達式。請注意，取代字串應使用 '$1' 語法來參考來源正則表達式中的捕獲群組。不符合來源正則表達式的檔案將以原始名稱複製。
`rename(sourceRegEx, replaceWith)`	根據正則表達式重新命名檔案。請參閱 `CopyProcessingSpec.rename(java.lang.String, java.lang.String)`。
`rename(renamer)`	重新命名來源檔案。將使用單一參數 (檔案名稱) 呼叫函數。函數應傳回新的目標名稱。函數可以傳回 null，在這種情況下，將使用原始名稱。
`with(sourceSpecs)`	將給定的規格新增為此規格的子規格。

腳本區塊

沒有腳本區塊

屬性詳細資訊

`Property<String>` `archiveAppendix` (封存檔附錄)

封存檔名稱的附錄部分 (如果有的話)。

使用 java 外掛的預設值: ""

`Property<String>` `archiveBaseName` (封存檔基本名稱)

封存檔的基本名稱。

使用 java 外掛的預設值: project.archivesBaseName

`Property<String>` `archiveClassifier` (封存檔分類器)

封存檔名稱的分類器部分 (如果有的話)。

使用 java 外掛的預設值: ""

`Property<String>` `archiveExtension` (封存檔副檔名)

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

`Provider<RegularFile>` `archiveFile` (封存檔檔案)

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

使用 java 外掛的預設值: ${destinationDirectory}/${archiveFileName}

`Property<String>` `archiveFileName` (封存檔檔案名稱)

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

使用 java 外掛的預設值: ${archiveBaseName}-${archiveAppendix}-${archiveVersion}-${archiveClassifier}.${archiveExtension}

`Property<String>` `archiveVersion` (封存檔版本)

封存檔名稱的版本部分。

使用 java 外掛的預設值: project.version

`boolean` `caseSensitive` (區分大小寫)

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

使用 java 外掛的預設值: true

`DirectoryProperty` `destinationDirectory` (目的地目錄)

將放置封存檔的目錄。

使用 java 外掛的預設值: project.distsDir

`Property<ConfigurableFilePermissions>` `dirPermissions` (目錄權限)

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

使用 java 外掛的預設值: null

`DuplicatesStrategy` `duplicatesStrategy` (重複策略)

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

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

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

使用 java 外掛的預設值: DuplicatesStrategy.INHERIT

`ZipEntryCompression` `entryCompression` (條目壓縮)

封存檔條目的壓縮等級。如果設定為 ZipEntryCompression.DEFLATED (預設值)，則每個條目都使用 DEFLATE 演算法壓縮。如果設定為 ZipEntryCompression.STORED，則封存檔的條目將保持未壓縮狀態。

預設值: ZipEntryCompression.DEFLATED

`Set<String>` `excludes` (排除)

排除模式的集合。

使用 java 外掛的預設值: []

`Property<ConfigurableFilePermissions>` `filePermissions` (檔案權限)

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

使用 java 外掛的預設值: null

`boolean` `includeEmptyDirs` (包含空目錄)

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

使用 java 外掛的預設值: true

`Set<String>` `includes` (包含)

包含模式的集合。

使用 java 外掛的預設值: []

`Manifest` `manifest` (Manifest)

此 JAR 封存檔的 manifest。

`String` `metadataCharset` (元數據字元集)

用於編碼 ZIP 元數據 (如檔案名稱) 的字元集。預設為平台的預設字元集。

預設值: 平台預設編碼

`boolean` `preserveFileTimestamps` (保留檔案時間戳記)

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

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

使用 java 外掛的預設值: true

`boolean` `reproducibleFileOrder` (可重現的檔案順序)

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

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

使用 java 外掛的預設值: false

`FileCollection` `source` (來源) (唯讀)

此任務的來源檔案。

使用 java 外掛的預設值: []

`boolean` `zip64`

zip 是否可以包含超過 65535 個檔案和/或支援大於 4GB 的檔案。

標準 zip 格式對檔案大小和計數有硬性限制。Zip64 格式擴展實際上消除了這些限制，因此是建置大型 zip 所必需的。

然而，並非所有 Zip 讀取器都支援 Zip64 擴充功能。特別是，ZipInputStream JDK 類別在 Java 7 之前的版本中不支援 Zip64。這表示如果您要建置用於 Java 6 及更早版本執行環境的 JAR 檔案，則不應啟用此屬性。

預設值: false

方法詳情

`AbstractCopyTask` `eachFile`(`Closure` closure)

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

`AbstractCopyTask` `eachFile`(`Action<? super FileCopyDetails>` action)

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

`AbstractCopyTask` `exclude`(`Closure` excludeSpec)

新增一個排除規格。可以多次呼叫此方法以附加新的規格。給定的 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 }
}

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

`AbstractCopyTask` `exclude`(`Iterable<String>` excludes)

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

`AbstractCopyTask` `exclude`(`String...` excludes)

`AbstractCopyTask` `exclude`(`Spec<FileTreeElement>` excludeSpec)

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

`AbstractCopyTask` `expand`(`Map<String, ?>` properties)

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

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

`AbstractCopyTask` `expand`(`Map<String, ?>` properties, `Action<? super ExpandDetails>` action)

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

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

`AbstractCopyTask` `filesMatching`(`Iterable<String>` patterns, `Action<? super FileCopyDetails>` action)

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

`AbstractCopyTask` `filesMatching`(`String` pattern, `Action<? super FileCopyDetails>` action)

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

`AbstractCopyTask` `filesNotMatching`(`Iterable<String>` patterns, `Action<? super FileCopyDetails>` action)

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

`AbstractCopyTask` `filesNotMatching`(`String` pattern, `Action<? super FileCopyDetails>` action)

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

`AbstractCopyTask` `filter`(`Closure` closure)

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

`AbstractCopyTask` `filter`(`Class<? extends FilterReader>` filterType)

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

範例

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

`AbstractCopyTask` `filter`(`Map<String, ?>` properties, `Class<? extends FilterReader>` filterType)

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

範例

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

`AbstractCopyTask` `filter`(`Transformer<String, String>` transformer)

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

`AbstractCopyTask` `from`(`Object` sourcePath, `Closure` c)

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

`AbstractCopyTask` `from`(`Object` sourcePath, `Action<? super CopySpec>` configureAction)

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

`AbstractCopyTask` `from`(`Object...` sourcePaths)

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

`AbstractCopyTask` `include`(`Closure` includeSpec)

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

`AbstractCopyTask` `include`(`Iterable<String>` includes)

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

`AbstractCopyTask` `include`(`String...` includes)

`AbstractCopyTask` `include`(`Spec<FileTreeElement>` includeSpec)

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

`AbstractArchiveTask` `into`(`Object` destPath)

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

`AbstractArchiveTask` `into`(`Object` destPath, `Closure` configureClosure)

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

`CopySpec` `into`(`Object` destPath, `Action<? super CopySpec>` copySpec)

`Jar` `manifest`(`Closure<?>` configureClosure)

配置此 JAR 封存檔的 manifest。

給定的 closure 會被執行以配置 manifest。 Manifest 會作為委派傳遞給 closure。

`Jar` `manifest`(`Action<? super Manifest>` configureAction)

配置此 JAR 封存檔的 manifest。

給定的 action 會被執行以配置 manifest。

`CopySpec` `metaInf`(`Closure<?>` configureClosure)

將內容新增至此 JAR 封存檔的 META-INF 目錄。

給定的 closure 會被執行以配置 CopySpec。 CopySpec 會作為委派傳遞給 closure。

`CopySpec` `metaInf`(`Action<? super CopySpec>` configureAction)

將內容新增至此 JAR 封存檔的 META-INF 目錄。

給定的 action 會被執行以配置 CopySpec。

`AbstractCopyTask` `rename`(`Closure` closure)

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

`AbstractCopyTask` `rename`(`String` sourceRegEx, `String` replaceWith)

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

範例

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

會將檔案 'style_OEM_BLUE_.css' 對應到 'style.css'

`AbstractCopyTask` `rename`(`Pattern` sourceRegEx, `String` replaceWith)

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

`AbstractCopyTask` `rename`(`Transformer<String, String>` renamer)

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

`CopySpec` `with`(`CopySpec...` sourceSpecs)

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

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

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

Jar

屬性

方法

腳本區塊

屬性詳細資訊

Property<String> archiveAppendix (封存檔附錄)

Property<String> archiveBaseName (封存檔基本名稱)

Property<String> archiveClassifier (封存檔分類器)

Property<String> archiveExtension (封存檔副檔名)

Provider<RegularFile> archiveFile (封存檔檔案)

Property<String> archiveFileName (封存檔檔案名稱)

Property<String> archiveVersion (封存檔版本)

boolean caseSensitive (區分大小寫)

DirectoryProperty destinationDirectory (目的地目錄)

Property<ConfigurableFilePermissions> dirPermissions (目錄權限)

DuplicatesStrategy duplicatesStrategy (重複策略)

ZipEntryCompression entryCompression (條目壓縮)

Set<String> excludes (排除)

Property<ConfigurableFilePermissions> filePermissions (檔案權限)

boolean includeEmptyDirs (包含空目錄)

Set<String> includes (包含)

Manifest manifest (Manifest)

String metadataCharset (元數據字元集)

boolean preserveFileTimestamps (保留檔案時間戳記)

boolean reproducibleFileOrder (可重現的檔案順序)

FileCollection source (來源) (唯讀)

boolean zip64

方法詳情

AbstractCopyTask eachFile(Closure closure)

AbstractCopyTask eachFile(Action<? super FileCopyDetails> action)

AbstractCopyTask exclude(Closure excludeSpec)

AbstractCopyTask exclude(Iterable<String> excludes)

AbstractCopyTask exclude(String... excludes)

AbstractCopyTask exclude(Spec<FileTreeElement> excludeSpec)

AbstractCopyTask expand(Map<String, ?> properties)

AbstractCopyTask expand(Map<String, ?> properties, Action<? super ExpandDetails> action)

AbstractCopyTask filesMatching(Iterable<String> patterns, Action<? super FileCopyDetails> action)

AbstractCopyTask filesMatching(String pattern, Action<? super FileCopyDetails> action)

AbstractCopyTask filesNotMatching(Iterable<String> patterns, Action<? super FileCopyDetails> action)

AbstractCopyTask filesNotMatching(String pattern, Action<? super FileCopyDetails> action)

AbstractCopyTask filter(Closure closure)

AbstractCopyTask filter(Class<? extends FilterReader> filterType)

AbstractCopyTask filter(Map<String, ?> properties, Class<? extends FilterReader> filterType)

AbstractCopyTask filter(Transformer<String, String> transformer)

AbstractCopyTask from(Object sourcePath, Closure c)

AbstractCopyTask from(Object sourcePath, Action<? super CopySpec> configureAction)

AbstractCopyTask from(Object... sourcePaths)

AbstractCopyTask include(Closure includeSpec)

AbstractCopyTask include(Iterable<String> includes)

AbstractCopyTask include(String... includes)

AbstractCopyTask include(Spec<FileTreeElement> includeSpec)

AbstractArchiveTask into(Object destPath)

AbstractArchiveTask into(Object destPath, Closure configureClosure)

CopySpec into(Object destPath, Action<? super CopySpec> copySpec)

Jar manifest(Closure<?> configureClosure)

Jar manifest(Action<? super Manifest> configureAction)

CopySpec metaInf(Closure<?> configureClosure)

CopySpec metaInf(Action<? super CopySpec> configureAction)

AbstractCopyTask rename(Closure closure)

AbstractCopyTask rename(String sourceRegEx, String replaceWith)

AbstractCopyTask rename(Pattern sourceRegEx, String replaceWith)

AbstractCopyTask rename(Transformer<String, String> renamer)

CopySpec with(CopySpec... sourceSpecs)