覆蓋率報告（Coverage Report）是一種軟件測試工具生成的報告，用于評估測試用例對代碼的覆蓋程度。它通過統計代碼中哪些部分已經被測試用例執行過，哪些部分還沒有被執行，來衡量測試的充分性。覆蓋率報告通常包括以下幾種類型的覆蓋率指標：
1.行覆蓋率（Line Coverage）：
? ? ?- 衡量代碼中每一行是否被至少執行過一次。

2.分支覆蓋率（Branch Coverage）：
? ? - 衡量代碼中每個條件分支（如if語句、switch語句等）是否都被執行過。

3.函數覆蓋率（Function Coverage）：
? ? - 衡量代碼中每個函數是否都被調用過。

4.語句覆蓋率（Statement Coverage）：
? ? - 衡量代碼中每個語句是否都被執行過。

5.路徑覆蓋率（Path Coverage）：
? ? - 衡量代碼中所有可能的執行路徑是否都被覆蓋到。

覆蓋率報告的作用：

1.評估測試質量：
- 通過覆蓋率報告，開發人員和測試人員可以了解當前測試用例對代碼的覆蓋情況，從而評估測試的質量和充分性。

2.發現未測試的代碼：
- 覆蓋率報告可以幫助識別那些從未被執行過的代碼段，這些代碼段可能存在潛在的缺陷或邏輯錯誤。

3.優化測試用例：
- 根據覆蓋率報告，可以針對性地增加或修改測試用例，以提高代碼的覆蓋率，確保更多的代碼邏輯得到測試。

4.提高代碼質量：
- 通過提高代碼覆蓋率，可以減少代碼中的潛在缺陷，提高軟件的整體質量和可靠性。

5.支持持續集成：
- 在持續集成（CI）流程中，覆蓋率報告可以作為一個重要的指標，幫助團隊監控和維護代碼質量。如果覆蓋率低于某個閾值，可以觸發警報或阻止代碼合并。

6.輔助代碼審查：
- 覆蓋率報告可以作為代碼審查的一部分，幫助審查人員更好地理解代碼的測試情況，從而提出更有針對性的改進建議。

7.風險管理：
- 通過覆蓋率報告，項目管理者可以更好地評估項目的測試風險，制定相應的風險管理策略。

Jacoco插件有完整的一套覆蓋率相關功能，所以當采集了覆蓋率數據文件后，就可以生成覆蓋率報告。這樣沒有指定變化的內容，直接對整個項目生成的報告是全量報告，目前有兩種生成覆蓋率報告的方法，我們將逐一介紹。

1，添加gradle任務

在采集了覆蓋率數據文件，要生成覆蓋率任務的項目中，找到app的gradle文件，添加如下任務：

task jacocoTestReport(type: JacocoReport) {reports {xml.enabled = truehtml.enabled = true}def fileFilter = ['**/R.class', '**/R$*.class', '**/BuildConfig.*', '**/Manifest*.*']def debugTree = fileTree(dir: "$buildDir/intermediates/javac/debug", excludes: fileFilter)def mainSrc = "$project.projectDir/src/main/java"sourceDirectories.from = files([mainSrc])classDirectories.from = files([debugTree])executionData.from = files("$buildDir/outputs/code_coverage/debugAndroidTest/connected/coverage.ec")
}

注意：

• sourceDirectories：項目的源碼文件，要指到java層，否則報告中無法渲染代碼覆蓋情況。
• classDirectories：項目構建的類文件，注意是插樁后構建的文件，但在javac文件夾下。
• executionData：覆蓋率數據文件路徑，如果沒有這個路徑，請創建這個目錄，并把上節下載的覆蓋率數據文件放到這個目錄中，重新命名。

2，生成覆蓋率報告

添加任務后同步項目，可以看到gradle文件中對應任務的左側有一個執行標示，單擊選擇"Run Android....."

Android Studio輸出如下，生成覆蓋率報告。

也可以在命令行下執行 ./gradlew jacocoTestReport，同樣能生成報告。報告路徑如下：app/build/reports/jacoco/jacocoTestReport/

Jacoco還可以不使用Android Studio直接使用命令行生成報告，此時需要下載jaoco的包： EclEmma - JaCoCo Java Code Coverage Library，下載指定的包，如我們使用的0.8.7的包。

打開壓縮包，找到libs文件夾，就可以看到jacococli.jar包，這個就是要使用的工具。

命令使用方法：

java -jar ${jacococli.jar的路徑} report ${exec文件路徑} 
--classfiles ${類文件路徑} --sourcefiles ${源碼文件路徑，要到/src/main/java} 
--encoding utf-8 --html ${報告路徑}

所以生成上面項目的覆蓋率報告，命令行方法可以是：

報告內容和上面完全一樣：

增量報告是指在連續的構建或測試過程中，僅顯示相對于上一次構建或測試的變化部分的報告。這種報告方式主要用于跟蹤和分析代碼覆蓋率的變化，特別是在持續集成（CI）和持續交付（CD）環境中非常有用。

網上生成增量報告的方案很多，介紹性文檔較多，具體使用效果不得而知。主要集中在如下幾種：

1，diff-cover

項目地址： GitHub - Bachmann1234/diff_cover: Automatically find diff lines that need test coverage.，通過python處理diff信息以及生成增量覆蓋率報告。

缺點：增量信息較多時，處理速度慢。生成報告樣式和jacoco完全不同，有一定的學習成本。

2，增量插樁

根據需求的diff信息，在引入jacoco插件時，進行針對性插樁，生成報告的時候只生成插樁的文件，具體方案網上有本處不再展開： https://juejin.cn/post/6920029313316159502。

缺點：生成報告符合要求，但是無法同時采集全量覆蓋率數據，在日常測試過程中需要同時生成全量和增量的覆蓋率報告，此方案需酌情使用。

3，二次開發jacococli工具

網上的開源項目： jacoco: jacoco二開，支持增量代碼覆蓋率 ，可以通過命令行指定diff信息，并根據diff信息生成報告，渲染增量代碼，完全符合要求。

缺點：需要有一定的開發能力，對項目重新打包；項目較老，需要做相應的修改。

覆蓋率相關功能是精準測試平臺的核心，為了更好的開發我們的平臺，增量報告采用第三種方案，下節將詳細介紹如何使用此方案。