[jboss-dev-forums] [JBoss Tools Development] - JBoss Tools Development Environment

[Nick Boldt]

Nick Boldt [https://community.jboss.org/people/nickboldt] modified the document:

"JBoss Tools Development Environment"

To view the document, visit: https://community.jboss.org/docs/DOC-18124

--------------------------------------------------------------
* 
 #Tools_and_technologies Tools and technologies


** 
 #Java Java


** 
 #Eclipse_PDERCP Eclipse PDE/RCP


** 
 #SVN SVN


** 
 #Tips_for_productivity_and_quality Tips for productivity and quality


*** 
 #Install_Code_Recommanders Install Code Recommanders


*** 
 #Static_analysis Static analysis


**** 
 #Enable_all_JDT_warnings Enable all JDT warnings


**** 
 #Install_Findbugs_for_Eclipse Install Findbugs for Eclipse


**** 
 #Install_PMD_for_Eclipse Install PMD for Eclipse


*** 
 #Coverage Coverage


* 
 #Get_source Get source


** 
 #To_work_on_a_specific_component To work on a specific component


* 
 #Set_up_a_target_platform Set up a target platform


** 
 #Import_target_platforms Import target platforms


** 
 #Choose_and_use_a_target_platform Choose and use a target platform


* 
 #Run_JBoss_Tools_and_Tests_from_your_IDE Run JBoss Tools and Tests from your IDE




This article explains the different steps to set up a 1st-class environment when you want to write code for JBoss Tools

h1. Tools and technologies
h2. Java
JBoss Tools requires Java 6. Ensure your JRE and JDK are compatible with Java 6

h2. Eclipse PDE/RCP
JBoss Tools are a set of plugins for Eclipse. Then get your favourite recent version of Eclipse from here:  http://eclipse.org/downloads/ http://eclipse.org/downloads/ We recommand you using +Eclipse for RCP and RAP Developers+. But you can also install PDE in any other installation of Eclipse:

 https://community.jboss.org/servlet/JiveServlet/showImage/102-18124-5-18511/installPDE.png  https://community.jboss.org/servlet/JiveServlet/downloadImage/102-18124-5-18511/450-477/installPDE.png 
h2. SVN
You'll need to install a recent version of SVN (1.6 or more recent). Then you should install SVN Tools in Eclipse.  You are free to choose your favourite Eclipse plugin and SVN connector by yourself, however, curret author of this page recommands using Subversive (part of the Eclipse latest release site) with SVNKit connector. Feel free to install Subversive extensions for other projects, it's always helpful.

h2. Tips for productivity and quality
Here are some highly recommanded plugins that will make your more efficient when inside the IDE
h3. Install Code Recommanders
Provides additional snippets, templates and smart completion. Not intrusive. You can find it on the "Juno" update-site or the current Eclipse release site.

h3. Static analysis
Static analysis will detect bug very early and will save you minutes of debug every day. Using it will make you and your colleagues happier. It tells you while typing code that you may have a bug. No need to wait for running test or CI reports to detect this.
h4. Enable all JDT warnings
JDT provides very good static analysis, and can prevent you from writing bugs. You simply have to turn all "ignored" advices to "warning" in Window > Preference > Java > Compiler > Errors/Warning.

 https://community.jboss.org/servlet/JiveServlet/showImage/102-18124-5-18512/jdtWarnings.png  https://community.jboss.org/servlet/JiveServlet/downloadImage/102-18124-5-18512/450-431/jdtWarnings.png 
h4. Install Findbugs for Eclipse
 http://marketplace.eclipse.org/content/findbugs-eclipse-plugin http://marketplace.eclipse.org/content/findbugs-eclipse-plugin
h4. Install PMD for Eclipse
 http://marketplace.eclipse.org/content/pmd-eclipse http://marketplace.eclipse.org/content/pmd-eclipse

h3. Coverage
Coverage answers to the question "What is tested or net?".
JBoss Tools CI builds provide Jacoco reports for coverage by unit tests (file name is jacoco.exec). This file can easily be analyzed inside Eclipse on your Java editor using EclEmma plugin:  http://marketplace.eclipse.org/content/eclemma-java-code-coverage http://marketplace.eclipse.org/content/eclemma-java-code-coverage

h1. Get source
Each JBoss Tools component is now its own GitHub repo:  https://github.com/jbosstools/ https://github.com/jbosstools/ 
h2. To work on a specific component
The easiest way to get started is to check out source for only the module you wish to work on, and import Java projects from this part of the source tree.
Example:
* I  want to fix a bug in CDI component of JBT: git clone git://github.com/jbosstools/jbosstools-server.git and import plugins and tests projects from plugns/* and tests/*

h1. Set up a target platform
Target platforms (TP) are aimed at specifying what are the dependencies allowed and used to write, compile and execute code. *Target Platform=Build Path + Default Runtime Classpath.* We provide several TP that have different purpose. We do set up some default TP for development, that you should use.
h2. Import target platforms
Import into your Eclipse workspace JBoss Tools target platforms from GitHub: 

git clone git://github.com/jbosstools/jbosstools-build.git

You can then build a specific target platform like this:

cd jbosstools-build/target-platforms/jbosstools-JunoSR1a/; mvn clean install 
h2. Choose and use a target platform
Then go into Window > Preference > Plug-in development > Target Platform. We recommend you to use *multiple.target* since it will contain all deps allowed from 3rd-party (Eclipse, Google...) *AND SOURCE BUNDLES*. If you don't depend on any other JBoss Tools project, please use *unified.target*.
 https://community.jboss.org/servlet/JiveServlet/showImage/102-18124-5-18513/TP.png  https://community.jboss.org/servlet/JiveServlet/downloadImage/102-18124-5-18513/450-333/TP.png 

h1. Run JBoss Tools and Tests from your IDE
Once Target Platform is configured, you can easily give a try to your plugins using +Run As > Java Application.+ You can also run automated tests from your IDE using +Run As... > JUnit Plugin Tests+.
--------------------------------------------------------------

Comment by going to Community
[https://community.jboss.org/docs/DOC-18124]

Create a new document in JBoss Tools Development at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2129]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-dev-forums/attachments/20121204/fab9be44/attachment-0001.html