applideveloper / XCTestHTMLReport

Xcode-like HTML report for Unit and UI Tests

This Repository has been transfered from TitouanVanBelle/XCTestHTMLReport to this new organization. 🥳🎉 Contributions are very very welcome! 🥳🎉

What is it?

Xcode-like HTML report for Unit and UI Tests

Features

• 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

Fastlane Support

https://github.com/TitouanVanBelle/fastlane-plugin-xchtmlreport

Installation

Mint

Mint is the easiest way...

Install latest stable version

mint install XCTestHTMLReport/XCTestHTMLReport

Install latest from main branch

mint install XCTestHTMLReport/XCTestHTMLReport@main

Homebrew

Install via Homebrew tap...

Install latest stable version

brew install XCTestHtmlReport/xchtmlreport/xchtmlreport

Install latest from main branch

brew install XCTestHtmlReport/xchtmlreport/xchtmlreport --HEAD

Usage

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

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

Generate Junit Reports

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

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.