coverage.md

Generate code coverage data

1. Build a test target for coverage:

   ninja -C out/Coverage-iphonesimulator ios_chrome_unittests
   

   Targets that support code coverage need to call coverage_util::ConfigureCoverageReportPath(). If you don't use setup-gn.py, you can set the gn argument ios_enable_coverage to true.

2. Run the test target. If using Xcode, don't forget to set Coverage in the target's scheme:

   

3. Find the coverage.profraw in the Documents folder of the app. You can look in the console output of the instrumented target. For example:

   Coverage data at /Users/johndoe/Library/Developer/CoreSimulator/Devices/
   82D642FA-FC18-4EDB-AFE0-A17454804BE4/data/Containers/Data/Application/
   E6B2B898-CE13-4958-93F3-E8B500446381/Documents/coverage.profraw
   

4. Create a coverage.profdata file out of the coverage.profraw file:

   xcrun llvm-profdata merge \
       -o out/Coverage-iphonesimulator/coverage.profdata \
       path/to/coverage.profraw
   

5. To see the line coverage for all the instrumented source files:

   xcrun llvm-cov show \
       out/Coverage-iphonesimulator/ios_chrome_unittests.app/ios_chrome_unittests \
       -instr-profile=out/Coverage-iphonesimulator/coverage.profdata \
       -arch=x86_64
   

   

   To see the line coverage for a specific instrumented source file/folder (e.g. ios/chrome/browser/ui/coordinators/browser_coordinator.mm):

   xcrun llvm-cov show \
       out/Coverage-iphonesimulator/ios_chrome_unittests.app/ios_chrome_unittests \
       -instr-profile=out/Coverage-iphonesimulator/coverage.profdata \
       -arch=x86_64 ios/chrome/browser/ui/coordinators/browser_coordinator.mm
   

   

   To see a complete report:

   xcrun llvm-cov report \
       out/Coverage-iphonesimulator/ios_chrome_unittests.app/ios_chrome_unittests \
       -instr-profile=path/to/coverage.profdata -arch=x86_64
   

   

   To see a report for a folder/file (e.g. ios/chrome/browser folder):

   xcrun llvm-cov show \
       out/Coverage-iphonesimulator/ios_chrome_unittests.app/ios_chrome_unittests \
       -instr-profile=path/to/coverage.profdata -arch=x86_64 ios/chrome/browser