From f95a1165a9a323cfc15877730c75e10aaac4943b Mon Sep 17 00:00:00 2001 From: markpet49 Date: Wed, 25 May 2022 15:18:54 -0500 Subject: [PATCH 1/2] Bump version number and update release docs --- README.md | 14 +++-- RELEASE_NOTES.txt | 26 ++++++++ nbproject/build-impl.xml | 92 +++++++++++++++++++---------- nbproject/genfiles.properties | 10 ++-- nbproject/project.properties | 2 +- nbproject/project.xml | 1 + release-build.xml | 20 ------- src/gov/nasa/worldwind/Version.java | 2 +- 8 files changed, 104 insertions(+), 63 deletions(-) create mode 100644 RELEASE_NOTES.txt diff --git a/README.md b/README.md index 9907a499c4..c7918fcaec 100755 --- a/README.md +++ b/README.md @@ -2,9 +2,11 @@ # WorldWind Java -## New versions of WorldWind released -Web WorldWind 0.10.0 and WorldWind Java 2.2.0 are now available on GitHub. The new version of Web WorldWind addresses potential vulnerabilities in the code and underlying packages. The new version of WorldWind Java focuses on upgrading to Java 11 and JOGL 2.4 as well as a switch to Apache 2.0 license. WorldWind's API remains largely unchanged in this release and we are committed to maintaining a consistent API in future releases. -More information on the release can be found at these links: [Web WorldWind 0.10.0](https://github.com/NASAWorldWind/WebWorldWind/releases) and [WorldWind Java 2.2.0](https://github.com/NASAWorldWind/WorldWindJava/releases). +## New version of WorldWind Java released +WorldWind Java 2.2.1 is now available on GitHub. This version of WorldWind Java is a housekeeping release that addresses small fixes (typos, bad references, etc.) to various areas of the code and removes references to services that are no longer supported by the WorldWind servers. + +WorldWind's API remains unchanged in this release and we are committed to maintaining a consistent API in future releases. +More information on the release can be found at this link: [WorldWind Java 2.2.1](https://github.com/NASAWorldWind/WorldWindJava/releases). Please direct questions to our new email address: arc-worldwind@mail.nasa.gov. @@ -25,7 +27,11 @@ Official WorldWind Java releases have the latest stable features, enhancements a ## Run a Demo -With the deprecation of WebStart/JNLP, the only option for running a Java demo is to clone the SDK, open it with Apache Netbeans and run it via the Netbeans interface. +The following options are available to run a WorldWind Java demo: + +###### From the Apache NetBeans IDE + +Clone the SDK with git, open the WorldWind Java project with Apache Netbeans and run demos via the Netbeans interface. ###### From a Windows Development Environment diff --git a/RELEASE_NOTES.txt b/RELEASE_NOTES.txt new file mode 100644 index 0000000000..c92a05cca0 --- /dev/null +++ b/RELEASE_NOTES.txt @@ -0,0 +1,26 @@ +################### WorldWindJava 2.2.1 + +This version of WorldWind Java is a maintenance release that addresses small fixes (updated formatting, typos, bad references, etc.) to various areas of the code and removes references to services that are no longer supported by the WorldWind servers. + +WorldWind's API remains unchanged in this release and we are committed to maintaining a consistent API in future releases. + +################### WorldWindJava 2.2.0 + +The primary goal of the WorldWind Java (WWJ) v2.2.0 release is to modernize the SDK after a period of inactivity. During this process some defects were addressed as well. Highlights of v2.2.0: + +- Upgrade to Java 11 +- Upgrade to the OpenGL layer (JOGL) 2.4 +- Switch to the Apache 2.0 license +- Deprecation of unsupported functionality such as Applets, WebStart and WebView. + +WorldWind's API remains largely unchanged in this release and we are committed to maintaining a consistent API in future releases. + +The prior release of WorldWind Java, v2.1.0, was compiled with Java 8. The decision was made to upgrade WWJ to Java 11 based on questionable support options for Java 8 at the time. This situation has evolved over time and we are evaluating whether a Java 8 version of WWJ is desirable. Your feedback is welcome. + +Migrating to Java 11 and JOGL 2.4 went relatively smoothly. Primary areas of work: + +- The package names for JOGL have changed although the API remains relatively consistent. +- Creating work alike code to replace the use of unpublished JRE APIs that now throw an access exception. For example, setting the java library path system property. Discussions around the types of changes that need to be made when moving from 8 to 11 are broadly available on the Web. +- Removing deprecated functionality like WebStart, Applets and WebView. + +This release positions WorldWind Java to begin adding new functionality in the near future, please watch this repository for further updates. diff --git a/nbproject/build-impl.xml b/nbproject/build-impl.xml index 2e5268b58c..506f468c86 100644 --- a/nbproject/build-impl.xml +++ b/nbproject/build-impl.xml @@ -46,8 +46,8 @@ is divided into following sections: - - + + @@ -119,7 +119,43 @@ is divided into following sections: - + + + + + + + + + + + + + + + + + + + + + + + + + + Must set platform.home + Must set platform.bootcp + Must set platform.java + Must set platform.javac + + The J2SE Platform is not correctly set up. + Your active platform is: ${platform.active}, but the corresponding property "platforms.${platform.active}.home" is not found in the project's properties files. + Either open the project in the IDE and setup the Platform with the same name or add it manually. + For example like this: + ant -Duser.properties.file=<path_to_property_file> jar (where you put the property "platforms.${platform.active}.home" in a .properties file) + or ant -Dplatforms.${platform.active}.home=<path_to_JDK_home> jar (where no properties file is used) + @@ -242,20 +278,6 @@ is divided into following sections: - - - - - - - - - - - - - - @@ -343,7 +365,7 @@ is divided into following sections: - + @@ -394,7 +416,7 @@ is divided into following sections: - + @@ -436,7 +458,7 @@ is divided into following sections: - + @@ -515,7 +537,7 @@ is divided into following sections: - + @@ -543,7 +565,7 @@ is divided into following sections: - + @@ -619,7 +641,7 @@ is divided into following sections: - + @@ -850,6 +872,9 @@ is divided into following sections: + + + @@ -899,7 +924,7 @@ is divided into following sections: - + @@ -933,7 +958,7 @@ is divided into following sections: - + @@ -965,7 +990,7 @@ is divided into following sections: - + @@ -1199,7 +1224,7 @@ is divided into following sections: To run this application from the command line without Ant, try: - java -jar "${dist.jar.resolved}" + ${platform.java} -jar "${dist.jar.resolved}" @@ -1301,8 +1326,8 @@ is divided into following sections: - - + + @@ -1495,16 +1520,19 @@ is divided into following sections: + + + - + - + - + diff --git a/nbproject/genfiles.properties b/nbproject/genfiles.properties index 80786b06c2..6a15e776fa 100644 --- a/nbproject/genfiles.properties +++ b/nbproject/genfiles.properties @@ -1,8 +1,8 @@ -build.xml.data.CRC32=6106e3d1 +build.xml.data.CRC32=ed839dc9 build.xml.script.CRC32=b2ee8dee -build.xml.stylesheet.CRC32=f85dc8f2@1.95.0.48 +build.xml.stylesheet.CRC32=f85dc8f2@1.102.0.48 # This file is used by a NetBeans-based IDE to track changes in generated files such as build-impl.xml. # Do not edit this file. You may delete it but then the IDE will never regenerate such files for you. -nbproject/build-impl.xml.data.CRC32=6106e3d1 -nbproject/build-impl.xml.script.CRC32=8e6690c6 -nbproject/build-impl.xml.stylesheet.CRC32=d549e5cc@1.97.0.48 +nbproject/build-impl.xml.data.CRC32=ed839dc9 +nbproject/build-impl.xml.script.CRC32=2e7bce4f +nbproject/build-impl.xml.stylesheet.CRC32=12e0a6c2@1.102.0.48 diff --git a/nbproject/project.properties b/nbproject/project.properties index fab181db51..1adab5d73f 100644 --- a/nbproject/project.properties +++ b/nbproject/project.properties @@ -104,7 +104,7 @@ manifest.custom.permissions= manifest.file=manifest.mf meta.inf.dir=${src.dir}/META-INF mkdist.disabled=false -platform.active=default_platform +platform.active=JDK_11 run.classpath=\ ${javac.classpath}:\ ${build.classes.dir} diff --git a/nbproject/project.xml b/nbproject/project.xml index e27d90a9ba..cba6c32199 100644 --- a/nbproject/project.xml +++ b/nbproject/project.xml @@ -4,6 +4,7 @@ WorldWindJava + diff --git a/release-build.xml b/release-build.xml index 8877973d0e..9810ad732d 100644 --- a/release-build.xml +++ b/release-build.xml @@ -381,24 +381,4 @@ - - - - - - - - - - - - - diff --git a/src/gov/nasa/worldwind/Version.java b/src/gov/nasa/worldwind/Version.java index 9a1a4e7bd0..7fc7e9cb24 100644 --- a/src/gov/nasa/worldwind/Version.java +++ b/src/gov/nasa/worldwind/Version.java @@ -35,7 +35,7 @@ public class Version { private static final String MAJOR_VALUE = "2"; private static final String MINOR_VALUE = "2"; - private static final String DOT_VALUE = "0"; + private static final String DOT_VALUE = "1"; private static final String versionNumber = "v" + MAJOR_VALUE + "." + MINOR_VALUE + "." + DOT_VALUE; private static final String versionName = "NASA WorldWind Java"; From 2b0dbc71059fbd902dc945a2484695b03af67e91 Mon Sep 17 00:00:00 2001 From: markpet49 Date: Wed, 25 May 2022 15:21:30 -0500 Subject: [PATCH 2/2] Rewording in README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c7918fcaec..fe13b4b70d 100755 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ # WorldWind Java ## New version of WorldWind Java released -WorldWind Java 2.2.1 is now available on GitHub. This version of WorldWind Java is a housekeeping release that addresses small fixes (typos, bad references, etc.) to various areas of the code and removes references to services that are no longer supported by the WorldWind servers. +WorldWind Java 2.2.1 is now available on GitHub. This version of WorldWind Java is a maintenance release that addresses small fixes (typos, bad references, etc.) to various areas of the code and removes references to services that are no longer supported by the WorldWind servers. WorldWind's API remains unchanged in this release and we are committed to maintaining a consistent API in future releases. More information on the release can be found at this link: [WorldWind Java 2.2.1](https://github.com/NASAWorldWind/WorldWindJava/releases).