Install Free
Eclipse | Core concepts | New code

New code

On this page

New code in the context of Clean as You Code

Focusing on new code is an important step in getting the most out of SonarQube for Eclipse. When you run an analysis on your main branch (or other long-lived branches) in SonarQube (Server, Cloud), SonarQube for Eclipse uses the New Code Definition (NCD) to determine which issues you should focus on fixing, and calls out that these issues are found in new code. Focusing on new code is at the core of implementing the Clean as You Code strategy, knowing that the other code will be incrementally fixed over time.

To achieve this, SonarQube for Eclipse offers the Focus on new code feature to highlight new code in the IDE. 

Your new code definition

When SonarQube for Eclipse is running in Connected Mode, the SonarQube for Eclipse uses the NCD defined in SonarQube (Server, Cloud). When SonarQube for Eclipse is running in standalone mode, a locally defined new code period highlights your new code.

Running SonarQube for Eclipse in Connected Mode with SonarQube (Server, Cloud) offers more opportunities to choose how you define new code.

New code definition options

When you use the NCD found in the SonarQube Server or SonarQube Cloud quality profile, you have more opportunities to choose how to define new code. Check out their respective pages for details.

Without Connected Mode, new code is defined by a new code period: any code added or changed in the last 30 days is considered new code. The 30-day timeframe is defined using Git. 

When not using Git, the new code period begins with the first SonarQube for Eclipse analysis.

There is no option to manually define a new code period in SonarQube for Eclipse. 

Setting your focus on new code

The Focus on new code feature works when SonarQube for Eclipse is running in either Connected Mode or standalone mode. As mentioned above, new code is defined differently in each mode.

Setting your focus on new code has these prerequisites running in Connected Mode:

  • Your local project must be bound to a SonarQube or SonarCloud project.
  • The new code definition must be defined in SonarQube or SonarCloud using a Previous version, Number of days, or Specific analysis
  • The Reference branch new code definition is not supported. Please check the documentation in SonarQube or on SonarCloud to properly set your new code definition. 

Setting the focus on new code is easy. To show or hide issues found in your Overall code, go to Eclipse Window > Preferences > SonarLint (or Eclipse > Settings… > SonarLint for Mac OS) and change SonarLint markers shown: between New code and Overall code.

When switching between modes, settings are applied globally to all projects open in your Eclipse workspace.

Running SonarQube for Eclipse in Connected Mode with SonarQube Server or SonarQube Cloud offers more opportunities to choose how you define new code. Check out their respective pages for details.

How the new code definition affects the analysis results

The core idea of Clean as You Code is that you focus your attention and effort on new code (code that has been added or modified recently) and improve your code incrementally. SonarQube Server and SonarQube Cloud use your NCD as a baseline for code comparison, to identify what is new code which reinforces the Clean as You Code strategy by only showing you issues found in new code.

  • When running SonarQube for Eclipse in Connected Mode and enabling the Focus on New Code feature, the NCD from SonarQube (Server, Cloud) is used to show you only issues found in new code.
  • When running SonarQube for Eclipse while not in Connected Mode and enabling the Focus on New Code feature, every SonarQube for Eclipse analysis will show you only issues found in new code

The Focus on New Code feature gives you immediate feedback in the IDE, before you submit new code with new issues.


Was this page helpful?

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARQUBE, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License