Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

forsis plugin

fastlane Plugin Badge

forsis is a fastlane plugin that will be helpful to those swift developers who use SonarQube to analyze their code. forsis uses JUnit test reports generated by fastlane to produce generic test execution reports supported by SonarQube.

If you have used SonarQube for analyzing Swift projects, you've probably noticed that other than the code coverage, you don't get any information related to the unit tests appearing on the project dashboard. This plugin, however, will help you get more visibility on the unit tests by generating a test report that can be analyzed by SonarQube. By sending such a test report to SonarQube, the total number of unit tests will be displayed on the project dashboard as shown in the following image.

In addidtion, you can see a breakdown of test results under project Measures > Coverage > Tests. Alternatively, you can select the test count on the dashbord (by clicking it) to see the test results as shown in the image below.

Getting Started

To get started with fastlane-plugin-forsis, add it to your project by running:

fastlane add_plugin forsis

Start using the plugin by adding this example 'lane' to your Fastfile:

lane :sonarqube_test_report do
       junit_report_file: './fastlane/report.junit',
       sonar_report_directory: 'path_to_a_directory_to_store_sonarqube_report'
  • junit_report_file is the path to the JUnit test report generated by fastlane
  • sonar_report_directory is the directory to store the generated SonarQube report. This parameter is optional and the defaut value is the fastlane directory in the main repo (i.e., ./fastlane).

Note: This plugin uses the fastlane JUnit test report named report.junit. This report is generated by running tests through fastlane using run_tests or scan actions. Therefore, in your Fastfile, the forsis lane must be run after the lane that runs the tests. Including the test lane, your Fastfile would look like the example below.

lane :run_unit_tests do
      workspace: 'path_to_the_xcworkspace_directory',
      scheme: 'path_to_the_project_test_scheme',
      devices: ["iPhone 6s"],
      # output_types: 'junit',
      output_directory: './fastlane/test_output',
lane :sonarqube_test_report do
	    junit_report_file: './fastlane/test_output/report.junit',
	    sonar_report_directory: './fastlane'

The run_tests action generates a test report in two different formats by default (html and junit). (Note: the scan method is an alias for the run_tests method.) If you would not like to get the html report, you can override this default behavior by setting the parameter output_types to only 'junit'. In the example :run_unit_tests lane above, uncomment the line for output_types to only get a JUnit test report. Test reports are then found in the fastlane directory or in the output_directory if it has been set. To learn more about how to run tests through fastlane, check out the [fastlane documentation] (

How to use the SonarQube test report generated by forsis?

This plugin creates an XML test report called Test_sonarqube_report.xml. To get benefit from this report, you need to feed it to SonarQube properly. To do so, you need to set the two following SonarQube analysis parameters:

  • sonar.tests is the path to the directory that contains tests
  • sonar.testExecutionReportPaths is the path to the SonarQube test report file generated by the plugin i.e., the value of the sonar_report_directory in the forsis action followed by the name of the XML file that contains the report. This would be fastlane/Test_sonarqube_report.xml, if sonar_report_directory was not set.

If you need help setting up analysis parameters for SonarQube, refer to the SonarQube Analysis Parameters documentation.

Run tests for this plugin

To run both the tests, and code style validation, run


To automatically fix many of the styling issues, use

rubocop -a


If you have trouble using plugins, check out the Plugins Troubleshooting guide.

Using fastlane Plugins

For more information about how the fastlane plugin system works, check out the Plugins documentation.

About fastlane

fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out This software is available as open source under the terms of the MIT License.


Bug reports and suggestions for improvements are always welcome. PRs are even better!!

If you run into any issues, before submitting a new GitHub issue, please make sure to

If the above doesn't help, please submit an issue on GitHub. When reporting a bug, please make sure to include a spec that highlights the bug.


This software is available as open source under the terms of the MIT License.


A Fastlane plugin that converts JUnit test reports to generic test execution reports supported by SonarQube




No packages published