{"id":460,"date":"2015-11-02T12:52:48","date_gmt":"2015-11-02T19:52:48","guid":{"rendered":"http:\/\/www.managerjs.com\/blog\/?p=460"},"modified":"2015-11-02T12:52:48","modified_gmt":"2015-11-02T19:52:48","slug":"install-sonar-locally-on-osx-and-analyze-a-javascript-project","status":"publish","type":"post","link":"https:\/\/www.managerjs.com\/blog\/2015\/11\/install-sonar-locally-on-osx-and-analyze-a-javascript-project\/","title":{"rendered":"Install Sonar Locally on OSX and Analyze a JavaScript Project"},"content":{"rendered":"
\n
\n

Sonar really shines with statically typed languages like Java and has some very useful analysis it can run for JavaScript projects: critical errors in syntax, code duplication, even test coverage. You can play with all these reports by installing Sonar locally. Thanks to Homebrew it’s not that hard.<\/p>\n<\/div>\n<\/div>\n

<\/p>\n

\n
\n
\n

Before you Begin<\/h3>\n
\n

Make sure you have Homebrew installed and are on the latest version of Java. If you don’t update Java then you may run into issues when starting the Sonar server.<\/p>\n

To install Homebrew<\/strong> follow the instructions at brew.sh<\/a>.<\/p>\n

To update Java<\/strong> follow the Stack Overflow instructions for How to Install Java 8 on Mac<\/a>. (It’s pretty much brew cask install java<\/code><\/span>.)<\/p>\n

If you can’t change versions of Java then try out the rest of the steps and see if sonar will run for you. \u00a0If not, you may need to maintain multiple versions of Java.<\/p>\n

If you run into problems using homebrew, then use the brew doctor<\/code><\/span> command to find out what’s wrong with your system. Follow the instructions it prints out to fix it.<\/p>\n

Note: You may compare the steps listed in this guide with this blog article on installing Sonar on Mac<\/a>. \u00a0I found some of the steps unnecessary and don’t list them here. See also related guides: Get Started in Two Minutes<\/a>, Installing a Plugin,<\/a> JS Sonar Example,<\/a> and Sonar Project Properties File Example.<\/a><\/p>\n<\/div>\n

\n
\"\"<\/div>\n<\/div>\n<\/div>\n
<\/div>\n
\n

Install Sonar and the JavaScript Plugin<\/h3>\n
\n

Use Homebrew to install Sonar, then download and install the jar for the JavaScript plugin.<\/p>\n

    \n
  1. run brew install sonar<\/code><\/span> in a terminal window<\/li>\n
  2. Find your sonar plugins directory. In my case it was \/usr\/local\/Cellar\/sonar\/5.1.2\/libexec\/extensions\/plugins\/<\/code><\/span>. Yours will be somewhere ending with “\/libexec\/extensions\/plugins<\/code><\/span>” and you can normally figure it out by inspecting the output of brew list sonar<\/code><\/span>.<\/li>\n
  3. download the JavaScript Plugin<\/a> and put it into the plugins directory<\/li>\n<\/ol>\n<\/div>\n
    \n
    \"\"<\/div>\n<\/div>\n<\/div>\n
    <\/div>\n
    \n

    Install sonar-runner and Modify Your Environment<\/h3>\n
    \n

    Use homebrew again. This time install the sonar-runner<\/code><\/span> formula. Finally, add a little to your .bashrc<\/code><\/span> file.<\/p>\n

      \n
    1. Run brew install sonar-runner<\/code><\/span><\/li>\n
    2. Follow the instructions at the end of the install. \u00a0(If you missed them you can always show them again with brew info sonar-runner<\/code><\/span>.) NOTE: I found that I didn’t have to modify sonar-runner.properties<\/code><\/span>. You do have to add something like SONAR_RUNNER_HOME=\/usr\/local\/Cellar\/sonar-runner\/2.4\/libexec<\/code><\/span> to your .bashrc<\/code><\/span> file.<\/li>\n<\/ol>\n<\/div>\n<\/div>\n
      <\/div>\n
      \n

      Configure and Analyze Your Project<\/h3>\n
      \n

      You need to add a properties file to you project, launch the Sonar server, run the analysis, and view the results.<\/p>\n

      1. In a terminal window launch the Sonar server with sonar console<\/code><\/span>. Leave it running. (You can kill it when you’re all done with “\u2318-.”.)<\/p>\n

      2. In a separate terminal go to the root of your JavaScript project. \u00a0Add a sonar-project.properties<\/code><\/span> file like this one:<\/p>\n

      # Required metadata\nsonar.projectKey=org.familysearch:fs-reservations\nsonar.projectName=FamilySearch Reservations App\nsonar.projectVersion=1.680\n\n# Comma-separated paths to directories with sources (required)\nsonar.sources=assets\n\n# Language\nsonar.language=js<\/code><\/pre>\n
      3. In the terminal run the analysis with sonar-runner<\/code><\/span><\/p>\n
      4. View the results by navigating to http:\/\/localhost:9000.<\/a> Your project should be listed at the top of the right-hand column.<\/p>\n<\/div>\n
      \n
      \"\"<\/div>\n<\/div>\n<\/div>\n
      <\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
      Sonar really shines with statically typed languages like Java and has some very useful analysis it can run for JavaScript projects: critical errors in syntax, code duplication, even test coverage. You can play with all these reports by installing Sonar locally. Thanks to Homebrew it’s not that hard.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[13],"tags":[150,46,149],"class_list":["post-460","post","type-post","status-publish","format-standard","hentry","category-lab-notebook","tag-code-quality","tag-javascript","tag-static-analysis","wow fadeInUp","entry"],"_links":{"self":[{"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/posts\/460","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/comments?post=460"}],"version-history":[{"count":2,"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/posts\/460\/revisions"}],"predecessor-version":[{"id":462,"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/posts\/460\/revisions\/462"}],"wp:attachment":[{"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/media?parent=460"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/categories?post=460"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.managerjs.com\/blog\/wp-json\/wp\/v2\/tags?post=460"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}