Difference between revisions of "Using Netbeans"
Line 1: | Line 1: | ||
− | The following instructions for debugging Micro-Manager's Java code with NetBeans are intended to work on Windows or Mac. | + | The following instructions for debugging Micro-Manager's Java code with NetBeans are intended to work on Windows or Mac. Updated for 2.0-gamma |
(See also: [[Writing plugins for Micro-Manager]]) | (See also: [[Writing plugins for Micro-Manager]]) | ||
Line 8: | Line 8: | ||
# Use [http://subversion.tigris.org/ Subversion] to download a copy of the latest [http://micro-manager.org/wiki/Micro-Manager_Source_Code Micro-Manager source]. We'll refer to the root source directory as <code>$SRCDIR</code> below.<!-- | # Use [http://subversion.tigris.org/ Subversion] to download a copy of the latest [http://micro-manager.org/wiki/Micro-Manager_Source_Code Micro-Manager source]. We'll refer to the root source directory as <code>$SRCDIR</code> below.<!-- | ||
--> | --> | ||
− | # Download, install and run [http://netbeans.org NetBeans]. The Java SE Bundle is sufficient if you already have the JDK (Java Development Kit) installed on your computer. Otherwise, | + | # Download, install and run [http://netbeans.org NetBeans]. The Java SE Bundle is sufficient if you already have the JDK (Java Development Kit) installed on your computer. Otherwise, download a JDK from [https://adoptopenjdk.net/ AdoptOpenJDK] . Micro-Manager is currently developed with JDK 8. |
<!-- | <!-- | ||
--> | --> | ||
Line 17: | Line 17: | ||
<!-- | <!-- | ||
--> | --> | ||
− | # Under '''Source Package Folders''', click '''Add Folder''' at right and browse to <code>$SRCDIR/mmstudio/src</code>. If you want to develop a plugin, you can also add <code>$SRCDIR/plugins/*/src</code> at this time. Press '''Next'''. | + | # Under '''Source Package Folders''', click '''Add Folder''' at right and browse to <code>$SRCDIR/mmstudio/src/main/java</code>, as well as <code>$SRCDIR/mmstudio/src/main/resources</code>. If you want to develop a plugin, you can also add <code>$SRCDIR/plugins/*/src/main/java</code> at this time. You can also add plugins later. Press '''Next'''. |
<!-- | <!-- | ||
--> | --> | ||
Line 26: | Line 26: | ||
<!-- | <!-- | ||
--> | --> | ||
− | # Select '''Libraries''' under '''Categories'''. Make sure the '''Java Platform''' matches the version of Micro-Manager you are using (e.g., 64-bit JDK 1. | + | # Select '''Libraries''' under '''Categories'''. Make sure the '''Java Platform''' matches the version of Micro-Manager you are using (e.g., 64-bit JDK 1.8 - but using a newer Java Platform in NetBeans than the one shipped with Micro-Manager is usually okay). |
<!-- | <!-- | ||
--> | --> |
Latest revision as of 11:31, 13 November 2019
The following instructions for debugging Micro-Manager's Java code with NetBeans are intended to work on Windows or Mac. Updated for 2.0-gamma
(See also: Writing plugins for Micro-Manager)
- Download and install a recent Micro-Manager nightly build. We will refer to the installed Micro-Manager directory as
$INSTALLDIR
below. - Use Subversion to download a copy of the latest Micro-Manager source. We'll refer to the root source directory as
$SRCDIR
below. - Download, install and run NetBeans. The Java SE Bundle is sufficient if you already have the JDK (Java Development Kit) installed on your computer. Otherwise, download a JDK from AdoptOpenJDK . Micro-Manager is currently developed with JDK 8.
- Choose File > New Project... > [Categories] Java > [Projects] Java Project with Existing Sources. Press Next.
- Give your project a name. The Project Folder is best saved outside of the Micro-Manager source directory. Press Next.
- Under Source Package Folders, click Add Folder at right and browse to
$SRCDIR/mmstudio/src/main/java
, as well as$SRCDIR/mmstudio/src/main/resources
. If you want to develop a plugin, you can also add$SRCDIR/plugins/*/src/main/java
at this time. You can also add plugins later. Press Next. - Include all files (**). Press Finish.
- Right-click your project in the Projects tab (probably at left) and select Properties.
- Select Libraries under Categories. Make sure the Java Platform matches the version of Micro-Manager you are using (e.g., 64-bit JDK 1.8 - but using a newer Java Platform in NetBeans than the one shipped with Micro-Manager is usually okay).
- Under Compile > Compile-time Libraries, click Add Jar/Folder and add
$INSTALLDIR/ij.jar
, as well as all jars in$INSTALLDIR/plugins/Micro-Manager
except forMMJ_.jar
. - Select Run under Categories. For the <default config>, set the following parameters:
- Main Class: type in
ij.ImageJ
- Working Directory: type in your
$INSTALLDIR
- VM options: for 64 bit systems, type in
-Xmx3000M
, otherwise use-Xmx600M
. This sets the maximum memory (megabytes) used by Java. If running Micro-Manager 2.0, you also need to supply-Dforce.annotation.index=true
.
- Main Class: type in
- Click OK, and then right-click your project and choose Debug. If all is well, then Micro-Manager should launch inside ImageJ.
Note
The components from the installed Micro-Manager can get out of sync with the Subversion source. If you encounter unexpected errors, update to the latest nightly build and the latest source revision.