Ant@1 - مهمة Ant v1

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

بناء الجملة

# Ant v1
# Build with Apache Ant.
- task: Ant@1
  inputs:
    buildFile: 'build.xml' # string. Alias: antBuildFile. Required. Ant build file. Default: build.xml.
    #options: # string. Options. 
    #targets: # string. Target(s). 
  # 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. 
  # Code Coverage
    #codeCoverageToolOptions: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code coverage tool. Default: None.
    codeCoverageClassFilesDirectories: '.' # string. Alias: classFilesDirectories. Required when codeCoverageTool != None. Class files directories. Default: ..
    #codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class inclusion/exclusion filters. 
    #codeCoverageSourceDirectories: # string. Alias: srcDirectories. Optional. Use when codeCoverageTool != None. Source files directories. 
    #codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail when code coverage results are missing. Default: false.
  # Advanced
    #antHomeDirectory: # string. Alias: antHomeUserInputPath. Set ANT_HOME path. 
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK version. Default: default.
    #jdkUserInputDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

الإدخالات

buildFile - ملف بناء Ant
الاسم المستعار للإدخل: antBuildFile. string. مطلوب القيمة الافتراضية: build.xml.

المسار النسبي من جذر المستودع إلى ملف إنشاء Ant.

لمزيد من المعلومات حول إنشاء الملفات، راجع استخدام Apache Ant.

options - خيارات
string.

يوفر خيارات لتمريرها إلى سطر أوامر Ant. يمكنك توفير خصائصك الخاصة (على سبيل المثال، -DmyProperty=myPropertyValue) واستخدام المتغيرات المضمنة (على سبيل المثال، -DcollectionId=$(system.collectionId)). بدلا من ذلك، يتم تعيين المتغيرات المضمنة بالفعل كمتغيرات بيئة أثناء الإنشاء ويمكن تمريرها مباشرة (على سبيل المثال، -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

راجع تشغيل Apache Ant.

targets - الهدف (الأهداف)
string.

قائمة اختيارية مفصولة بمسافة للأهداف المراد إنشائها. إذا لم يتم تحديده، default فسيتم استخدام الهدف. إذا لم يتم تحديد هدف default ، فسينشئ Ant 1.6.0 والإصدارات الأحدث جميع مهام المستوى الأعلى.

راجع استخدام أهداف Apache Ant.

publishJUnitResults - النشر إلى Azure Pipelines
boolean. القيمة الافتراضية: true.

حدد هذا الخيار لنشر نتائج اختبار JUnit التي تنتجها بنية Ant إلى Azure Pipelines. سيتم نشر كل مطابقة Test Results Files لملف نتائج الاختبار كتشغيل اختبار في Azure Pipelines.

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

مسار ملف نتائج الاختبار. يمكن استخدام أحرف البدل. لمزيد من المعلومات، راجع مرجع أنماط مطابقة الملف. على سبيل المثال، **/TEST-*.xml لجميع ملفات XML التي يبدأ اسمها ب TEST-.

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

يوفر اسما لتشغيل الاختبار.

codeCoverageToolOptions - أداة تغطية التعليمات البرمجية
الاسم المستعار للإدخل: codeCoverageTool. string. القيم المسموح بها: None، ، Cobertura. JaCoCo القيمة الافتراضية: None.

تحديد أداة تغطية التعليمات البرمجية.

إذا كنت تستخدم العوامل المستضافة من Microsoft، فسيتم إعداد الأدوات لك. إذا كنت تستخدم عامل Windows المحلي، فيجب عليك التأكد من إعداد العامل إما ل JaCoco أو Cobertura.

• JaCoCo - تأكد من توفر jacocoant.jar في مجلد lib لتثبيت Ant. تعرف على المزيد حول مهام JaCoCo Ant.
• Cobertura - تأكد من أن متغير البيئة COBERTURA_HOME يشير إلى موقع ملفات .jar Cobertura. تعرف على المزيد حول Cobertura مع مهام Ant.

بعد تحديد إحدى هذه الأدوات، تظهر الوسيطات التالية:

codeCoverageClassFilesDirectories - دلائل ملفات الفئة
الاسم المستعار للإدخل: classFilesDirectories. string. مطلوب عند codeCoverageTool != None. القيمة الافتراضية: ..

قائمة المسارات النسبية المفصولة بفواصل من ملف إنشاء Ant إلى الدلائل التي تحتوي على ملفات الفئة وملفات الأرشيف (.jar، .war، وما إلى ذلك). يتم الإبلاغ عن تغطية التعليمات البرمجية لملفات الفئة في هذه الدلائل. على سبيل المثال: target/classes,target/testClasses.

codeCoverageClassFilter - عوامل تصفية تضمين/استبعاد الفئة
الاسم المستعار للإدخل: classFilter. string. ‏‏اختياري. استخدم عندما codeCoverageTool != None.

قائمة عوامل التصفية المفصولة بفواصل لتضمين الفئات أو استبعادها من جمع تغطية التعليمات البرمجية. على سبيل المثال +:com.، +:org.، -:my.app*..

codeCoverageSourceDirectories - دلائل ملفات المصدر
الاسم المستعار للإدخل: srcDirectories. string. ‏‏اختياري. استخدم عندما codeCoverageTool != None.

قائمة المسارات النسبية المفصولة بفواصل من ملف إنشاء Ant إلى دلائل التعليمات البرمجية المصدر. ستستخدم تقارير تغطية التعليمات البرمجية هذه لتمييز التعليمات البرمجية المصدر. على سبيل المثال: src/java,src/Test.

codeCoverageFailIfEmpty - فشل عندما تكون نتائج تغطية التعليمات البرمجية مفقودة
الاسم المستعار للإدخل: failIfCoverageEmpty. boolean. ‏‏اختياري. استخدم عندما codeCoverageTool != None. القيمة الافتراضية: false.

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

antHomeDirectory - تعيين مسار ANT_HOME
الاسم المستعار للإدخل: antHomeUserInputPath. string.

إذا تم تعيينه، يتجاوز أي متغير بيئة ANT_HOME موجود بالمسار المحدد.

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

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

jdkVersionOption - إصدار JDK
الاسم المستعار للإدخل: jdkVersion. string. ‏‏اختياري. استخدم عندما javaHomeSelection = JDKVersion. القيم المسموح بها: default، 1.11 (JDK 11)، 1.10 (JDK 10 (خارج الدعم))، 1.9 (JDK 9 (خارج الدعم))، 1.8 (JDK 8)، 1.7 (JDK 7)، 1.6 (JDK 6 (خارج الدعم)). القيمة الافتراضية: default.

محاولات لاكتشاف المسار إلى إصدار JDK المحدد وتعيين JAVA_HOME وفقا لذلك.

jdkUserInputDirectory - مسار JDK
الاسم المستعار للإدخل: jdkUserInputPath. string. مطلوب عند javaHomeSelection = Path.

تعيين JAVA_HOME إلى المسار المحدد.

jdkArchitectureOption - بنية JDK
الاسم المستعار للإدخل: jdkArchitecture. string. ‏‏اختياري. استخدم عندما jdkVersion != default. القيم المسموح بها: x86، . x64 القيمة الافتراضية: x64.

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

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

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

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

لا شيء

الملاحظات

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

المتطلبات

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