How to Easily Measure Code Coverage in Xcode

December 1, 2012 — 154 Comments

One of the first things I do when working on any Xcode project is set up code coverage. If the coverage shows a hole, I know that area is lacking unit tests.

(Be careful, the opposite isn’t true: Just because some code has been touched by unit test execution doesn’t mean it’s actually covered. If altering the behavior of the code causes a test to fail, then you know it’s covered.)

Many people use CoverStory, a a code coverage browser app written by my friend Dave MacLachlan. Others use gcovr to integrate code coverage into their Jenkins continuous integration. Me, I use lcov because it lets me exclude third-party libraries from the measurements before generating an HTML report.

When a project is built from the command-line with xcodebuild, it places build artifacts into a “build” folder, kind of like the old days. But I want to measure coverage of unit tests as I run them from Xcode itself. This complicates things because build artifacts go into some obscure DerivedData subfolder. I solve this by having the build process export some of the project’s environment variables to a file. I’ll show you where to get the shell scripts I use to do all this.

Download the code coverage tools

I have a GitHub repository called XcodeCoverage. You’ll probably want to make some per-project changes. So if you use git for your projects, think about how you want to manage your fork – branch – submodule workflow.

Place the XcodeCoverage folder in the same folder as your Xcode project.

Update: The easiest way to incorporate XcodeCoverage is via CocoaPods, as long as you don’t want to customize the exclusion rules.

Then download lcov-1.10. Place the lcov-1.10 folder inside the XcodeCoverage folder.

Also (if you haven’t done so already) go to Xcode Preferences, into Downloads, and install Command Line Tools to get Xcode’s coverage instrumentation.

Set up your project

First, I assume you’re using Xcode 4.5. If so, you’re in luck: It’s easy. (Code coverage used to be a little more complicated in earlier versions of Xcode, as Claus Broch describes in Code Coverage with Xcode 4.2 and Code Coverage and fopen$UNIX2003 Problems.)

The first steps are the same, regardless of what coverage tool you use. Select your project, and go into its Build Settings. (I like to make these changes at the project level so that they’ll apply to all targets.) Find the “Generate Test Coverage Files” setting. Spin down the disclosure triangle to reveal your configurations. Enable this settings for your Debug configuration:

Update: Instead of making these changes, you can incorporate XcodeCoverage.xcconfig.

Generate Test Coverage Files

Do the same for the “Instrument Program Flow” setting:

Instrument Program Flow

So far, so good. Now let’s add the extra step so my scripts can get the project’s environment variables.

Select your primary target, and go into its Build Phases. Click “Add Build Phase” at the bottom, selecting “Add Run Script”. Edit it so it runs XcodeCoverage/

Run Script build phase to export environment variables

This last step has tripped up some people. If you use OCUnit — where the the main target is executed with tests injected — make sure you add the script to your main target (your app or library), not your test target.

On the other hand, if you use a different testing framework that depends on a separate testing app, then add the script to your test app, not the main target.


Now we’re ready for the good stuff. Run your unit tests.

Open a Terminal window, and cd to your project’s XcodeCoverage folder. Once the tests complete, run my getcov script:

XcodeCoverage/getcov --show

Things will fly by. Eventually, a browser window should open. Now you can see your code coverage!

Change test code, then re-run

We measure code coverage to find the holes in our tests. So now let’s say you’ve added some new tests, and want to measure the coverage. As long as you haven’t changed your production code, the quickest way is to clean out the coverage data and re-measure. To do this, run the cleancov script:


With the previous results zeroed out, now we can re-run the tests, then do getcov again.

Change production code, then re-run

Time has passed, and you’ve made changes to your production code. When you decide to measure code coverage again, you should clear out earlier build artifacts. (Leftovers confuse lcov.)

To do this, hold down the Option key in Xcode’s “Product” menu. Select “Clean Build Folder”.

Now you’re ready to re-run the tests, followed by getcov.

Modify the scripts

There are two places in the XcodeCoverage scripts you may want to modify for your project:

First: In the script, LCOV_INFO determines the name shown in the report. By default, the name is But if you want to maintain coverage reports for multiple projects, it would be best to change this name to match the project name.

Second: If your project uses third-party libraries, you’ll probably want to exclude them from code coverage measurements. You can do so by editing the getcov script and changing the exclude_data() function.

What I do is put all third-party libraries into a folder named ThirdParty. Then I exclude the pattern "ThirdParty/*" using lcov’s --remove command.

Let me know

Let me know how it goes! Do you have any questions, about XcodeCoverage in particular, or about code coverage in general? Leave a comment below.

Was this article helpful? Subscribe today to get regular posts on iOS development.

Jon Reid

Posts Twitter Facebook Google+

I've been practicing Test Driven Development (TDD) since 2001. Learn more on my About page.

154 responses to How to Easily Measure Code Coverage in Xcode

  1. Thanks for sharing this Jon, i’ve been banging my head against my desk for some time trying to simplify this task.

    No matter how I try and set up the project though I get the following error;

    ERROR: no .gcda files found in /Users/ which results in no trace, so no valid records.

    I tried setting specifically at target level instead of porject level but it had the same effect. Have you ever seen this?


    • In order to get it working, I had to set the target specifically, project level settings didn’t work and if you’re running tests in the simulator, it must close before it generates files. Once that was all done it worked a treat. Thanks Jon.

      • Adam, I’m glad it was helpful! Two questions:

        When you set it at the project level, and it didn’t take at the target level, was your target overriding those settings?

        What do you mean “it must close before it generates files”?

  2. Hmm, the path above got truncated, it wasn’t looking at users it was a valid path to the build folder in derived data 🙂

  3. I tried generating the code coverage files from Xcode 4.5 with no luck.

    My first attempt was with a C++ program that used Google Testing Framework and figured that the above instructions may only work with projects using Apple’s built in unit testing, so I created a small Cocoa app and used Apple’s built in Unit-Testing framework, but I still don’t get any output files.

    I working on Mac OS 10.7, so I went over to my Mac OS 10.8 machine and created a Cocoa app there and again, I couldn’t find the files.

    What may I be missing?


  4. thanks for this post.
    i got this error.
    Found 30 data files in /Users/ignazioc/[…..]/Objects-normal/i386
    Processing i386/AboutViewController.gcda
    geninfo: ERROR: /Users/ignazioc/Desktop/[…..]/Objects-normal/i386/AboutViewController.gcno: could not open file

    but “AboutViewController” has no test associated…maybe i need to have at least one test for class to run this tool?


    • Ignazio, I work on legacy projects with many classes not covered by tests. So it must be something else. Try creating a sample project with some toy tests, then see if you can diagnose the difference.

    • Ignazio, did you resolve this error? I’ve encountered the same issue

  5. I am trying to get this to work and got everything setup except when I run getcov, I get and error

    geninfo: ERROR: need tool gcov!

    Do I still need gcov to run this? I am running Moutain Lion with the latest Xcode.


    • Yes, download gcov-1.10. Then place the lcov-1.10 folder inside the XcodeCoverage folder.

      • I did download lcov, installed it into the XcodeCoverate folder and ran the script getcov but lcov seems to want gcov installed. Confused by your last replay since you said I did need gcov but you pointed to lcov.

        Output from getcov

        /Build/Products/Debug ~/Dev/ContactManager/XcodeCoverage
        Capturing coverage data from /Users/scottdensmore/Library/Developer/Xcode/DerivedData/
        geninfo: ERROR: need tool gcov!
        Reading tracefile
        lcov: ERROR: cannot read file!
        Reading tracefile
        lcov: ERROR: cannot read file!
        Reading data file
        genhtml: ERROR: cannot read file!
        The file /Users/scottdensmore/Library/Developer/Xcode/DerivedData/ContactManager-dxjozpbnyibstudkdiqnmmswcwyw/Build/Products/Debug/lcov/index.html does not exist.


  6. Found one more problem with the script. If you use NATIVE_ARCH you get some problems. I get i386 even though it should be x86_64. You should use CURRENT_ARCH. I found this discussion on the apple list : I will send you a pull request with the change.

  7. Hi Jon,

    Great post.

    I am having issue setting up the Code Coverage for static library project.

    I’m getting errors something like below:
    Undefined symbols for architecture i386:
    “_llvm_gcda_emit_arcs”, referenced from:
    ___llvm_gcov_writeout in libSomething.a(a.o)

    I will not get this error if I disable ‘Instrument Program Flow’.

    Any Idea?


    • Hisyam, are you using an older version of Xcode?

      • I’m using the latest Xcode 4.5.2.

        I have revisited my steps. It seems I have misconfigured the “Generate Test Coverage Files” and “Instrument Program Flow” settings.

        I have redone the steps and everything works well now.

        • I am using a library project and getting the same errors
          Undefined symbols for architecture i386:

          Any clue? (on a new application project it works OK, so I assume all is correct)
          To reproduce, create a library, setup the project , build is OK, runiing the unit tests generates the problem
          I am using xcode 4.5.1

          • Same answers as elsewhere, Lior. Since it works on a brand-new project — with unit testing enabled — there’s a difference in your Build Settings. If you’re allowed to shared your project with me, I can take a look.

  8. I am trying to implement code coverage with Kiwi Testing. I am not sure if you have ever worked with Kiwi but when I run the code coverage it seems to be returning me code coverage of the test files which is just 100% since the files are getting run all the way through. Is there any way to match the spec’s I’m writing to the files to get the code coverage of the actual file.


  9. Sebastian Wramba January 17, 2013 at 5:20 am

    Hi, thank you for this great tool. However, do you know how I can get code coverage when the Test target does not compile the actual sources?

    I have set up a test target, that holds a dependency on the main target and only has the test classes compiled in the “Compile sources” phase.

  10. Great post, John! First try with a *new* project in Xcode 4.5 and everything works as you described. However, when perform the same steps on an existing project of mine, no .gcda files end up being generated into the intermediates build folder, and the in the lcov folder stays at 0 bytes.

    Would you know what causes this? It’s a library project, but that wouldn’t be the problem, right?
    Here’s a link to the gist containing the terminal message and a link to the project on github:

    Cheers, Eric-Paul – Amsterdam, the Netherlands

    • Hello to Amsterdam! Since it works on a new project but not yours, try to isolate the difference. I’d check a few things:
      – When you look at Build Settings for your main app target, did “Generate Test Coverage Files” and “Instrument Program Flow” propagate, or are they overridden to NO?
      – Is the script specified on your main app target?
      – Are you running Debug configuration?

  11. Hi Jon – thanks for these tools! Testing with a simple project, using Xcode 4.6, in the LCOV – coverage report, AppDelegate.m, drilled in to the functions page, I get 0 Hit Count for “-[AppDelegate .cxx_destruct]”. What does that mean?

  12. Hi Jon, It seems a great tool, but I get 0 hit count for any classes I’ve unit tested. It’s not an IOS project. I’ve set up the project as explained here. Does it work the same ? Where should I look to find errors ? Many thanks

    • Carol, it should work for Mac development, too. Find your DerivedData and navigate down through Build/Intermediates/ Next to your object files, do you see gcda and gcno files?

  13. Thanks for the tutorial! I have everything up and running, but the code coverage seems wrong. I wrote some test using Specta but the coverage % is always 0%. Only app delegate is 100% and some of my first viewController class got about 3% coverage. I tried Clean project and ./clearcov several times but still no luck. Do you have any idea on this?

    BTW, I also tried to read .gcda coverage files with CoverStory. But still got 0% coverage results. So it seems like tools are working correctly but I am missing something. :/

  14. Hello, I succeded to make it work by running the script on the test target instead of the app target. The proble was the same as Hlung. I also had the same issue with CoverStory. Now every thing works just fine. BTW I’m now using your test template, OHHamcrest and OCMockito. Thanks for those great tools !

    • Yeah, I ended up doing the same as you Carol 🙂 Instead of fixing OBJECT_FILE_DIR_normal, moving the script to test target made it generate the correct path for reading the test target coverage files. BTW, I’m using Specta and Expecta to write tests.

      • Yes, I had written my instructions from an OCUnit perspective, where what gets executed is the actual app (injecting tests) instead of a separate testing target.

        Carol, can you confirm that you’re not using OCUnit?

        I’ll update the post to note this. Thanks!

  15. Hi Jon,
    I following your instructions but I get only .gcno files and no .gcda files. I’m using Xcode 4.6 and GHUnit 0.5.6. The tests run fine in simulator.
    Have you any idea how I can fix this problem.

    Thank you very much for the script!

    • GHUnit relies on a separate testing app, rather than injecting tests into the production app. So add the script to the testing app, not the production app.

  16. Hi Jon,

    Thanks for such a great article!
    I tried your steps and it works great on the XCode 4.5.1 version. I had a question however, should I set the Generate Test Coverage and Instrument Program Flow options for both Debug and Release versions, or should those settings be configured only for Debug? I guess these settings would probably come into effect only when you run the unit tests, and have no impact in the file size of the release binary. Is that correct?


    • Asheesh, I’m glad you found it useful.

      Instrumentation changes the generated code. Don’t use it for shipping code. That’s why I do it for Debug only.

  17. Hi Jon,
    this post is really helpful.
    I set up the code coverage for XCode 4.5 based on your instruction.
    Thank you very much!!
    When I generate output with lcov command, it has warning for all .gcno files ‘.gcno version ‘404*’, prefer ‘402*”. I searched in website, it’s caused by GCC version inconsistency.
    But still I can get coverage data. will the data still accurate?


    • Yi,
      Yes, the data is still accurate. The warnings are a nuisance, but harmless. Still, if anyone at Apple is reading… it would be nice to make this quiet…

  18. How can I convert coverage.xml from gcovr to html report?

    • Sorry, I haven’t used gcovr so I don’t know. But there’s nothing stopping you from using gcovr for automation, then using XcodeCoverage manually on-demand. You certainly don’t need full HTML reports as often as automated reporting.

  19. Thanks, works great. Can I use this in jenkins? I tried to convert output to cobertura xml, but without success

  20. When I am entering ./getcov. I get the folllowng message:
    No such file or directory
    Also do I need to copy the Icov-1.10.
    If so how would the shell script getcov be in the xcodecoverage directory because everything gets copied into the icove-1.10 sub folder.
    Also do note I have installed the command line tools using xcode.

  21. As I said in mz earlier post
    I had put icov1.10 in the XCodeCoverage folder and I get the following message when I tzpe the shell script ./getcov
    No such file or directory

  22. Sanjeet Singh May 13, 2013 at 8:15 am

    I get the following message: line 7: No such file or directory

    • Ah! That’s more helpful. It’s not finding You need to add a run script to execute XcodeCoverage/ It’s the last step in the section “Set up your project”.

  23. Currently I am not getting the dcda files generated.

  24. Sanjeet Singh May 15, 2013 at 7:19 am


  25. Sanjeet Singh May 15, 2013 at 7:22 am

    I am having the same problem with OCUnit.
    For OCUnit. I have added the shell script to export the project settings into the app target.
    For unittest++ I am added the script to the test target.

    • Hmm. Strange. At this point, my advice is to set up sample applications using XcodeCoverage. See if you can get it working in the sample, apart from your real project.

  26. Amazing job Jon! It worked like a charm.
    Really simple and fast to configure.
    Thanks a ton for sharing this!

  27. I have it working using OCUnit. unittest++ which is using c++ instead of objective c is still giving grief. Only the gcno files are being generated. Let me know if you have any ideas?

  28. Hi Jon,

    Thanks again for these articles, really useful. I have the code coverage up and running which is really cool to see. As I said in my comment on your UIViewController TDD post, I have been playing around with unit testing with Kiwi a little bit, but didn’t really know what was required for a full TDD implementation. Taking a look at my code coverage shows me that I have a lot of work to do!

    I have a quick question, the coverage listing output is showing that I have no coverage on two functions that are not under my control; __copy_helper_block_ and __destroy_helper_block_. I believe this is probably to do with the way Kiwi is implemented, as I normally declare my SUT as a __block variable so that I can modify it within the Kiwi test blocks. Do you know of any way of ignoring the coverage for these two functions? I have taken a look inside your getcov script, and I see the exculde_data() function, I’m just not sure what to write inside that function so that these two items are ignored.

    Any advice would be appreciated.


    • Ben, I’m puzzled. If everything is set up correctly, you should get coverage stats on your production code, not your test code. Why would any Kiwi get in there at all?

      • Hi Jon,

        Just encountered this again, on second look I don’t think it is anything to do with Kiwi at all actually. In a particular piece of code I have declared some variables with the __block modifier like so:

        __block NSString *variable1;
        __block NSString *variable2;

        I then subsequently enumerate an array using a block, and set these variables appropriately. Then when I view the coverage output, even though it looks as if I have 100% coverage in terms of each line being hit, it is only listed as 66.7%. If I then click on the functions link, I see these 4 lines are listed as not having been hit:


        I realize it’s not really a big deal, as I can see that my code has been tested successfully, however it would be nice to be able to suppress these lines from lcov somehow just so the resulting coverage percentage is a little more accurate.

        Thanks for your help!

        • While lcov supports excluding entire files, I don’t know of a way to exclude particular functions.I guess you just have to shrug. But don’t forget to pat yourself on the back for tightening things up! Remember that the goal isn’t to satisfy lcov, it’s to enable you to refactor with high confidence.

  29. Simone Civetta May 26, 2013 at 2:48 pm

    It works great even here in Paris!
    Thank you,

  30. Hi Jon, thanks for the article. I am able to get code coverage for my tests files but actually I want to know how much my STATIC libary code covered in unit tests. I have enabled “generate test coverage” and “instruments program flow” for static library which has generated .gcno file but not .gcda file in another folder. I don’t get coverage to my actual classes. Could you please let me know how to use coverstory and generate code coverage for static library? Thanks.

  31. I setup everything as outlined, run unit tests and then execute getcov command, but get the following output.

    Any idea what I am doing wrong? Thanks in advance.

    $ ./getcov
    ~/Library/Developer/Xcode/DerivedData/CodeCoverateTest-aoqsimcwfzfklcargqyfmdrjkyxe/Build/Products/Debug-iphonesimulator ~/Projects/iOS/CodeCoverateTest/XcodeCoverage
    Capturing coverage data from /Users/gmirabito/Library/Developer/Xcode/DerivedData/CodeCoverateTest-aoqsimcwfzfklcargqyfmdrjkyxe/Build/Intermediates/
    Found gcov version: 4.8.0
    Scanning /Users/gmirabito/Library/Developer/Xcode/DerivedData/CodeCoverateTest-aoqsimcwfzfklcargqyfmdrjkyxe/Build/Intermediates/ for .gcda files ...
    Found 4 data files in /Users/gmirabito/Library/Developer/Xcode/DerivedData/CodeCoverateTest-aoqsimcwfzfklcargqyfmdrjkyxe/Build/Intermediates/
    Processing i386/AppDelegate.gcda
    geninfo: Negative length at /Users/gmirabito/Projects/iOS/CodeCoverateTest/XcodeCoverage/lcov-1.10/bin/geninfo line 2413.
    Reading tracefile
    lcov: ERROR: no valid records found in tracefile
    Reading tracefile
    lcov: ERROR: no valid records found in tracefile
    Reading data file
    genhtml: ERROR: no valid records found in tracefile
    The file /Users/gmirabito/Library/Developer/Xcode/DerivedData/CodeCoverateTest-aoqsimcwfzfklcargqyfmdrjkyxe/Build/Products/Debug-iphonesimulator/lcov/index.html does not exist.
  32. Hello Jon. When I check “instrument program flow” my app starts crashing. Without that flag my tests works fine. I have Xcode 4.6.2. Does anybody have this issue? And another one. If I add XcodeCoverage/ in main target it will not be called beause I have a logic test bundle.

  33. Hi Jon,

    Thank you so much for making XcodeCoverage available publicly. I got code coverage working on my iOS app fairly easily. I am running OCUnit logic tests. However, though I am seeing an app crash very similar to Alexey’s in the iOS simulator when “instrument program flow” is enabled. I am able to work-around the problem by disabling “Instrument program flow” and I still seem to get the code coverage report in the browser. I tried a number of app fixes but they did not work. What are the implications of disabling “instrument program flow” ? I am intrigued that I still have the solution working despite disabling the flag.

    Thanks once again.


    • Amit, I really don’t know what the flag actually does. It’s in Apple’s instructions dating back to 2007. If it’s working for you without the flag, great. But I’d keep an eye on things, and also try it out on Xcode 5.

  34. Hi Jon,

    Thanks for the nice article!
    Following your steps, after I run the unit tests in Xcode, I get the following error when trying to invoke gcov.

    ./getcov: line 13: syntax error near unexpected token `then’
    ./getcov: line 13: `    if [ -e lcov ]; then’

  35. Hello Jon,

    Thanks a lot for making XcodeCoverage tool publicly available. Really it’s a great help to get coverage report but I am facing one problem. I have some test cases and I want to find code coverage using the same. Now after running of tests and coverage tool, the report is not getting generated for the files which actually are getting used (here I mean static library). I can see only few header files (.hpp / .h) in the report and no other files (.cpp) can be seen. Do i need to add them in dependency list? If yes can you tell me how to do that? Or is there any other step through which I get all the file names listed in the report which were used by the test cases?

    Ashutosh K.

  36. Hi,

    Is there any way to change output to spreadsheet(xls) instead of htm.


  37. Siddharthan Asokan August 26, 2013 at 4:30 pm

    I tried using your tool however I don’t seem to generate the .gcda files when I tested my applications. Here is the output for the terminal:

    ERROR: no .gcda files found in /Users/siddharthan64/Library/Developer/Xcode/DerivedData/MyApp-etdgihqgczfycohakrrolnzgxqzw/Build/Intermediates/!
    Reading tracefile
    lcov: ERROR: no valid records found in tracefile
    Reading tracefile
    lcov: ERROR: no valid records found in tracefile
    Reading data file

    And for the console on Xcode:

    DerivedData/MyApp-etdgihqgczfycohakrrolnzgxqzw/Build/Intermediates/ cannot open

    profiling:/Users/siddharthan64/Library/Developer/Xcode/DerivedData/MyApp-etdgihqgczfycohakrrolnzgxqzw/Build/Intermediates/ cannot open

    profiling:/Users/siddharthan64/Library/Developer/Xcode/DerivedData/MyApp-etdgihqgczfycohakrrolnzgxqzw/Build/Intermediates/ cannot open

    Am I missing something?

  38. Siddharthan Asokan August 28, 2013 at 9:29 am

    Hello Jon,
    If I need to add code coverage for a library file of the type ‘filename.a’, Shall I just add it to the compile sources of the Test target? Or is there any other tool that does this?

    • Siddharthan,
      You would need to enable the coverage flags in the library’s project. Subprojects are a bit painful to add to coverage stats, but it can be done because lcov supports merging of coverage stats.

  39. First of all, thank you Jon for your nice work. Have you managed to get coverage working in XCode5/iOS7?

    I am getting ERROR: no valid records found in tracefile I have checked and both the instrument program flow and the generate coverage flags are set and the is added.

  40. Jon

    I’m trying to use this approach while running scripted automated tests with Instruments. It appears the file is empty. Should this work with automated tests, or only with unit tests? If it doesn’t work with automated tests, any suggestions to determine coverage for these tests?

  41. Kamlesh Mallick October 8, 2013 at 10:32 pm

    Hi guys,

    This blog is useful. Thank you so much.

    I compile my C++ code using GCC but then, CODE coverage is not supported by the LLVM-GCC 4.2 compiler in OSX. And thus am using CLang++ compiler, which generates the .gcno files along with the object files (.o)

    Now when i link my code against – libprofile_rt.dylib

    I get Linker Errors

    Undefined symbols for architecture i386:
    “_llvm_gcda_emit_arcs”, referenced from:

    What could be the problem?
    Should i not compile my C++ code using CLang++?
    Or Should i link against some other library?

    Any answers would be appreciated.

  42. Jon Reid, thanks for this very detailed and informative post. I succeeded implementing it but when I am trying ./getcov its giving coverage report only for 2 classes. I tried implementing some small test cases for other ViewControllers as well but coverage report is showing only for earlier 2 classes. Can you please help me with this. Thanks in advance.

  43. Hi
    Thanks for posting this.
    I too followed the same steps and got the same error as coverage info not found, like many others above.
    I may be doing something differently.
    I’ve used bullseye with visual studio inthe past, so my interpretation maybe biased.

    After enabling coverage and instrumentation for debug mode, added build phase, i simply run the app in the simulator, execute various use cases on the ui and finally exit the simulator. (that’s how I used to do with bullseye).
    Now when I run your script, I get the error, no coverage info.

    Will this work only on the unit Test target and not on main target?

    Please let me know.

  44. Hi,

    Just to add something that I found.

    For GHUnit, XcodeCoverage/ should be added to the Main Project(Project which is being tested) and not to the test project.

    Make sure to add “Application does not run in background: Yes” to the info.plist file of the GHUnit test app(not to the main project).

    Once tests are executed(i checked this on the simulator) Make sure to shut down the app by pressing the home button.

    Only after shutting down the app as described above, do execute the getcov.

  45. Thanks Jon. This was very useful.

  46. Thanks for the nice tool. I am able to successfully integrate/execute the same.
    I have a query is there anything additional need to be done as currently code coverage displayed is only for test bundle and not for the main app.

  47. Can someone post how to setup XCodeCodeCoverage from Scratch instead of all the patches? I downloaded the sample application under CodeCoverage patch for Xcode5 and it doesn’t see to produce code coverage.

    It will be of great help if someone can post YouTube steps for setting up codecoverage and viewing reports.

    Thanks in advance

  48. Spencer Müller Diniz March 17, 2014 at 10:53 am

    Jon Reid,

    This is an awesome tool and I’ve been using it for a couple of weeks now. Unfortunately, after upgrading to Xcode 5.1 this morning, I can’t get it to work any more. All I get now in terminal is “ERROR: no .da files found in XXXXXX” and “ERROR: no valid records found in tracefile”.

    Am I missing something or did upgrading to Xcode 5.1 actually break something?!


  49. Michael Woodhead March 25, 2014 at 5:24 am

    Hi Jon,

    Im trying to display the results of the code coverage in the post-action run time scripts for Tests. I have them running manually, but am trying to automate it as much as possible.

    I am currently running,
    bash XcodeCoverage/getcov”,

    It doesnt complain or fail, but my browser isnt opening with the results. have you been able to get something similar up and running?


  50. Hi Jon,

    I tried using this tool on my code. The code consists of Java, webservices and C++.
    Java is using web services for C++ business logic.

    I put the Xcodecoverage in the C++ project package and enabled the Generate Test Coverage Files and Instrument program flow in Xcode as per the steps you mentioned then ran the scenario. It is generating gcno files but gcda files are not getting generated.

    I want to ask you one question that whether in this flow(Java-webservices-C++) your tool can be used to generate the coverage report for C++ code?


  51. Hi,
    I am also facing same problem encounter by Scott Densmore,

    ~/Desktop/CodeCoverage/20Aug/build/Coverage-iphonesimulator ~/Desktop/CodeCoverage/20Aug
    Capturing coverage data from /Users/abc/Desktop/CodeCoverage/20Aug/build/
    geninfo: ERROR: need tool /Users/abc/Desktop/CodeCoverage/20Aug/XcodeCoverage/llvm-cov-wrapper!
    Reading tracefile
    lcov: ERROR: cannot read file!
    Reading tracefile
    lcov: ERROR: cannot read file!
    Reading data file
    genhtml: ERROR: cannot read file!
    The file /Users/abc/Desktop/CodeCoverage/20Aug/build/Coverage-iphonesimulator/lcov/index.html does not exist.sdkTest

    Please help me to resolve this.

    Thanks in advance

  52. Hi Jon,

    I was really inspired by your talk at iOSDevUK and started adding tests to my Toolkit Project. To see how good my test coverage was, I also added your Library.

    It seems, that it cannot deal with spaces in the folder name, is that possible? Without spaces in the folder name it works like a charm.

    Thanks & greetings from Germany,

    • Hi Jasmin,

      I’m pretty sure XcodeCoverage was fixed to handle white spaces. I wonder if something else in the tool chain has broken.

      By the way, this is why I avoid spaces in development folder names! This is a common problem across all tools. Unfortunately, it also means the problem can sneak back, because I’m avoiding it in the first place, so how will I know?

      • Hi Jon
        It seems to be causing an error here
        DIR=”$( cd “$( dirname “${BASH_SOURCE[0]}” )” && pwd )”
        source ${DIR}/

        Can you suggest where would you make this fix?

  53. This is so amazing! Thanks a bunch 🙂

  54. Hi, Jon.
    Thank you for your work.
    Is it possible to send results by email?
    how to do that? Because, mainly, all this stuff are for managers))
    or may be upload to Jenkins?
    Thanks again.

  55. Hi Jon
    Great tool! Though I’m getting some incorrect coverage of classes that are definitely not tested. It’s some UI related classes loaded in the beginning of the app. Since the app is launched when testing I have a suspicion that these classes gets “hits” from this launch? Could this be the case?

  56. Xcode 7.2 ? I am using KIF for unit test cases automation .

    Reading tracefile
    lcov: ERROR: no valid records found in tracefile
    Reading data file
    genhtml: ERROR: no valid records found in tracefile

    No data in file . because of that html page is not creating.

Leave a Reply

Text formatting is available via select HTML.

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>