Kover عبارة عن مجموعة من الحلول لجمع تغطية اختبارية لكود Kotlin الذي تم تجميعه لمنصات JVM وAndroid.
مجموعة أدوات كوفر:
البرنامج المساعد Kover Gradle
كوفر مافن البرنامج المساعد
كوفر كلي
كوفر الأجهزة حاليا
وكيل Kover JVM
يتميز Kover بقطعة أثرية
للحصول على معلومات كاملة حول أحدث إصدار مستقر من Kover Gradle Plugin، يرجى الرجوع إلى الوثائق.
مجموعة تغطية التعليمات البرمجية من خلال اختبارات JVM
(لم يتم دعم JS والأهداف الأصلية حتى الآن).
إنشاء تقارير HTML
و XML
.
دعم مشاريع Kotlin JVM
Kotlin Multiplatform
.
دعم مشاريع Kotlin Android
مع متغيرات البناء (اختبارات الأجهزة التي يتم تنفيذها على جهاز Android غير مدعومة حتى الآن).
دعم مصادر Kotlin
و Java
المختلطة
قواعد التحقق ذات الحدود في البرنامج المساعد Gradle لتتبع التغطية.
استخدام مكتبة JaCoCo في البرنامج المساعد Gradle كبديل لقياس التغطية وإنشاء التقارير.
الطريقة الموصى بها لتطبيق Kover هي باستخدام المكونات الإضافية DSL.
الحد الأدنى للإصدار المدعوم من Gradle
هو 6.8
.
أضف ما يلي إلى ملف البناء ذي المستوى الأعلى الخاص بك:
الإضافات { المعرف ("org.jetbrains.kotlinx.kover") الإصدار "0.9.0-RC"}
الإضافات { المعرف "org.jetbrains.kotlinx.kover" الإصدار "0.9.0-RC"}
بعد تطبيق البرنامج المساعد Kover Gradle، سيتم إنشاء مهام Kover لإنشاء التقارير والتحقق. على سبيل المثال، لإنشاء تقرير HTML، قم بتشغيل ./gradlew koverHtmlReport
- سيبدأ هذا تلقائيًا في تجميع التعليمات البرمجية وتنفيذ الاختبارات المجهزة، وسيتم إنشاء تقرير HTML مع نتائج القياس في مجلد البناء.
من المهم أيضًا أنه بعد تطبيق البرنامج المساعد Kover Gradle، أثناء اختبارات التشغيل، يتم تعديل الفئات (الأدوات) عند تحميلها في JVM مما قد يؤدي إلى بعض تدهور الأداء، أو التأثير على الاختبارات المتزامنة.
يمكن استخدام الطريقة القديمة لتطبيق المكونات الإضافية إذا لم تتمكن من استخدام DSL للمكونات الإضافية لسبب ما.
بناء النصي { المستودعات { مافن سنترال () } التبعيات { classpath("org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC") } }apply(plugin = "org.jetbrains.kotlinx.kover")
بناء النصي { المستودعات { مافن سنترال () } التبعيات { classpath 'org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC'} } تطبيق البرنامج المساعد: "org.jetbrains.kotlinx.kover"
يجب عليك إضافة تبعية إلى المشروع، حيث سيتم تشغيل مهمة التقرير
التبعيات { كوفر(مشروع(":آخر:مشروع")) }
في هذه الحالة، سيتم إنشاء تقرير للمشروع الحالي المنضم إلى مشروع :another:project
مشروع.
يمكن العثور على المزيد من الأمثلة لتطبيق البرنامج المساعد Gradle في مجلد المثال
Kover Aggreated Plugin كنموذج أولي للمكون الإضافي Gradle Settings، تم إنشاؤه لتبسيط إعداد تصميمات المشاريع المتعددة. إنه في بداياته، ويوصى باستخدامه فقط للاختبار أو لمشاريع الحيوانات الأليفة.
الرجوع إلى الوثائق للحصول على التفاصيل.
يمكن تطبيق البرنامج المساعد Kover Maven عن طريق تحديد البرنامج المساعد للبناء
<البرنامج المساعد> <groupId>org.jetbrains.kotlinx</groupId> <artifactId>kover-maven-plugin</artifactId> <الإصدار>0.9.0-RC</الإصدار> </plugin>
تم تحديد قائمة أهداف Kover في قسم الوثيقة هذا.
للحصول على معلومات كاملة حول أحدث إصدار مستقر من Kover Maven Plugin، يرجى الرجوع إلى الوثائق.
تطبيق JVM مستقل يستخدم للأجهزة غير المتصلة بالإنترنت وإنشاء تقارير يمكن قراءتها بواسطة الإنسان.
توثيق Kover CLI.
الأجهزة غير المتصلة بالإنترنت هي تعديل ملفات الفئات المخزنة على القرص لقياس تغطيتها.
يتم وصف طرق الأجهزة دون اتصال بالإنترنت وتشغيل التطبيقات المُجهزة في الوثائق.
وكيل JVM هو ملف jar يقوم بتعديل الرمز الثانوي الذي تم تحميله في فئات JVM لقياس التغطية. الوثائق.
تبعية JVM التي تسمح بأداة ملفات الفئة برمجيًا على القرص.
توثيق ميزات Kover قطعة أثرية
راجع إرشادات المساهمة.