Bazel มีคำสั่งย่อย coverage เพื่อสร้างรายงานการครอบคลุมของโค้ด ในที่เก็บที่ทดสอบได้ด้วย bazel coverage เนื่องจากลักษณะเฉพาะของระบบนิเวศของภาษาต่างๆ การทำให้ฟีเจอร์นี้ใช้งานได้กับโปรเจ็กต์หนึ่งๆ จึงอาจไม่ใช่เรื่องง่ายเสมอไป
หน้านี้จะอธิบายกระบวนการทั่วไปในการสร้างและดูรายงานความครอบคลุม รวมถึงมีหมายเหตุเฉพาะภาษาสำหรับภาษาที่มีการกำหนดค่าที่ทราบกันดี คุณควรอ่านส่วนทั่วไปก่อน แล้วจึงอ่านเกี่ยวกับข้อกำหนดของภาษาที่ต้องการ นอกจากนี้ โปรดดูส่วนการดำเนินการจากระยะไกล ซึ่งต้องพิจารณาเพิ่มเติม
แม้ว่าคุณจะปรับแต่งได้หลายอย่าง แต่เอกสารนี้จะเน้นที่การสร้างและใช้
lcovรายงาน ซึ่งเป็นวิธีที่ได้รับการสนับสนุนมากที่สุดในปัจจุบัน
การสร้างรายงานความครอบคลุม
การเตรียมพร้อม
เวิร์กโฟลว์พื้นฐานสำหรับการสร้างรายงานความครอบคลุมต้องมีสิ่งต่อไปนี้
- ที่เก็บข้อมูลพื้นฐานที่มีเป้าหมายการทดสอบ
- ชุดเครื่องมือที่มีเครื่องมือการครอบคลุมของโค้ดเฉพาะภาษาติดตั้งอยู่
- การกำหนดค่า "การวัดคุม" ที่ถูกต้อง
2 ข้อแรกเป็นแบบเฉพาะภาษาและค่อนข้างตรงไปตรงมา แต่ข้อสุดท้ายอาจยากกว่าสำหรับโปรเจ็กต์ที่ซับซ้อน
“การวัดคุม” ในที่นี้หมายถึงเครื่องมือความครอบคลุมที่ใช้สำหรับเป้าหมายหนึ่งๆ Bazel อนุญาตให้เปิดใช้ฟีเจอร์นี้สำหรับไฟล์บางไฟล์โดยใช้
--instrumentation_filter
แฟล็ก ซึ่งระบุตัวกรองสำหรับเป้าหมายที่ทดสอบโดยเปิดใช้การวัดคุม ต้องใช้แฟล็ก
--instrument_test_targets
เพื่อเปิดใช้การวัดคุมสำหรับการทดสอบ
โดยค่าเริ่มต้น Bazel จะพยายามจับคู่แพ็กเกจเป้าหมายและพิมพ์ตัวกรองที่เกี่ยวข้องเป็นข้อความ INFO
การเรียกใช้ความครอบคลุม
หากต้องการสร้างรายงานความครอบคลุม ให้ใช้ bazel coverage
--combined_report=lcov
[target] ซึ่งจะเรียกใช้การทดสอบสำหรับเป้าหมาย โดยสร้างรายงานความครอบคลุมในรูปแบบ lcov สำหรับแต่ละไฟล์
เมื่อเสร็จแล้ว Bazel จะเรียกใช้การดำเนินการที่รวบรวมไฟล์ความครอบคลุมทั้งหมดที่สร้างขึ้น
และผสานไฟล์เหล่านั้นเป็นไฟล์เดียว ซึ่งจะสร้างขึ้นในที่สุด
ภายใต้ $(bazel info
output_path)/_coverage/_coverage_report.dat
ระบบจะสร้างรายงานความครอบคลุมแม้ว่าการทดสอบจะล้มเหลว แต่โปรดทราบว่ารายงานนี้จะไม่รวมการทดสอบที่ล้มเหลว โดยจะรายงานเฉพาะการทดสอบที่ผ่านเท่านั้น
การดูความครอบคลุม
ระบบจะแสดงรายงานความครอบคลุมในรูปแบบ lcov ที่ไม่ใช่รูปแบบที่มนุษย์อ่านได้เท่านั้น จากรายงานนี้ เราสามารถใช้ยูทิลิตี genhtml (ซึ่งเป็นส่วนหนึ่งของ โปรเจ็กต์ lcov) เพื่อสร้างรายงานที่ดูได้ในเว็บเบราว์เซอร์
genhtml --branch-coverage --output genhtml "$(bazel info output_path)/_coverage/_coverage_report.dat"
โปรดทราบว่า genhtml จะอ่านซอร์สโค้ดด้วยเพื่อใส่คำอธิบายประกอบความครอบคลุมที่ขาดหายไปในไฟล์เหล่านี้ เพื่อให้ฟีเจอร์นี้ทำงานได้ คุณต้องเรียกใช้ genhtml ในรูทของโปรเจ็กต์ Bazel
หากต้องการดูผลลัพธ์ เพียงเปิดไฟล์ index.html ที่สร้างขึ้นในไดเรกทอรี genhtml ในเว็บเบราว์เซอร์ใดก็ได้
หากต้องการความช่วยเหลือและข้อมูลเพิ่มเติมเกี่ยวกับเครื่องมือ genhtml หรือรูปแบบความครอบคลุม
lcov โปรดดู โปรเจ็กต์ lcov
การดำเนินการจากระยะไกล
การเรียกใช้การดำเนินการทดสอบจากระยะไกลในปัจจุบันมีข้อควรระวังบางประการดังนี้
- การดำเนินการรวมรายงานยังไม่สามารถเรียกใช้จากระยะไกลได้ เนื่องจาก Bazel ไม่ถือว่าไฟล์เอาต์พุตความครอบคลุมเป็นส่วนหนึ่งของกราฟ (ดูปัญหาข้อนี้) จึงไม่สามารถจัดการไฟล์เหล่านี้เป็นอินพุตสำหรับการดำเนินการรวมได้อย่างถูกต้อง หากต้องการหลีกเลี่ยงปัญหานี้ ให้ใช้
--strategy=CoverageReport=local- หมายเหตุ: คุณอาจต้องระบุค่า เช่น
--strategy=CoverageReport=local,remoteแทน หากตั้งค่า Bazel ให้ลองใช้local,remoteเนื่องจากวิธีที่ Bazel แก้ไขกลยุทธ์
- หมายเหตุ: คุณอาจต้องระบุค่า เช่น
- คุณยังใช้แฟล็ก
--remote_download_minimalและแฟล็กที่คล้ายกันไม่ได้ด้วยเนื่องจากข้อจำกัดก่อนหน้านี้ - ปัจจุบัน Bazel จะสร้างข้อมูลความครอบคลุมไม่ได้หากมีการแคชการทดสอบไว้ก่อนหน้านี้ หากต้องการหลีกเลี่ยงปัญหานี้ คุณสามารถตั้งค่า
--nocache_test_resultsสำหรับการเรียกใช้ความครอบคลุมโดยเฉพาะได้ แม้ว่าวิธีนี้จะทำให้เวลาในการทดสอบเพิ่มขึ้นอย่างมากก็ตาม --experimental_split_coverage_postprocessingและ--experimental_fetch_all_coverage_outputs- โดยปกติแล้ว ความครอบคลุมจะเรียกใช้เป็นส่วนหนึ่งของการดำเนินการทดสอบ ดังนั้นโดยค่าเริ่มต้น เราจึงไม่ได้รับความครอบคลุมทั้งหมดกลับมาเป็นเอาต์พุตของการดำเนินการจากระยะไกล แฟล็กเหล่านี้จะลบล้างค่าเริ่มต้นและรับข้อมูลความครอบคลุม ดูรายละเอียดเพิ่มเติมได้ที่ปัญหาข้อนี้
การกำหนดค่าเฉพาะภาษา
Java
Java ควรทำงานได้ทันทีด้วยการกำหนดค่าเริ่มต้น ชุดเครื่องมือ Bazel มีทุกสิ่งที่จำเป็นสำหรับการดำเนินการจากระยะไกล รวมถึง JUnit
Python
ดูเอกสารความครอบคลุม rules_python
สำหรับขั้นตอนเพิ่มเติมที่จำเป็นในการเปิดใช้การรองรับความครอบคลุมใน Python