##This is a minimal Maven project implementing an ImageJ 1.x plugin
It is intended as an ideal starting point to develop new ImageJ 1.x plugins in an IDE of your choice. You can even collaborate with developers using a different IDE than you.
Die-hard command-line developers can use Maven directly by calling mvn in the project root.
However you build the project, in the end you will have the
(called artifact in Maven speak) in the target/ subdirectory.
To copy the artifact into the correct place, you can call
mvn -Dimagej.app.directory=/path/to/Fiji.app/. This will not only copy your
artifact, but also all the dependencies. Restart your ImageJ or call
Help>Refresh Menus to see your plugin in the menus.
Developing plugins in an IDE is convenient, especially for debugging. To that end, the plugin contains a main() method which sets the plugins.dir system property (so that the plugin is added to the Plugins menu), starts ImageJ, loads an image and runs the plugin. See also this page for information how Fiji makes it easier to debug in IDEs.
Since this project is intended as a starting point for your own developments, it is in the public domain.
##How to use this project as a starting point
git clone git://github.com/imagej/minimal-ij1-plugin, or
- unpack https://github.com/imagej/minimal-ij1-plugin/archive/master.zip
- Edit the
pom.xmlfile. Every entry should be pretty self-explanatory. In particular, change
- the artifactId (and optionally also groupId)
- the version (note that you typically want to use a version number ending in -SNAPSHOT to mark it as a work in progress rather than a final version)
- the dependencies (read how to specify the correct groupId/artifactId/version triplet here)
- the developer information
- the scm information
- Remove the
Process_Pixels.javafile and add your own
src/main/java/<package>/(if you need supporting files -- like icons -- in the resulting
.jarfile, put them into
src/main/resources/plugins.configto set where the plugin appears in the ImageJ menu.
- Replace the contents of
README.mdwith information about your project.
Eclipse Tip: To ensure that Maven copies the plugin to your Fiji folder
- Go to Run>Run Configurations...
- Choose your run configuration under Maven Build
- Add the following parameter: name:
This ensures that the final
.jar file will also be copied to your Fiji plugins folder everytime you run the Maven Build. Detailed Instruction.
Publishing your project
If you cloned the
minimal-ij1-plugin repository, you probably want to
publish the result in your own repository:
git statusto verify .gitignore lists all the files (or file patterns) that should be ignored
git add .and
git add -uto stage the current files for commit
git guito commit the changes
- Create a new GitHub repository
git remote set-url origin firstname.lastname@example.org:<username>/<projectname>
git push origin HEAD