ImageJ

<div style="float: right">
{{Development | source}}
<div style="clear: right"></div>
{{Windows | '''Avoid permissions issues.''' We recommend installing Eclipse ''outside'' of the <code>Program Files</code> directory. E.g.: '''<code>C:\Users\frood\Programs\eclipse</code>''', where '''<code>C:\Users\frood</code>''' is your user directory.

'''Configuring Eclipse.''' After installing Eclipse, you will need to configure it to know about your JDK.

Use Wordpad to edit the <code>eclipse.ini</code> file in your Eclipse installation (e.g., '''<code>C:\Users\frood\Programs\eclipse</code>'''). (Do not use Notepad, because it will not handle the Unix-style line breaks properly.) Carefully follow [http://wiki.eclipse.org/Eclipse.ini#Specifying_the_JVM these instructions] to specify the proper JDK. Then save the file and quit Wordpad.

Now update Eclipse's JRE to be JDK-aware:

* Launch Eclipse
* From the menu choose Window {{arrow}} Preferences
* Select Java {{arrow}} Installed JREs
* Click Search..., navigate to your JDK installation folder (e.g., '''<code>C:\Program Files\Java\jdk1.8.0_11</code>''') and click OK
* Check the box next to the JRE that appears and click OK
}}
<div style="clear: right"></div>
{{Linux | '''Avoid permissions issues.''' We recommend installing to <code>$HOME/eclipse</code>.

'''Do not use a package manager.''' For several reasons, we do not recommend installing Eclipse from a package manager. You may not get a new enough version of Eclipse (we recommend 4.3+), you will not get the Java Developers version that includes the M2E plugins, and you will likely have trouble installing additional plugins due to the permissions issues with the system-wide installation.
}}
</div>
This article explains how to install and configure Eclipse for use with [[ImageJ]] development. Directions correspond to Eclipse 4.4 Luna, and may need adjustment for other versions.
__TOC__

== Install and configure Eclipse ==

=== Install the Java Development Kit ===

* Download and install the Java Development Kit (JDK) from the [http://www.oracle.com/technetwork/java/javase/downloads/ Java web site].

=== Install Eclipse ===

* Download "Eclipse IDE for Java Developers" from the [http://www.eclipse.org/downloads/ Eclipse web site].
{{Warning |  It is '''important''' to choose "Eclipse IDE for Java Developers" because it contains Maven support built-in. Otherwise, you will have to [http://eclipse.org/m2e/ install the M2E plugin manually].}}

* Unpack the archive to a location of your choice.

* See the right-hand sidebars for platform-specific notes.

== Clone the source code ==

* Using your [http://git-scm.com/downloads/guis Git client of choice], clone the [[source code]] which interests you.

== Import the source code ==

# Choose File {{arrow}} Import from the Eclipse menu
# Select "Existing Maven Projects" and click Next
# Browse to the folder where you cloned the project source code
# Click Finish

== Launching ImageJ ==

If you cloned the [https://github.com/imagej/imagej imagej project], you can launch the program as follows:

# In the Package Explorer, expand the <code>imagej</code> project
# Navigate into <code>src/main/java</code>
# Navigate into <code>net.imagej</code>
# Right-click on <code>Main.java</code>
# Choose "Run As" and then "Java Application"

Other projects will have different main classes.

== Keyboard Shortcuts ==

For Mac, replace {{Key|Ctrl}} with  {{Key|Cmd}}

* {{Key|Ctrl}}+{{Key|Shift}}+{{Key|T}}: find objects
* {{Key|Ctrl}}+{{Key|1}}: quick fix
* {{Key|F3}}: jump to class (to edit the code, see [[Architecture#Using_snapshot_couplings_during_development|snapshot coupling]])
* {{Key|Ctrl}}+{{Key|O}}: show outline
* {{Key|Ctrl}}+{{Key|Space}}: auto-complete
* {{Key|Ctrl}}+{{Key|T}}: shows all implementations of interface or class
* {{Key|Alt}}+{{Key|Up}} or {{Key|Alt}}+{{Key|Down}}: move lines up or down

Cleaning up
* {{Key|Ctrl}}+{{Key|Shift}}+{{Key|O}}: organize imports
* {{Key|Ctrl}}+{{Key|Shift}}+{{Key|F}}: format code (BUT make sure you set the [[Coding_style#Eclipse_code_style_profiles|coding style]])
* {{Key|Alt}}+{{Key|Shift}}+{{Key|S}} {{Key|U}}: clean up (does format and much more)
* {{Key|Alt}}+{{Key|Shift}}+{{Key|R}}: refactor rename