diff --git a/developers.html b/developers.html index e472d737a37410525318b93c1f3c3fdf677089d7..444694e979936ea6e21eb919d6ea4e4fb63260a2 100644 --- a/developers.html +++ b/developers.html @@ -147,7 +147,7 @@ binary distribution. The default installation directory referred to by various Savage and X3D build files is <br /> - <code style="color:darkgreen"><b>C:\apache-ant-1.10.5</b></code> + <code style="color:darkgreen"><b>C:\apache-ant-1.10.6</b></code> </li> <li> Prepend the following executable paths to the @@ -160,7 +160,7 @@ system environment variables as follows: <br /> - <code style="color:darkgreen"><b>ANT_HOME=C:\apache-ant-1.10.5</b></code> + <code style="color:darkgreen"><b>ANT_HOME=C:\apache-ant-1.10.6</b></code> <br /> If system memory is limited, additional options might be needed: <br /> @@ -183,11 +183,11 @@ to install libraries for optional ant tasks as follows (<a href="antConfigurationFetchOutput.txt">example output</a>): <br /> - <code style="color:darkgreen"><b>C:\apache-ant-1.10.5> ant -f fetch.xml -Ddest=system</b></code> + <code style="color:darkgreen"><b>C:\apache-ant-1.10.6> ant -f fetch.xml -Ddest=system</b></code> </li> <li>Confirm proper path and installation: <pre><b>ant -version</b> -Apache Ant(TM) version 1.10.5 compiled on February 2 2017 +Apache Ant(TM) version 1.10.6 compiled on May 2 2019 </pre> </li> <li> @@ -239,7 +239,7 @@ Apache Ant(TM) version 1.10.5 compiled on February 2 2017 </ul> <li> NetBeans users can reset the default directory referred to by NetBeans: - <i>Tools</i> menu, <i>Options</i> panel, <i>Miscellaneous</i> tab, <i>Ant</i> subtab, <i>Ant home</i> <code style="color:darkgreen"><b>C:\apache-ant-1.10.5</b></code> + <i>Tools</i> menu, <i>Options</i> panel, <i>Miscellaneous</i> tab, <i>Ant</i> subtab, <i>Ant home</i> <code style="color:darkgreen"><b>C:\apache-ant-1.10.6</b></code> </li> <li> For server-side installations (including <a href="#Jenkins">Jenkins</a>), @@ -818,6 +818,14 @@ Note that the -d switch is necessary for domain users. Default Java version used in Savage projects is <code style="color:darkgreen"><b>jdk1.8.0_212</b></code> </li> + <ul> + <li> + Alternative Java version used in current development is + <code style="color:darkgreen"><b>jdk-12.0.1</b></code> + with future work including + <code style="color:darkgreen"><b>OpenJDK</b></code> + </li> + </ul> <li> Verify that the system environment variables @@ -834,14 +842,21 @@ Note that the -d switch is necessary for domain users. <code style="color:darkgreen"><b> PATH=.;%JAVA_HOME%\bin;;%ANT_HOME%\bin;</b></code> (usually inserted at the beginning of an existing PATH, if it already exists) </li> - <li>Test what version of Java is installed for your operating system via a console command line. Example: + <li>Test what version of Java is installed for your operating system via console command line. Examples: + + <pre> +<b>$ java -version</b> +java version "1.8.0_221" +Java(TM) SE Runtime Environment (build 1.8.0_221-b11) +Java HotSpot(TM) 64-Bit Server VM (build 25.221-b11, mixed mode) +</pre> <pre> <b>$ java -version</b> -java version "1.8.0_212" -Java(TM) SE Runtime Environment (build 1.8.0_212-b10) -Java HotSpot(TM) 64-Bit Server VM (build 25.212-b10, mixed mode) +java version "12.0.2" 2019-07-16 +Java(TM) SE Runtime Environment (build 12.0.2+10) +Java HotSpot(TM) 64-Bit Server VM (build 12.0.2+10, mixed mode, sharing) </pre> </li> <li> @@ -866,13 +881,14 @@ Java HotSpot(TM) 64-Bit Server VM (build 25.212-b10, mixed mode) This may be a different version (for example, JRE version 1.7.*) without interfering with the command-line PATH version. </li> <li> - If desired, developers can choose among multiple Java platforms in NetBeans - via the menu Tools > Java Platforms. However, in practice, we have - found it best to only install a single version of Java on each machine. + If desired, developers can choose among multiple versions of Java platforms in NetBeans + via the menu Tools > Java Platforms. Over years of practice, we earlier + found it best to only install a single version of Java on each machine to avoid configuration collisions. </li> <li> + For JDK 1.8 (but not later), <a href="http://www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html">Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 8 Download</a> - is needed for various builds + is needed to support various builds (link also found at bottom of JavaSE downloads page). <ul> <li> Extract the contents (including README.txt) for inclusion in the JDK development build, for example @@ -1400,6 +1416,12 @@ need to be connected to the NPS intranet. Javadoc location is configured under <i>Tools > Java Platform > select platform (JDK 1.8)</i> subtab </p> </li> + <li> + For backwards-compatible <code>jaxb</code> support on + <code style="color:darkgreen"><b>netbeans.conf</b></code> in Netbeans 11, append: + <br /> + <b><code>netbeans_default_options</code></b>="<b><code>-J-Djavax.xml.bind.context.factory=com.sun.xml.bind.v2.ContextFactory</code></b>" + </li> <li> If upgrading Java without re-installing Netbeans, you may need to <a href="http://stackoverflow.com/questions/2809366/changing-the-version-on-which-netbeans-runs">modify Netbeans version of Java platform</a> @@ -1409,6 +1431,9 @@ need to be connected to the NPS intranet. <br /> <code style="color:darkgreen"><b>C:\Program Files\NetBeans_11.0\etc\netbeans.conf</b></code> (default user settings) <br /> + or, noting hyphen, + <code style="color:darkgreen"><b>C:\Program Files\NetBeans-11.1\etc\netbeans.conf</b></code> (default user settings) + <br /> or, for older versions of Netbeans, <br /> <code style="color:darkgreen"><b>C:\Program Files\NetBeans 8.2\etc\netbeans.conf</b></code> (default user settings) @@ -1421,12 +1446,7 @@ need to be connected to the NPS intranet. <b><code>netbeans_default_options</code></b>="<b><code>-J-server</code> <code>-J-Xmx2g</code> <code>-J-XX:PermSize=32m</code></b>" <br /> (for details, see <a href="http://wiki.netbeans.org/FaqSettingHeapSize">Netbeans FaqSettingHeapSize</a>) - <br /> - For backwards-compatible <code>jaxb</code> support on - <code style="color:darkgreen"><b>netbeans.conf</b></code> in Netbeans 11, also append: - <br /> - <b><code>netbeans_default_options</code></b>="<b><code>-J-Djavax.xml.bind.context.factory=com.sun.xml.bind.v2.ContextFactory</code></b>" - </li> + </li> <li> <a href="http://plugins.netbeans.org/PluginPortal">NetBeans Plugin Portal</a> has many useful additions for Netbeans @@ -1505,6 +1525,12 @@ netbeans_jdkhome="C:\Program Files\Java\jdk1.8.0_192"</pre> <code style="color:darkgreen"><b>%USERPROFILE%\<AppData>\<i>Roaming</i>\NetBeans\8.2\config\Services\Platforms\org-netbeans-api-java-Platform\JDK_1.8.xml</b></code> </p> </li> + <ul> + <li> + Alternative Netbeans version used in current development is + <code style="color:darkgreen"><b>NetBeans-11.1</b></code> + </li> + </ul> <li> Errors and exceptions are recorded in <br /> @@ -2670,7 +2696,7 @@ which can lead to the Internet of Things becoming the Web of Things. </i> <a href="https://savage.nps.edu/developers.html">https://savage.nps.edu/developers.html</a> </blockquote> <blockquote> - Revised 31 July 2019. + Revised 17 August 2019. </blockquote> <p>