What is it?
Xcode-like HTML report for Unit and UI Tests
Features
- Supports parallel testing
- Supports attachments:
- .png
- .jpeg
- .txt
- 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
Fastlane Support
https://github.com/TitouanVanBelle/fastlane-plugin-xchtmlreport
Installation
Homebrew
Install via Homebrew.
# Install latest stable version
$ brew install https://raw.githubusercontent.com/TitouanVanBelle/XCTestHTMLReport/develop/xchtmlreport.rb
# Install latest master branch
$ brew install --HEAD https://raw.githubusercontent.com/TitouanVanBelle/XCTestHTMLReport/develop/xchtmlreport.rb
Alternate
Simply execute the following command to download the latest version of XCTestHTMLReport
$ bash <(curl -s https://raw.githubusercontent.com/TitouanVanBelle/XCTestHTMLReport/master/install.sh)
You can also specify a branch or tag
$ bash <(curl -s https://raw.githubusercontent.com/TitouanVanBelle/XCTestHTMLReport/master/install.sh) '1.0.0'
Usage
Run your UI tests using xcodebuild without forgetting to specify the resultBundlePath
$ xcodebuild test -workspace XCTestHTMLReport.xcworkspace -scheme XCTestHTMLReportSampleApp -destination 'platform=iOS Simulator,name=iPhone 7,OS=11.0' -resultBundlePath TestResults
Then use the previously downloaded xchtmlreport tool to create the HTML report
$ xchtmlreport -r TestResults
Report successfully created at ./index.html
Multiple Result Bundle Path
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
Contribution
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.
License
XCTestHTMLReport is available under the MIT license.