top bar

Difference between revisions of "Using Netbeans"

 
(One intermediate revision by one other user not shown)
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, you can install the JDK and NetBeans at the same time from [http://www.oracle.com/technetwork/java/javase/downloads/ Oracle's JDK download page].
+
# 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.6 - but using a newer Java Platform in NetBeans than the one shipped with Micro-Manager is usually okay).
+
# 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).
 
<!--
 
<!--
 
-->
 
-->
Line 41: Line 41:
 
<!--
 
<!--
 
-->
 
-->
#* '''VM options:''' for 64 bit systems, type in <code>-Xmx3000M</code>, otherwise use <code>-Xmx600M</code>. This sets the maximum memory (megabytes) used by Java.
+
#* '''VM options:''' for 64 bit systems, type in <code>-Xmx3000M</code>, otherwise use <code>-Xmx600M</code>. This sets the maximum memory (megabytes) used by Java. If running Micro-Manager 2.0, you also need to supply <code>-Dforce.annotation.index=true</code>.
If running Micro-Manager 2.0, you also need to supply <code>-Dforce.annotation.index=true</code>.
+
 
<!--
 
<!--
 
-->
 
-->

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)

  1. Download and install a recent Micro-Manager nightly build. We will refer to the installed Micro-Manager directory as $INSTALLDIR below.
  2. Use Subversion to download a copy of the latest Micro-Manager source. We'll refer to the root source directory as $SRCDIR below.
  3. 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.
  4. Choose File > New Project... > [Categories] Java > [Projects] Java Project with Existing Sources. Press Next.
  5. Give your project a name. The Project Folder is best saved outside of the Micro-Manager source directory. Press Next.
  6. 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.
  7. Include all files (**). Press Finish.
  8. Right-click your project in the Projects tab (probably at left) and select Properties.
  9. 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).
  10. 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 for MMJ_.jar.
  11. 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.
  12. 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.
© Micro-Manager : Vale Lab, UCSF 2006-2011 | All Rights Reserved | Contact