Setting up Eclipse to create and debug plugins for ImageJ
最近在做一个关于卫星遥感全链路仿真的项目，由于项目是基于ImageJ开发，而ImageJ提供了强大的插件机制，所以特来写一个东西说明如何将自己的代码转化为ImageJ的插件。
- Alt-File –> New
- Select the Java Project wizard and click Next
- Project name: IJ. Check Create separate folders for sources and class files. Click Next
- On the following panel, select Source tab and check if Default output folder is set to IJ/bin
- On the Libraries tab click on Add external JARs, browse to your Java SDK library folder , select tools.jar, click Ok and click on Finish to create the project.
(on my computer the Java SDK library folder is located at C:\Program Files\Java\jdk1.6.0_02\lib)
- Finally, get the latest copy of ij here, extract the zip
- Copy the ij folder and its subfolders into the source folder
- Copy the images, macros and plugins folder and only IJ_Props.txt to the IJ project root.
- Click on F5 to tell Eclipse to refresh its Package list
Create a new plugin (or import your previously developed plugins).
- Alt-File –> New
- Select the Java Project wizard and click Next
- Give your plugin a name (don't forget to add an underscore if you want it to appear in the ImageJ menu!)
- On the Source tab, check that the output folder is set TestPlugin_/bin
- On the Project tab, click Add… and select your previously created IJ project containing the ImageJ source.
- Click Finish
- Create your Java plugin files. In our example, I created a sample TESTPlugin_.java with the following content:
import ij.IJ;
import ij.plugin.PlugIn;
public class TestPlugin_ implements PlugIn {
public void run(String arg) {
IJ.error("Hello world!");
}
}
- Create a file called build.xml in the project root folder. A sample build.xml file follows, which you should adapt to your needs.
<project name="TESTPlugin_" default="" basedir=".">
<description>
TESTPlugin_ build file
</description>
<property name="src" location="src" />
<property name="build" location="bin" />
<property name="dist" location="dist" />
<property name="pluginsDir" location="$basedir/../../IJ/plugins/" />
<property name="user.name" value="Patrick Pirrotte" />
<target name="main" depends="compress" description="Main target">
<echo>
Building the .jar file.
</echo>
</target>
<target name="compress" depends="" description="generate the distribution">
<jar jarfile="TESTPlugin_.jar">
<fileset dir="." includes="plugins.config" />
<fileset dir="${build}" includes="**/*.*" />
<manifest>
<attribute name="Built-By" value="${user.name}"/>
</manifest>
</jar>
<copy file="TESTPlugin_.jar" toDir="${pluginsDir}" />
</target>
</project>
- In the Package Explorer, right click on the TESTPlugin_ project, click on Properties, select Builders, click New… and select Ant Builder
- In the Main Tab, click Browse workspace and select the build.xml from your TESTPlugin_ project.
- In the Targets tab, click Set Targets for both After clean and Auto build targets, and select both main and compress.
- Click Ok twice to keep your changes.
- Goto Run→ Debug Configurations and create a new Java Application Debug Configuration. Fill in IJ In the field Project, and ij.ImageJ in the field Main class.
- Select the Source tab, then in the Source lookup path, Add→Add Java Project. Select the TestPlugin_ project. This step is crucial if you want to step into your plugin source during the debug phase. Apply the changes.
- If you select Debug, ImageJ will start and your TESTPlugin_ will show up in the Plugins menu…
- Set breakpoints in plugins or in the ImageJ source, the debugger should break accordingly.
后注：当然上文只是其中一种方法，也还有其他方法可以实现！！！