مشاركة عبر

PublishCodeCoverageResults@2 - نشر نتائج تغطية التعليمات البرمجية v2 المهمة

  • مقالة

استخدم هذه المهمة للحصول على نتائج تغطية التعليمات البرمجية من بنية.

بناء الجملة

# Publish code coverage results v2
# Publish any of the code coverage results from a build.
- task: PublishCodeCoverageResults@2
  inputs:
    summaryFileLocation: # string. Required. Path to summary files. 
    #pathToSources: # string. Path to Source files. 
    #failIfCoverageEmpty: false # boolean. Fail if code coverage results are missing. Default: false.

الإدخالات

summaryFileLocation - المسار إلى ملفات الملخص
string. مطلوب

يحدد مسار ملف الملخص الذي يحتوي على إحصائيات تغطية التعليمات البرمجية، مثل السطر والأسلوب وتغطية الفئة. يتم دمج ملفات ملخص متعددة في تقرير واحد. قد تحتوي القيمة على أنماط مطابقة مصغرة. على سبيل المثال: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. مزيد من المعلومات حول أنماط المطابقة المصغرة.


pathToSources - المسار إلى الملفات المصدر
string.

يعد تحديد مسار إلى ملفات المصدر مطلوبا عندما لا تحتوي تقارير XML للتغطية على مسار مطلق إلى الملفات المصدر. على سبيل المثال، لا تستخدم تقارير JaCoCo المسارات المطلقة، لذلك عند نشر تغطية JaCoCo لتطبيقات Java، يكون النمط مشابها ل $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. يجب أن يشير هذا الإدخال إلى مسار مطلق إلى الملفات المصدر على المضيف. على سبيل المثال، ⁧$(System.DefaultWorkingDirectory)/MyApp/⁩.

يمكن استخدام هذا الإدخال إذا تم تشغيل الاختبارات في حاوية Docker.


failIfCoverageEmpty - فشل إذا كانت نتائج تغطية التعليمات البرمجية مفقودة
boolean. القيمة الافتراضية: false.

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


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

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

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

لا شيء

الملاحظات

ملاحظة

راجع الإصدار الجديد من مهمة نشر نتائج تغطية التعليمات البرمجية على مدونة Azure DevOps للحصول على معلومات حول الميزات الجديدة في V2 لمهمة نشر نتائج تغطية التعليمات البرمجية، والترحيل من V1 إلى V2.

استخدم هذه المهمة في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء لنشر نتائج تغطية التعليمات البرمجية التي تم إنتاجها عند تشغيل الاختبارات على Azure Pipelines أو TFS وبعد إنشاء ملفات xml للتغطية من أجل الحصول على علامة تبويب تغطية التعليمات البرمجية وتفاصيل الإبلاغ عن التغطية في البنية الأساسية لبرنامج ربط العمليات التجارية. تدعم المهمة تنسيقات xml التي تم إنشاؤها لتغطية التعليمات البرمجية. تنشئ هذه المهمة ملف cjson الذي يحتوي على تفاصيل تغطية التعليمات البرمجية. كما سينتج تقرير HTML لتغطية التعليمات البرمجية ضمن البيانات الاصطناعية للبناء.

هذه المهمة مدعومة فقط في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء، وليس إصدار المسارات.

توفر مهام مثل Visual Studio Testو.NET CoreوAntوMaven و Gulp و Grunt أيضا خيار نشر بيانات تغطية التعليمات البرمجية إلى البنية الأساسية لبرنامج ربط العمليات التجارية. إذا كنت تستخدم هذه المهام، فلن تحتاج إلى مهمة توزيع نتائج تغطية التعليمات البرمجية منفصلة في البنية الأساسية لبرنامج ربط العمليات التجارية.

المتطلبات الأساسية - لاستخدام مهمة Publish Code Coverage Results v2 في البنية الأساسية لبرنامج ربط العمليات التجارية، يرجى استخدام مهمة dotnet 7.0.x كشرط مسبق في البنية الأساسية لبرنامج ربط العمليات التجارية. استخدم المهمة الأساسية dotnet قبل المهمة Publish Code Coverage v2.

المتطلبات الأساسية

لتكوين المتطلبات الأساسية باستخدام مسار YAML:

# Dotnet core sdk task 7.0.x
- task: UseDotNet@2
  displayName: 'Use .NET Core sdk 7.0.x'
  inputs:
    version: 7.0.x

لتكوين المتطلبات الأساسية باستخدام المصمم:

لقطة شاشة تعرض مهمة .Net Core Sdk في البنية الأساسية لبرنامج ربط العمليات التجارية.

  1. قم بتكوين المهمة Publish Code Coverage Results الإصدار 2 باستخدام الإعدادات التالية.

    لقطة شاشة تعرض مهمة نشر نتائج تغطية التعليمات البرمجية الإصدار 2

  2. بعد اكتمال الإنشاء ونجاح مهمة Publish Code Coverage Results v2، حدد علامة التبويب Code Coverage في ملخص تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية لعرض نتائج تغطية التعليمات البرمجية.

    لقطة شاشة تعرض علامة التبويب Code Coverage التي تم إنشاؤها بواسطة مهمة Publish Code coverage V2

نتائج تغطية التعليمات البرمجية ل JavaScript مع اسطنبول باستخدام YAML

لنشر نتائج تغطية التعليمات البرمجية ل JavaScript مع اسطنبول باستخدام YAML، راجع تخصيص JavaScript في قسم الأنظمة البيئية من هذه الموضوعات، والذي يتضمن أيضا أمثلة للغات أخرى.

راجع مثالا على نشر تغطية التعليمات البرمجية باستخدام Cobertura.

Docker

بالنسبة للتطبيقات التي تستخدم Docker، قد يتم تشغيل الإنشاء والاختبارات داخل الحاوية وإنشاء نتائج تغطية التعليمات البرمجية داخل الحاوية. لنشر النتائج إلى البنية الأساسية لبرنامج ربط العمليات التجارية، يجب توفير البيانات الاصطناعية الناتجة لمهمة نشر نتائج تغطية التعليمات البرمجية . للرجوع إليها، يمكنك مشاهدة مثال مشابه لنشر نتائج الاختبار ضمن قسم إنشاء النتائج واختبارها ونشرها باستخدام ملف Docker ل Docker.

عرض النتائج

لعرض نتائج تغطية التعليمات البرمجية في البنية الأساسية لبرنامج ربط العمليات التجارية، راجع مراجعة نتائج تغطية التعليمات البرمجية.

المشكلات المعروفة

تنشئ مهمة نشر تغطية التعليمات البرمجية الإصدار 2 ملف cjson وتنشر تقرير تغطية التعليمات البرمجية ضمن علامة التبويب تغطية التعليمات البرمجية. كما أنه ينتج بيانات اصطناعية للإنشاء وهي مجموعة من ملفات HTML المرتبطة من ملف index.html الرئيسي. إذا فشلت علامة تبويب تغطية التعليمات البرمجية في إظهار تقرير تغطية التعليمات البرمجية، فتحقق مما إذا كان ملف xml لتغطية التعليمات البرمجية للإدخل بالتنسيق الصحيح ولديه التفاصيل الصحيحة.

المتطلبات

المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي
يعمل على عامل
المطالب بلا
القدرات لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 2.144.0 أو أحدث
فئة المهمة الاختبار

راجع أيضًا