This Repository has been transfered from TitouanVanBelle/XCTestHTMLReport to this new organization. 🥳🎉 Contributions are very very welcome! 🥳🎉
Xcode-like HTML report for Unit and UI Tests
- Supports parallel testing
- Supports attachments:
- .png
- .jpeg
- .heic
- .txt
- .log
- .mp4
- Navigate through the report with the keyboard's arrow keys
- Filter out successful or failed tests
- Displays information about the target device
- Displays activity logs
- Junit report
https://github.com/TitouanVanBelle/fastlane-plugin-xchtmlreport
Mint is the easiest way...
Install latest stable version
mint install XCTestHTMLReport/XCTestHTMLReport
Install latest from develop branch
mint install XCTestHTMLReport/XCTestHTMLReport@develop
Install via Homebrew tap...
Install latest stable version
brew install XCTestHtmlReport/xchtmlreport/xchtmlreport
Install latest from develop branch
$ wget https://raw.githubusercontent.com/XCTestHTMLReport/XCTestHTMLReport/develop/xchtmlreport.rb
$ brew install --HEAD --build-from-source xchtmlreport.rb
Run your UI tests using xcodebuild
without forgetting to specify the resultBundlePath
$ xcodebuild test -workspace XCTestHTMLReport.xcworkspace -scheme SampleApp -destination 'platform=iOS Simulator,name=iPhone 7,OS=11.0' -resultBundlePath TestResults
Then use the previously downloaded xchtmlreport tool to create the HTML report. Additionally, -i
flag is also available to inline all resources, this is convenient for exporting the html file standalone. HTML file will be much heavier but much more portable.
$ xchtmlreport -r TestResults
Report successfully created at ./index.html
You can also pass multiple times the -r option.
$ xchtmlreport -r TestResults1 -r TestResults2
Report successfully created at ./index.html
This will create only one HTML Report in the path you passed with the -r option
You can generate junit reports with the -j
flag
$ xchtmlreport -r TestResults1 -j
Report successfully created at .index.html
JUnit report successfully created at TestResults1.xcresult/report.junit
Please create an issue whenever you find an issue or think a feature could be a good addition to XCTestHTMLReport. Always make sure to follow the Contributing Guidelines. Feel free to take a shot at these issues.
XCTestHTMLReport is available under the MIT license.