Developing ImgLib2short URL
Because people tend to have differing IDE configurations, we do not put project metadata files (e.g.,
.settings for Eclipse) into the git repository. Instead, the IDE can use Maven's
pom.xml file directly to manage your dependencies in a better way.
Getting the code
You can clone the ImgLib2 code using Git with the URL: git://github.com/imagej/imglib
Alternately, you can use ImgLib2 as a submodule of Fiji.
Developing ImgLib2 with Eclipse
To develop ImgLib2 in Eclipse, follow these steps:
- Install the Maven plugin
- Choose File > Import from the Eclipse menu
- Select "Existing Maven Projects" and click Next
- For the Root Directory, specify the path where you cloned ImgLib2
- From the projects list, leave all items checked
- Click Finish
For fresh installs, it will initially take some time (a few minutes) for Maven to download all the dependencies for both its own plugins, and for ImgLib2. This is a one-time cost. After that, Maven will check for module updates once a day, which is generally fast.
Once you have the ImgLib2 projects within Eclipse, you can reap the benefits of the improved dependency management. For example, if you have the
imglib2-algorithms projects open, the
imglib2-algorithms project will have an Eclipse project build dependency on
imglib2. If you then close the
imglib2 project, the dependency within
imglib2-algorithms with automatically become a library dependency to
imglib2-2.0-SNAPSHOT.jar, rather than the project.
Developing ImgLib2 with IDEA
IntelliJ IDEA comes with built-in support for Maven.
More instructions coming soon (see also Developing ImageJ with IDEA).
Developing ImgLib2 with NetBeans
NetBeans comes with built-in support for Maven.
More instructions coming soon (see also Developing ImageJ with NetBeans).
Developing ImgLib2 with command line tools
You can use the mvn command line tool to build ImgLib2. Just type "mvn" from any of the sub-project directories, or from the parent directory to build all four modules. By default, Maven will compile the code, run unit tests, create JAR files and install them in your local Maven repository (typically found in
~/.m2/repository). Maven does its work in a subfolder called
target which is where you'll find compiled classes and JAR artifacts.
For more on using the Maven command line tool, see Building a Project with Maven on the Maven web site.
Alternately, if you have ImgLib2 checked out as a Fiji submodule, you can build it using the Fiji Build System.