Kover คือชุดโซลูชันสำหรับรวบรวมการทดสอบครอบคลุมโค้ด Kotlin ที่คอมไพล์สำหรับแพลตฟอร์ม JVM และ Android
ชุดเครื่องมือ Kover:
ปลั๊กอิน Kover Gradle
ปลั๊กอิน Kover Maven
โคเวอร์ ซีแอลไอ
เครื่องมือวัดออฟไลน์ Kover
ตัวแทน Kover JVM
Kover มีสิ่งประดิษฐ์
สำหรับข้อมูลทั้งหมดเกี่ยวกับปลั๊กอิน Kover Gradle เวอร์ชันเสถียรล่าสุด โปรดดูที่เอกสารประกอบ
การรวบรวมการครอบคลุมโค้ดผ่านการทดสอบ JVM
(ยังไม่รองรับ JS และเป้าหมายดั้งเดิม)
การสร้างรายงาน HTML
และ XML
รองรับ Kotlin JVM
และโครงการ Kotlin Multiplatform
รองรับโปรเจ็กต์ Kotlin Android
ที่มีเวอร์ชันบิลด์ (ยังไม่รองรับการทดสอบเครื่องมือที่ดำเนินการบนอุปกรณ์ Android)
รองรับซอร์ส Kotlin
และ Java
แบบผสม
กฎการตรวจสอบที่มีขอบเขตในปลั๊กอิน Gradle เพื่อติดตามความครอบคลุม
การใช้ไลบรารี JaCoCo ในปลั๊กอิน Gradle เป็นทางเลือกสำหรับการวัดความครอบคลุมและการสร้างรายงาน
วิธีการสมัคร Kover ที่แนะนำคือการใช้ปลั๊กอิน DSL
Gradle
เวอร์ชันขั้นต่ำที่รองรับคือ 6.8
เพิ่มสิ่งต่อไปนี้ลงในไฟล์บิลด์ระดับบนสุดของคุณ:
ปลั๊กอิน { id("org.jetbrains.kotlinx.kover") เวอร์ชัน "0.9.0-RC"}
ปลั๊กอิน { รหัส 'org.jetbrains.kotlinx.kover' เวอร์ชัน '0.9.0-RC'}
หลังจากคุณใช้ปลั๊กอิน Kover Gradle งาน Kover จะถูกสร้างขึ้นเพื่อสร้างรายงานและการตรวจสอบ เช่น เพื่อสร้างรายงาน HTML run ./gradlew koverHtmlReport
- สิ่งนี้จะเริ่มการคอมไพล์โค้ดโดยอัตโนมัติ การดำเนินการทดสอบแบบมีเครื่องมือ และรายงาน HTML จะถูกสร้างขึ้นพร้อมผลลัพธ์การวัดในโฟลเดอร์บิลด์
สิ่งสำคัญคือหลังจากใช้ปลั๊กอิน Kover Gradle ในระหว่างการทดสอบที่รันอยู่ คลาสจะถูกแก้ไข (มีเครื่องมือ) เมื่อโหลดลงใน JVM ซึ่งอาจส่งผลให้ประสิทธิภาพลดลงหรือส่งผลต่อการทดสอบพร้อมกัน
สามารถใช้วิธีดั้งเดิมในการใช้ปลั๊กอินได้หากคุณไม่สามารถใช้ปลั๊กอิน DSL ได้ด้วยเหตุผลบางประการ
บิลด์สคริปต์ { ที่เก็บ { มาเวนเซ็นทรัล() - การพึ่งพา { classpath("org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC") - }สมัคร(ปลั๊กอิน = "org.jetbrains.kotlinx.kover")
บิลด์สคริปต์ { ที่เก็บ { มาเวนเซ็นทรัล() - การพึ่งพา { classpath 'org.jetbrains.kotlinx:kover-gradle-plugin:0.9.0-RC'} - ใช้ปลั๊กอิน: 'org.jetbrains.kotlinx.kover'
คุณต้องเพิ่มการขึ้นต่อกันในโครงการ ซึ่งงานรายงานจะถูกรัน
การพึ่งพา { kover(โครงการ(":อีก:โครงการ")) -
ในกรณีนี้ รายงานจะถูกสร้างขึ้นสำหรับโปรเจ็กต์ปัจจุบันที่เข้าร่วมกับ :another:project
project
ตัวอย่างเพิ่มเติมของการใช้ปลั๊กอิน Gradle สามารถพบได้ในโฟลเดอร์ตัวอย่าง
Kover Aggregated Plugin เป็นต้นแบบของปลั๊กอิน Gradle Settings ที่สร้างขึ้นเพื่อลดความซับซ้อนในการตั้งค่าบิลด์หลายโปรเจ็กต์ ยังอยู่ในช่วงเริ่มต้นขอแนะนำให้ใช้สำหรับโครงการทดสอบหรือสัตว์เลี้ยงเท่านั้น
โปรดดูเอกสารประกอบสำหรับรายละเอียด
สามารถใช้ปลั๊กอิน Kover Maven ได้โดยระบุปลั๊กอิน build
<ปลั๊กอิน> <groupId>org.jetbrains.kotlinx</groupId> <artifactId>kover-maven-plugin</artifactId> <เวอร์ชัน>0.9.0-RC</เวอร์ชัน> </ปลั๊กอิน>
รายการเป้าหมายของ Kover ระบุไว้ในส่วนเอกสารนี้
สำหรับข้อมูลทั้งหมดเกี่ยวกับปลั๊กอิน Kover Maven เวอร์ชันเสถียรล่าสุด โปรดดูที่เอกสารประกอบ
แอปพลิเคชัน JVM แบบสแตนด์อโลนที่ใช้สำหรับเครื่องมือวัดแบบออฟไลน์และสร้างรายงานที่มนุษย์สามารถอ่านได้
เอกสารประกอบของ Kover CLI
เครื่องมือวัดแบบออฟไลน์คือการแก้ไขคลาสไฟล์ที่จัดเก็บไว้ในดิสก์เพื่อวัดความครอบคลุม
วิธีการใช้เครื่องมือวัดแบบออฟไลน์และการทำงานของแอปพลิเคชันที่ใช้เครื่องมืออธิบายไว้ในเอกสารประกอบ
เอเจนต์ JVM เป็นไฟล์ jar ที่แก้ไขโค้ดไบต์ที่โหลดลงในคลาส JVM เพื่อวัดความครอบคลุม เอกสารประกอบ
การพึ่งพา JVM ที่อนุญาตให้ใช้เครื่องมือคลาสไฟล์บนดิสก์โดยทางโปรแกรม
เอกสารประกอบของ Kover มีสิ่งประดิษฐ์
ดูแนวทางการมีส่วนร่วม