Bazel มีคำสั่งย่อย coverage
เพื่อสร้างรายงานการครอบคลุมของโค้ดในที่เก็บซึ่งทดสอบด้วย bazel coverage
ได้ เนื่องจากการทํางานของระบบนิเวศภาษาต่างๆ มีความเฉพาะตัว จึงไม่ใช่เรื่องง่ายเสมอไปที่จะทําให้วิธีนี้ได้ผลสําหรับโปรเจ็กต์หนึ่งๆ
หน้านี้จะอธิบายขั้นตอนทั่วไปในการสร้างและดูรายงานความครอบคลุม รวมถึงแสดงหมายเหตุเฉพาะภาษาสำหรับภาษาที่มีการกําหนดค่าที่รู้จักกันดี วิธีที่ดีที่สุดในการอ่านคืออ่านส่วนทั่วไปก่อน แล้วจึงอ่านเกี่ยวกับข้อกำหนดสำหรับภาษาใดภาษาหนึ่ง โปรดดูส่วนการเรียกใช้จากระยะไกลด้วย ซึ่งต้องมีการพิจารณาเพิ่มเติม
แม้ว่าคุณจะปรับแต่งได้หลายอย่าง แต่เอกสารนี้จะมุ่งเน้นที่การสร้างและการใช้รายงาน lcov
ซึ่งเป็นเส้นทางที่รองรับมากที่สุดในปัจจุบัน
การสร้างรายงานความครอบคลุม
การเตรียมพร้อม
เวิร์กโฟลว์พื้นฐานในการสร้างรายงานความครอบคลุมต้องใช้ข้อมูลต่อไปนี้
- ที่เก็บพื้นฐานที่มีเป้าหมายทดสอบ
- เครื่องมือทางเทคนิคที่ติดตั้งเครื่องมือการครอบคลุมโค้ดเฉพาะภาษา
- การกำหนดค่า "การใช้เครื่องมือ" ที่ถูกต้อง
2 รายการแรกเป็นภาษาที่เฉพาะเจาะจงและตรงไปตรงมาส่วนใหญ่ แต่รายการหลังอาจใช้ยากกว่าสำหรับโปรเจ็กต์ที่ซับซ้อน
"เครื่องมือวัด" ในกรณีนี้หมายถึงเครื่องมือการครอบคลุมที่ใช้กับเป้าหมายที่เฉพาะเจาะจง Bazel อนุญาตให้เปิดใช้ตัวเลือกนี้สำหรับไฟล์ชุดย่อยที่เฉพาะเจาะจงโดยใช้ Flag --instrumentation_filter
ซึ่งระบุตัวกรองสำหรับเป้าหมายที่ทดสอบโดยเปิดใช้เครื่องมือวัด หากต้องการเปิดใช้เครื่องมือวัดผลสําหรับการทดสอบ คุณต้องใช้ Flag --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 --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
และ Flag ที่คล้ายกันนี้ เป็นผลมาจากการติดธงครั้งแรก - ปัจจุบัน Bazel จะสร้างข้อมูลการครอบคลุมไม่สำเร็จหากมีการแคชการทดสอบไว้ก่อนหน้านี้ วิธีแก้ปัญหานี้คือคุณสามารถตั้งค่า
--nocache_test_results
สำหรับการเรียกใช้เพื่อหาความครอบคลุมโดยเฉพาะได้ แม้ว่าวิธีนี้จะทำให้เสียเวลาในการทดสอบอย่างมาก --experimental_split_coverage_postprocessing
และ--experimental_fetch_all_coverage_outputs
- โดยปกติแล้ว การครอบคลุมจะทำงานเป็นส่วนหนึ่งของการดำเนินการทดสอบ ดังนั้นโดยค่าเริ่มต้น เราจะไม่ได้รับการครอบคลุมทั้งหมดเป็นเอาต์พุตของการดำเนินการจากระยะไกล แฟล็กเหล่านี้จะลบล้างค่าเริ่มต้นและรับข้อมูลการครอบคลุม ดูรายละเอียดเพิ่มเติมเกี่ยวกับปัญหานี้
การกำหนดค่าเฉพาะภาษา
Java
Java ควรทํางานได้ทันทีโดยใช้การกําหนดค่าเริ่มต้น bazel Toolchains มีทุกอย่างที่จําเป็นสําหรับการดําเนินการระยะไกล ซึ่งรวมถึง JUnit ด้วย
Python
ดูขั้นตอนเพิ่มเติมที่จำเป็นในการเปิดใช้การรองรับการครอบคลุมใน Python ได้ที่rules_python
เอกสารการครอบคลุม