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

مقالة
03/26/2024

استخدم هذه المهمة لنشر نتائج تغطية التعليمات البرمجية Cobertura أو JaCoCo من إصدار.

هام

تم إهمال هذه المهمة. يوصى المستخدمين بالتبديل إلى PublishCodeCoverageResults@2. لمزيد من المعلومات، راجع الإصدار الجديد من مهمة نشر نتائج تغطية التعليمات البرمجية.

استخدم هذه المهمة لنشر نتائج تغطية التعليمات البرمجية Cobertura أو JaCoCo من إصدار.

بناء الجملة

# Publish code coverage results v1
# [DEPRECATION WARNING! Users are recommended to switch to version 2*.] Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #pathToSources: # string. Path to Source files. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.

# Publish code coverage results v1
# Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #pathToSources: # string. Path to Source files. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.

# Publish Code Coverage Results v1
# Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.

# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

الإدخالات

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

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

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.

يمكن إضافة مصادر متعددة عن طريق تحديد كل عنصر قائمة بالحرف ; ، على سبيل المثال pathToSources: $(System.DefaultWorkingDirectory)/path/to/first/source;$(System.DefaultWorkingDirectory)/path/to/second/source.

reportDirectory - دليل التقرير
string.

يحدد مسار دليل تقرير HTML لتغطية التعليمات البرمجية. يتم نشر دليل التقرير لعرضه لاحقا كأداة للبناء. قد تحتوي القيمة على أنماط مطابقة مصغرة. على سبيل المثال: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura.

additionalCodeCoverageFiles - ملفات إضافية
string.

يحدد نمط مسار الملف ويشير إلى أي ملفات تغطية تعليمات برمجية إضافية ليتم نشرها كقطع اصطناعية للبنية. قد تحتوي القيمة على أنماط مطابقة مصغرة. على سبيل المثال: $(System.DefaultWorkingDirectory)/**/*.exec.

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

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

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

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

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

لا شيء

الملاحظات

هام

ملاحظة

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

استخدم هذه المهمة في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء لنشر نتائج تغطية التعليمات البرمجية التي تم إنتاجها عند تشغيل الاختبارات إلى Azure Pipelines أو TFS من أجل الحصول على تقارير التغطية. تدعم المهمة تنسيقات نتائج التغطية الشائعة مثل Cobertura وJaCoCo.

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

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

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

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

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

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

Docker

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

عرض النتائج

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

هل يتم دمج بيانات تغطية التعليمات البرمجية عند توفير ملفات متعددة كإدخال للمهمة أو يتم استخدام مهام متعددة في البنية الأساسية لبرنامج ربط العمليات التجارية؟

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

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

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

حدد علامة التبويب build Summary ، ثم حدد الارتباط المنشور :
بجوار الأداة Code Coverage Report_* حدد Download artifacts:
عند تنزيل تقرير تغطية التعليمات البرمجية، استخرج ملف .zip.
في تقرير تغطية التعليمات البرمجية، تحقق من حجم index.html للمساعدة في تحديد ما إذا كان حجم الملف يسبب المشكلة الموضحة هنا.
افتح index.html في مستعرض لعرض تقرير تغطية التعليمات البرمجية.

المتطلبات

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

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

راجع أيضًا

نشر نتائج الاختبار

مشاركة عبر

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

بناء الجملة

الإدخالات

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

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

الملاحظات

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

Docker

عرض النتائج

هل يتم دمج بيانات تغطية التعليمات البرمجية عند توفير ملفات متعددة كإدخال للمهمة أو يتم استخدام مهام متعددة في البنية الأساسية لبرنامج ربط العمليات التجارية؟

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

المتطلبات

راجع أيضًا

الملاحظات

الملاحظات

الموارد الإضافية