Maven@2 - Maven v2 工作

使用此工作來建置、測試及部署Apache Maven。

此版本的工作已被取代;使用 Maven@4。

語法

# Maven v2
# Build, test, and deploy with Apache Maven.
- task: Maven@2
  inputs:
    mavenPOMFile: 'pom.xml' # string. Required. Maven POM file. Default: pom.xml.
    #goals: 'package' # string. Goal(s). Default: package.
    #options: # string. Options. 
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/TEST-*.xml.
    #testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test run title. 
    #allowBrokenSymlinks: true # boolean. Alias: allowBrokenSymbolicLinks. Optional. Use when publishJUnitResults = true. Allow broken symbolic links. Default: true.
  # Code Coverage
    #codeCoverageToolOption: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code coverage tool. Default: None.
    #codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class inclusion/exclusion filters. 
    #codeCoverageClassFilesDirectories: # string. Alias: classFilesDirectories. Optional. Use when codeCoverageTool = JaCoCo. Class files directories. 
    #codeCoverageSourceDirectories: # string. Alias: srcDirectories. Optional. Use when codeCoverageTool = JaCoCo. Source files directories. 
    #codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail when code coverage results are missing. Default: false.
    #codeCoverageRestoreOriginalPomXml: false # boolean. Alias: restoreOriginalPomXml. Optional. Use when codeCoverageTool != None. Restore original pom.xml after task execution. Default: false.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.21' | '1.17' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.
    mavenVersionOption: 'Default' # 'Default' | 'Path'. Alias: mavenVersionSelection. Required. Maven version. Default: Default.
    #mavenDirectory: # string. Alias: mavenPath. Required when mavenVersionSelection = Path. Maven path. 
    #mavenSetM2Home: false # boolean. Optional. Use when mavenVersionSelection = Path. Set M2_HOME variable. Default: false.
    #mavenOptions: '-Xmx1024m' # string. Alias: mavenOpts. Set MAVEN_OPTS to. Default: -Xmx1024m.
    #mavenAuthenticateFeed: true # boolean. Alias: mavenFeedAuthenticate. Authenticate with Artifacts feeds. Default: true.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud analysis. Default: false.
    #isJacocoCoverageReportXML: false # boolean. Optional. Use when sqAnalysisEnabled = true && codeCoverageTool = JaCoCo. Use XML Jacoco reports for SonarQube analysis. Default: false.
    #sqMavenPluginVersionChoice: 'latest' # 'latest' | 'pom'. Required when sqAnalysisEnabled = true. SonarQube scanner for Maven version. Default: latest.
    #checkStyleRunAnalysis: false # boolean. Alias: checkstyleAnalysisEnabled. Run Checkstyle. Default: false.
    #pmdRunAnalysis: false # boolean. Alias: pmdAnalysisEnabled. Run PMD. Default: false.
    #findBugsRunAnalysis: false # boolean. Alias: findbugsAnalysisEnabled. Run FindBugs. Default: false.

輸入

mavenPOMFile - Maven POM 檔案
string。 必須的。 預設值：pom.xml。

指定從存放庫根目錄到 Maven POM 檔案的相對路徑。

goals - 目標
string。 預設值：package。

options - 選項
string。

publishJUnitResults - 發佈至 Azure Pipelines
boolean。 預設值：true。

指定將 Maven 組建所產生的 JUnit 測試結果發佈至 Azure Pipelines 的選項。 每個測試結果檔案比對 Test Results Files 都會發佈為 Azure Pipelines 中的測試回合。

testResultsFiles - 測試結果檔案
string。 publishJUnitResults = true時為必要項。 預設值：**/TEST-*.xml。

指定要發佈的測試結果檔案路徑和模式。 可使用萬用字元。 檔案比對模式的詳細資訊。
例如，針對名稱開頭為 TEST-的所有 XML 檔案 **/TEST-*.xml。
如果未指定任何根路徑，則會比對預設工作目錄下的檔案，而變數中的值 $(System.DefaultWorkingDirectory)。 例如，**/TEST-*.xml 的值實際上會導致來自 $(System.DefaultWorkingDirectory)/**/TEST-*.xml的相符檔案。

testRunTitle - 測試回合標題
string。 選擇性。 publishJUnitResults = true時使用 。

指定測試回合的名稱。

allowBrokenSymlinks - 允許中斷的符號連結
輸入別名：allowBrokenSymbolicLinks。 boolean。 選擇性。 publishJUnitResults = true時使用 。 預設值：true。

當設定為 false時，當工作在發佈測試結果時找到中斷的符號連結時，建置會失敗。

codeCoverageToolOption - 程式代碼涵蓋範圍工具
輸入別名：codeCoverageTool。 string。 允許的值：None、Cobertura、JaCoCo。 預設值：None。

指定程式代碼涵蓋範圍工具。

codeCoverageClassFilter - 類別包含/排除篩選條件
輸入別名：classFilter。 string。 選擇性。 codeCoverageTool != None時使用 。

指定要包含或排除類別的逗號分隔篩選清單，以收集程式代碼涵蓋範圍。 例如： +:com.*,+:org.*,-:my.app*.* 。

codeCoverageClassFilesDirectories - 類別檔案目錄
輸入別名：classFilesDirectories。 string。 選擇性。 codeCoverageTool = JaCoCo時使用 。

多模組專案需要此欄位。
指定從 Maven POM 檔案到包含類別檔案和封存盤案的目錄的相對路徑逗號分隔清單（JAR、WAR 等）。 這些目錄中的類別檔案會報告程式代碼涵蓋範圍。 例如： target/classes,target/testClasses 。

codeCoverageSourceDirectories - 來源檔案目錄
輸入別名：srcDirectories。 string。 選擇性。 codeCoverageTool = JaCoCo時使用 。

多模組專案需要此欄位。
指定從 Maven POM 檔案到原始程式碼目錄的相對路徑逗號分隔清單。 程式代碼涵蓋範圍報告會使用這些報告來醒目提示原始程式碼。 例如： src/java,src/Test 。

codeCoverageFailIfEmpty - 遺失程式代碼涵蓋範圍結果時失敗
輸入別名：failIfCoverageEmpty。 boolean。 選擇性。 codeCoverageTool != None時使用 。 預設值：false。

如果程式代碼涵蓋範圍未產生任何要發佈的結果，則組建會失敗。

codeCoverageRestoreOriginalPomXml - 工作執行后還原原始 pom.xml
輸入別名：restoreOriginalPomXml。 boolean。 選擇性。 codeCoverageTool != None時使用 。 預設值：false。

程式代碼涵蓋範圍會修改 pom.xml 以產生結果。 如果您需要保留原始 pom.xml，請使用此選項。

javaHomeOption - 依 設定JAVA_HOME
輸入別名：javaHomeSelection。 string。 必須的。 允許的值：JDKVersion （JDK 版本），Path。 預設值：JDKVersion。

選取將在組建期間探索的 JDK 版本，或手動輸入 JDK 路徑，來設定 JAVA_HOME。

jdkVersionOption - JDK 版本
輸入別名：jdkVersion。 string。 選擇性。 javaHomeSelection = JDKVersion時使用 。 允許的值：default、1.21 （JDK 21）、1.17 （JDK 17）、1.11 （JDK 11）、1.10 （JDK 10 （超出 JDK 10） support））、1.9（JDK 9（不支援））、1.8（JDK 8）、1.7（JDK 7）、1.6（JDK 6（不支援））。 預設值：default。

嘗試探索所選 JDK 版本的路徑，並據以設定 JAVA_HOME。

jdkDirectory - JDK 路徑
輸入別名：jdkUserInputPath。 string。 javaHomeSelection = Path時為必要項。

將 JAVA_HOME 設定為指定的路徑。

jdkArchitectureOption - JDK 架構
輸入別名：jdkArchitecture。 string。 選擇性。 jdkVersion != default時使用 。 允許的值：x86、x64。 預設值：x64。

提供 JDK 的架構（x86、x64）。

mavenVersionOption - Maven 版本
輸入別名：mavenVersionSelection。 string。 必須的。 允許的值：Default、Path （自定義路徑）。 預設值：Default。

使用預設 Maven 版本或指定自定義路徑中的版本。

mavenDirectory - Maven 路徑
輸入別名：mavenPath。 string。 mavenVersionSelection = Path時為必要項。

指定 Maven 安裝的自訂路徑（例如：/usr/share/maven）。

mavenSetM2Home - 設定M2_HOME變數
boolean。 選擇性。 mavenVersionSelection = Path時使用 。 預設值：false。

將 M2_HOME 變數設定為自定義 Maven 安裝路徑。

mavenOptions - 將MAVEN_OPTS設定為
輸入別名：mavenOpts。 string。 預設值：-Xmx1024m。

設定 MAVEN_OPTS 環境變數，用來傳送命令行自變數來啟動 JVM。 -Xmx 旗標會指定 JVM 可用的記憶體上限。

mavenAuthenticateFeed - 使用成品摘要進行驗證
輸入別名：mavenFeedAuthenticate。 boolean。 預設值：true。

使用 Azure Artifacts 摘要自動進行驗證。 如果成品摘要未使用中，請取消選取此選項以取得更快速的組建。

sonarQubeRunAnalysis - 執行 SonarQube 或 SonarCloud 分析
輸入別名：sqAnalysisEnabled。 boolean。 預設值：false。

此選項已從使用 Maven 工作的第 1 版變更為使用 SonarQube 和 SonarCloud 市集擴充功能。
啟用此選項，在 [目標] 字段中執行目標之後，執行 SonarQube 或 SonarCloud 分析。 安裝 或 套件 目標應該先執行。 在此 Maven 工作之前，您也必須將 準備分析組態 工作從其中一個延伸模組新增至建置管線。

isJacocoCoverageReportXML - 使用 XML Jacoco 報表進行 SonarQube 分析
boolean。 選擇性。 sqAnalysisEnabled = true && codeCoverageTool = JaCoCo時使用 。 預設值：false。

使用 XML Jacoco 報表進行 SonarQube 分析。 深入瞭解 測試報告。

適用於 Maven 版本的 sqMavenPluginVersionChoice - SonarQube 掃描器
string。 sqAnalysisEnabled = true時為必要項。 允許的值：latest（使用最新版本）、pom（使用您 pom.xml中宣告的版本）。 預設值：latest。

指定要使用的 SonarQube Maven 外掛程式版本。 您可以使用最新版本，或依賴 pom.xml中的版本。

checkStyleRunAnalysis - 執行 Checkstyle
輸入別名：checkstyleAnalysisEnabled。 boolean。 預設值：false。

使用預設的 Sun 檢查執行 Checkstyle 工具。 結果會上傳為組建成品。

pmdRunAnalysis - 執行 PMD
輸入別名：pmdAnalysisEnabled。 boolean。 預設值：false。

使用 PMD 靜態分析工具來尋找程式代碼中的 Bug。 結果會上傳為組建成品。

findBugsRunAnalysis - 執行 FindBugs
輸入別名：findbugsAnalysisEnabled。 boolean。 預設值：false。

使用 FindBugs 靜態分析工具來尋找程式代碼中的 Bug。 結果會上傳為組建成品。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。

輸出變數

沒有。

備註

SonarQube 分析的組態已移至 SonarQube 或 SonarCloud 擴充功能的工作 準備分析組態。

需求

要求	說明
管線類型	YAML、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
需求	自我裝載代理程式必須具有 功能， 符合下列 需求， 執行使用此工作的作業： maven
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	1.89.0 或更新
工作類別	建造

另請參閱

• Maven 驗證
• 使用 Azure Pipelines 發佈 Maven 成品
• Java Tool Installer
• 建置 Java 應用程式