Summary

This change will allow 3 additional properties in an add-launcher property file to be recognized by jpackage to control shortcuts to the additional launchers: The three properties linux-shortcut, win-shortcut, and win-menu can be set to "false" to prevent the creation of shortcuts for the given additional launcher.

Problem

If directed to create shortcuts for a main application, jpackage will also create shortcuts for all additional launchers. Applications want the flexibility of controlling which launchers get shortcuts installed on installation.

Solution

Add the three properties, corresponding to the three CLI options that control shortcuts, to the properties recognized in a add-launcher properties file.

Specification

The help text (and man pages) for the "--add-launcher" cli option will be changed from:

  --add-launcher <launcher name>=<file path>
          Name of launcher, and a path to a Properties file that contains
          a list of key, value pairs
          (absolute path or relative to the current directory)
          The keys "module", "main-jar", "main-class",
          "arguments", "java-options", "app-version", "icon",
          "win-console", and "linux-app-category" can be used.
          These options are added to, or used to overwrite, the original
          command line options to build an additional alternative launcher.
          The main application launcher will be built from the command line
          options. Additional alternative launchers can be built using
          this option, and this option can be used multiple times to
          build multiple additional launchers.

to:

  --add-launcher <launcher name>=<file path>
          Name of launcher, and a path to a Properties file that contains
          a list of key, value pairs
          (absolute path or relative to the current directory)
          The keys "module", "main-jar", "main-class",
          "arguments", "java-options", "app-version", "icon",
          "win-console", "win-shortcut", "win-menu",
          "linux-app-category", and "linux-shortcut" can be used.
          These options are added to, or used to overwrite, the original
          command line options to build an additional alternative launcher.
          The main application launcher will be built from the command line
          options. Additional alternative launchers can be built using
          this option, and this option can be used multiple times to
          build multiple additional launchers.