3.6.0 to 3.7.0
No special instructions are necessary to upgrade to v3.7.0. A few important changes are noted below for awareness.
An existing issue has been identified when building mission models with certain annotations, including @Unit (and now @Description). In some cases, the build process will incorrectly produce a .jar file with missing or outdated annotations. To avoid this issue, we currently recommend users run ./gradlew clean assemble when building, to clear the build cache and ensure a correct jar. This will clean your local build cache and prevent any issues. We will work to characterize and fix this known issue in a subsequent release.
DB Migrations
Multiple DB migrations were added in this release. If you are upgrading from a past version and want to preserve your data, follow the instructions in the
Database Migrations Guide to apply migrations after upgrading. Make sure you are using the latest version of the migration script from the Deployment.zip.
Descriptions for Activities, Parameters and Resource Types
This release adds support for annotating the Activities, Activity Parameters and Resources in your mission model with user-readable descriptions. For Activities and Parameters, you can precede their declaration with an annotation like @Description("My description"), and for resources you can pass an additional description argument to the registrar. See BakeBananaBreadActivity.java and Mission.java in the example model for examples.
These descriptions will be visible in the UI, and stored in the Aerie database (in the metadata column for parameters/resources, and in a new column called description for activities) for retrieval via the API.