Maven@1 - مهمة Maven v1

استخدم هذه المهمة للبناء باستخدام Apache Maven.

بناء الجملة

# Maven v1
# Build with Apache Maven.
- task: Maven@1
  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 TFS/Team Services. 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. 
  # 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.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '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 built-in Maven feeds. Default: true.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube Analysis. Default: false.
    #sonarQubeServiceEndpoint: # string. Alias: sqConnectedServiceName. Required when sqAnalysisEnabled = true. SonarQube Endpoint. 
    #sonarQubeProjectName: # string. Alias: sqProjectName. Optional. Use when sqAnalysisEnabled = true. SonarQube Project Name. 
    #sonarQubeProjectKey: # string. Alias: sqProjectKey. Optional. Use when sqAnalysisEnabled = true. SonarQube Project Key. 
    #sonarQubeProjectVersion: # string. Alias: sqProjectVersion. Optional. Use when sqAnalysisEnabled = true. SonarQube Project Version. 
    #sonarQubeSpecifyDB: false # boolean. Alias: sqDbDetailsRequired. Optional. Use when sqAnalysisEnabled = true. The SonarQube server version is lower than 5.2. Default: false.
    #sonarQubeDBUrl: # string. Alias: sqDbUrl. Optional. Use when sqDbDetailsRequired = true. Db Connection String. 
    #sonarQubeDBUsername: # string. Alias: sqDbUsername. Optional. Use when sqDbDetailsRequired = true. Db Username. 
    #sonarQubeDBPassword: # string. Alias: sqDbPassword. Optional. Use when sqDbDetailsRequired = true. Db User Password. 
    #sonarQubeIncludeFullReport: true # boolean. Alias: sqAnalysisIncludeFullReport. Optional. Use when sqAnalysisEnabled = true. Include full analysis report in the build summary (SQ 5.3+). Default: true.
    #sonarQubeFailWhenQualityGateFails: # boolean. Alias: sqAnalysisBreakBuildIfQualityGateFailed. Optional. Use when sqAnalysisEnabled = true. Fail the build on quality gate failure (SQ 5.3+). 
    #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 - النشر إلى TFS/Team Services
boolean. القيمة الافتراضية: true.

يحدد خيار نشر نتائج اختبار JUnit التي ينتجها إصدار Maven إلى TFS/Team Services. سيتم نشر كل مطابقة Test Results Files لملف نتائج الاختبار كتشغيل اختبار في TFS/Team Services.

testResultsFiles - ملفات نتائج الاختبار
string. مطلوب عند publishJUnitResults = true. القيمة الافتراضية: **/TEST-*.xml.

يحدد مسار ونمط ملفات نتائج الاختبار المراد نشرها. على سبيل المثال، **/TEST-*.xml لجميع ملفات XML ذات الاسم الذي يبدأ ب TEST-. إذا لم يتم تحديد مسار جذر، تتم مطابقة الملفات أسفل دليل العمل الافتراضي، والتي تتوفر قيمتها في المتغير $(System.DefaultWorkingDirectory). على سبيل المثال، ستؤدي قيمة **/TEST-*.xml بالفعل إلى مطابقة الملفات من $(System.DefaultWorkingDirectory)/**/TEST-*.xml.

testRunTitle - اختبار عنوان التشغيل
string. ‏‏اختياري. استخدم عندما publishJUnitResults = true.

يحدد اسما لتشغيل الاختبار.

codeCoverageToolOption - أداة تغطية التعليمات البرمجية
الاسم المستعار للإدخل: codeCoverageTool. string. القيم المسموح بها: None، ، CoberturaJaCoCo. القيمة الافتراضية: 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.

يفشل البناء إذا لم تنتج تغطية التعليمات البرمجية أي نتائج لنشرها.

javaHomeOption - تعيين JAVA_HOME بواسطة
الاسم المستعار للإدخل: javaHomeSelection. string. مطلوب القيم المسموح بها: JDKVersion (إصدار JDK)، Path. القيمة الافتراضية: JDKVersion.

يعين JAVA_HOME إما عن طريق تحديد إصدار JDK الذي سيتم اكتشافه أثناء الإصدارات أو عن طريق إدخال مسار JDK يدويا.

jdkVersionOption - إصدار JDK
الاسم المستعار للإدخل: jdkVersion. string. ‏‏اختياري. استخدم عندما javaHomeSelection = JDKVersion. القيم المسموح بها: default، 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.

يوفر بنية (x86، x64) ل JDK.

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 - مصادقة موجزات Maven المضمنة
الاسم المستعار للإدخل: mavenFeedAuthenticate. boolean. القيمة الافتراضية: true.

المصادقة تلقائيا باستخدام موجزات Azure Artifacts. إذا لم تكن موجزات Artifacts قيد الاستخدام، فإلغاء تحديد هذا الخيار للحصول على إصدارات أسرع.

sonarQubeRunAnalysis - تشغيل تحليل SonarQube
الاسم المستعار للإدخل: sqAnalysisEnabled. boolean. القيمة الافتراضية: false.

يقوم بتشغيل تحليل SonarQube بعد تنفيذ الأهداف الحالية. install يجب تنفيذ الأهداف أو package أولا.

sonarQubeServiceEndpoint - نقطة نهاية SonarQube
الاسم المستعار للإدخل: sqConnectedServiceName. string. مطلوب عند sqAnalysisEnabled = true.

يحدد نقطة النهاية العامة لخادم SonarQube.

sonarQubeProjectName - اسم مشروع SonarQube
الاسم المستعار للإدخل: sqProjectName. string. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true.

يحدد اسم مشروع SonarQube، على سبيل المثال sonar.projectName.

sonarQubeProjectKey - مفتاح مشروع SonarQube
الاسم المستعار للإدخل: sqProjectKey. string. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true.

يحدد مفتاح مشروع SonarQube الفريد، على سبيل المثال sonar.projectKey.

sonarQubeProjectVersion - إصدار مشروع SonarQube
الاسم المستعار للإدخل: sqProjectVersion. string. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true.

يحدد إصدار مشروع SonarQube، على سبيل المثال sonar.projectVersion.

sonarQubeSpecifyDB - إصدار خادم SonarQube أقل من 5.2
الاسم المستعار للإدخل: sqDbDetailsRequired. boolean. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true. القيمة الافتراضية: false.

إذا كنت تستخدم خادم SonarQube 5.1 أو أقل، يجب تحديد تفاصيل اتصال قاعدة البيانات.

sonarQubeDBUrl - سلسلة اتصال Db
الاسم المستعار للإدخل: sqDbUrl. string. ‏‏اختياري. استخدم عندما sqDbDetailsRequired = true.

استخدم لخادم SonarQube 5.1 والإقلال فقط.
يحدد إعداد اتصال قاعدة البيانات (على سبيل المثال، sonar.jdbc.url أو jdbc:jtds:sqlserver://localhost/sonar;SelectMethod=Cursor).

sonarQubeDBUsername - اسم مستخدم Db
الاسم المستعار للإدخل: sqDbUsername. string. ‏‏اختياري. استخدم عندما sqDbDetailsRequired = true.

استخدم لخادم SonarQube 5.1 والإقلال فقط.
يحدد اسم المستخدم لمستخدم قاعدة البيانات (على سبيل المثال، sonar.jdbc.username).

sonarQubeDBPassword - كلمة مرور مستخدم Db
الاسم المستعار للإدخل: sqDbPassword. string. ‏‏اختياري. استخدم عندما sqDbDetailsRequired = true.

استخدم لخادم SonarQube 5.1 والإقلال فقط.
يحدد كلمة المرور لمستخدم قاعدة البيانات (على سبيل المثال، sonar.jdbc.password).

sonarQubeIncludeFullReport - تضمين تقرير التحليل الكامل في ملخص البناء (SQ 5.3+)
الاسم المستعار للإدخل: sqAnalysisIncludeFullReport. boolean. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true. القيمة الافتراضية: true.

سيؤدي هذا الخيار إلى تأخير الإنشاء حتى يكتمل تحليل SonarQube.

sonarQubeFailWhenQualityGateFails - فشل البناء على فشل بوابة الجودة (SQ 5.3+)
الاسم المستعار للإدخل: sqAnalysisBreakBuildIfQualityGateFailed. boolean. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true.

يتوفر هذا الخيار فقط عند استخدام خادم SonarQube 5.3 أو أعلى. يقدم تأخيرات، حيث يجب أن ينتظر الإصدار حتى يكمل SonarQube التحليل. مزيد من المعلومات حول بوابات جودة SonarQube.

checkStyleRunAnalysis - تشغيل Checkstyle
الاسم المستعار للإدخل: checkstyleAnalysisEnabled. boolean. القيمة الافتراضية: false.

تشغيل أداة Checkstyle مع عمليات فحص الشمس الافتراضية. يتم تحميل النتائج كقطع اصطناعية للبناء.

pmdRunAnalysis - تشغيل PMD
الاسم المستعار للإدخل: pmdAnalysisEnabled. boolean. القيمة الافتراضية: false.

يستخدم أداة التحليل الثابت PMD للبحث عن الأخطاء في التعليمات البرمجية. يتم تحميل النتائج كقطع اصطناعية للبناء.

findBugsRunAnalysis - تشغيل FindBugs
الاسم المستعار للإدخل: findbugsAnalysisEnabled. boolean. القيمة الافتراضية: false.

يستخدم أداة تحليل FindBugs الثابتة للبحث عن الأخطاء في التعليمات البرمجية. يتم تحميل النتائج كقطع اصطناعية للبناء.

خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	يجب أن يكون لدى الوكلاء المستضافين ذاتيا قدرات تطابق المتطلبات التالية لتشغيل المهام التي تستخدم هذه المهمة: maven
القدرات	لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	1.89.0 أو أحدث
فئة المهمة	البنية

راجع أيضًا

• مصادقة Maven
• نشر بيانات Maven الاصطناعية باستخدام Azure Pipelines
• مثبت أداة Java
• إنشاء تطبيقات Java