عرض تقارير نسبة استخدام رموز الصفحة

يمكن لمكوّن إضافي لنظام Gradle المتوافق مع Android إنشاء تقارير حول نسبة استخدام رموز الصفحة تتتبّع النسبة المئوية لرموزك البرمجية التي تغطّيها اختباراتك. توضّح هذه الصفحة كيفية تفعيل ميزة إعداد تقارير التغطية وإنشاء التقارير.

يمكنك إنشاء تقارير تغطية لكل نوع اختبار (وحدة وقياس حالة التطبيق) لكل صيغة. يمكنك أيضًا إنشاء تقارير موحّدة حول التغطية على مستوى أنواع الاختبارات المختلفة والوحدات النمطية وإصدارات الإنشاء.

تفعيل نسبة استخدام رموز الصفحة

يجب تفعيل نسبة استخدام رموز الصفحة من خلال ضبط enableAndroidTestCoverage وenableUnitTestCoverage على true في ملفات الإصدار على مستوى الوحدة لكل صيغة تريد الحصول على تقارير التغطية لها:

Kotlin

android {
    // ...
    buildTypes {
        debug {
            // Enable coverage for unit tests
            enableUnitTestCoverage = true
            // Enable coverage for instrumentation tests
            enableAndroidTestCoverage = true
        }
    }
}

Groovy

android {
    // ...
    buildTypes {
        debug {
            // Enable coverage for unit tests
            enableUnitTestCoverage true
            // Enable coverage for instrumentation tests
            enableAndroidTestCoverage true
        }
    }
}

تغيير إصدار Jacoco (اختياري)

تطبِّق "مكوّنات Android الإضافية في Gradle" أداة Jacoco تلقائيًا عند تفعيل التغطية في الوحدات. ومع ذلك، إذا كنت بحاجة إلى استخدام إصدار معيّن من Jacoco، يمكنك تحديده في ملف التصميم على مستوى الوحدة:

Kotlin

android {
    jacoco {
        version = "JACOCO_VERSION"
    }
}

Groovy

android {
    jacoco {
        version = 'JACOCO_VERSION'
    }
}

إنشاء تقارير تغطية خاصة بمتغيرات التطبيق

لإنشاء تقارير تغطية لوحدة اختبار فقط أو اختبارات مزوَّدة بأدوات فقط لمتغير معيّن، شغِّل المهام المناسبة.

نوع الاختبار الأمر الإبلاغ عن الموقع الجغرافي
اختبارات الوحدات ./gradlew :module-name:createVariantNameUnitTestCoverageReport path-to-your-project/module-name/build/reports/coverage/test/variant/index.html
اختبارات قياس حالة التطبيق ./gradlew :module-name:createVariantNameAndroidTestCoverageReport path-to-your-project/module-name/build/reports/coverage/androidTest/variant/connected/index.html

إنشاء تقارير موحَّدة حول نسبة استخدام رموز الصفحة

يمكنك إنشاء تقارير موحّدة لنسبة استخدام رموز الصفحة باستخدام مهمتَي Gradle createCoverageReport وcreateAggregatedCoverageReport. يمكنك استخدام هذه المهام لإنشاء تقرير HTML واحد يجمع بيانات التغطية من أنواع الاختبارات المختلفة (الوحدة وقياس حالة التطبيق) والوحدات ومتغيرات الإصدار. يوفّر ذلك نظرة شاملة على نسبة استخدام رموز الصفحة لمشروعك في لوحة بيانات واحدة.

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

  • الإصدار ‎9.2.0-alpha07 من المكوّن الإضافي لنظام Gradle المتوافق مع Android أو إصدار أحدث

لإنشاء تقرير موحّد، نفِّذ إحدى المهام التالية من سطر الأوامر:

نطاق التغطية الأمر الوصف الإبلاغ عن الموقع الجغرافي
الوحدة الحالية ./gradlew :module-name:createCoverageReport تُنشئ هذه السمة تقرير تغطية موحّدًا للوحدة الحالية، وتدمج البيانات من جميع أنواع الاختبارات. path-to-your-project/module-name/build/reports/code_coverage_html_report/
الوحدة الحالية والوحدات التابعة ./gradlew :module-name:createAggregatedCoverageReport تُنشئ تقرير تغطية موحّدًا للوحدة الحالية وجميع العناصر التابعة لها. تتوفّر هذه المهمة لوحدات التطبيق ووحدات المكتبة التي تم تفعيل النشر فيها. path-to-your-project/module-name/build/reports/aggregated_code_coverage_html_report/

تعرض الصفحة المقصودة لتقرير HTML الذي تم إنشاؤه ملخّصًا عالي المستوى لجميع الوحدات. يمكنك الانتقال من الوحدة إلى الحزمة، ومن الحزمة إلى الفئة، ومن الفئة إلى ملف المصدر. انقر على أي ملف للاطّلاع على الرمز مع تمييز تغطية الأسطر والفروع:

  • أخضر: الأسطر التي تمّت تغطيتها
  • أحمر: الأسطر غير المغطّاة
  • أصفر: تغطية جزئية (بعض التعليمات أو الفروع غير متوفرة).