A simple command line utility to convert .xcresults to a web page to understand what failed or how to optimize parallel UI tests.
NOTE: In previous versions you would run with
./xcresultviewer, now you run with./xcrvwhich is much easier to type.
When UI tests randomly fail on CI it can be really hard to trace back what happened to cause it.
By default, xcresultviewer takes an .xcresult bundle and converts it into a web page so you can see the activities and screenshots and easily follow the flow the app took before the test failed.
xcresultviewer can also analyze an xcresult bundle to help you optimize your parallel UI tests.
- Download the latest release
- In Terminal, navigate to where the utility is located
- Run
./xcrv <options> '<path to an .xcresult bundle (usually located in derived data)>'
Watch out for spaces in the path name.
To simply view any failures as a web page in an xcresult you can just pass a path to an xcresult bundle without any options:
./xcrv '<path to an .xcresult bundle>'
xcresultviewer only shows tests that failed and matches up automatic screenshots with activities so you can follow the flow (in reverse).
If you don't want xcresultviewer to automatically open a browser after generating the html page, pass the -s flag:
./xcrv -s '<path to an .xcresult bundle>'
or
./xcrv --skip-open-browser '<path to an .xcresult bundle>'
If you're more interested in learning how to optimize and speed up your parallel tests you can
pass the -a flag instead:
./xcrv -a '<path to an .xcresult bundle>'
or
./xcrv --analyze '<path to an .xcresult bundle>'
xcresultviewer is in early prototype stage so I welcome suggestions and contributions!