{iframe:src=http://update.sonarsource.org/plugins/flex.html|width=700|height=250|frameborder=0}
Your browser does not support iframes.
{iframe}

Description / Features

The plugin enables analysis of ActionScript projects within Sonar.

It is compatible with the Issues Report plugin to run pre-commit local analysis.

Installation

1. Install the Flex plugin through the Update Center or download it into the SONAR_HOME/extensions/plugins directory
2. Restart the Sonar server

Usage

Run a Sonar Analysis with the Sonar Runner (Recommended Way)

To launch a Sonar analysis of your Flex project, use the Sonar Runner.

A sample project is available on github that can be browsed or downloaded: /projects/languages/flex/flex-sonar-runner.

Run a Sonar Analysis with the other Analyzers

Maven and Ant can also be used to launch analysis on Flex projects.

Unit Tests an Code Coverage Reports

If you want to have unit test results in your Sonar dashboard, execute your unit tests before running the Sonar analysis and use the "sonar.dynamicAnalysis=reuseReports" property along with the "sonar.surefire.reportsPath" one to specify where Sonar should retrieve the XML reports.

You can provide the path to the code coverage report (in cobertura xml format) using the "sonar.cobertura.reportPath" property (the value must point to the file location, not its folder).

Metrics

See Metrics documentation page.

Extending Coding Rules using XPath

New coding rules can be added using XPath. See the related documentation.

To navigate the AST, download the SSLR Flex Toolkit.

Troubleshooting

FlexPMD engine - that is embedded in the Flex plugin, suffers from some bugs which can break Sonar analyses. Here are some of them you might encounter if FlexPMD rules are activated in the Flex quality profile that you are using:

• "fb:purpose="styling" attribute in MXML files causes OutOfMemory errors (see SONARPLUGINS-2400). 
  
  • Removing it fixes the issue.

• the following code snippet make FlexPMD engine crash:
  
  • in MXML files:

        <!-- this crashes FlexPMD --> 
        <fx:Metadata> 
                <![CDATA[[HostComponent("spark.components.ToggleButton")]]]> 
        </fx:Metadata>      
        <!-- this crashes FlexPMD as well (note the space between the 2 opening brackets --> 
        <fx:Metadata> 
                <![CDATA[ [HostComponent("spark.components.ToggleButton")]]]> 
        </fx:Metadata>
        
        <!-- this does not crash --> 
        <!--fx:Metadata> 
                <![CDATA[ 
                [HostComponent("spark.components.ToggleButton")] 
                ]]> 
        </fx:Metadata--> 

• • in AS files:

private function foo(partName:String):void 
{ 
  switch (partName) 
  { 
    /*comment*/ 
    case "test": 
      trace("foo"); 
      break; 
    case "foo": 
      trace("foo"); 
      break; 
    case "bar": 
      trace("foo"); 
      break; 
    } 
} 

Change Log