Summary

Extend UI of Windows installers created by jpackage to allow users control installation of shortcuts.

Problem

Windows installers created by jpackage can install start menu and/or desktop shortcuts for every application launcher in application image. This behavior is controlled by "--win-shortcut" and "--win-menu" CLI options. If "--win-shortcut" is specified Windows installers will be configured to create desktop shortcuts. If "--win-menu" is specified Windows installers will be configured to create start menu shortcuts.

There is no way at installation time to disable creation of shortcuts. However this is common feature for Windows installers because not all users need shortcuts as they are optional and are only for convenience.

Solution

Add new dialog (shortcut prompt dialog) to UI sequence of Windows installers with checkbox controls to allow user choose what shortcuts installer should create.

New CLI option "--win-shortcut-prompt" will control contents of shortcut prompt dialog.

Specification

Add "--win-shortcut-prompt" CLI option. If the option is set, "Shortcut prompt" dialog will be a part of UI installation sequence.

"Shortcut prompt" dialog will have at most two checkbox controls. No other controls must be placed on this dialog.

Checkbox control labeled "Create desktop shortcuts" will be added to the dialog if "--win-shortcut" CLI option is specified.

Checkbox control labeled "Create start menu shortcuts" will be added to the dialog if "--win-menu" CLI option is specified.

If none of "--win-shortcut" or "--win-menu" CLI options are specified, then the dialog will not be a part of installation UI sequence and "--win-shortcut-prompt" CLI option will be silently ignored by jpackage.

All Checkbox controls on "Shortcut prompt" dialog must be checked by default.

Group of shortcuts will be created by installer if corresponding checkbox control is checked.

The new UI installation sequence will be:

1. "Welcome" dialog (if at least one of "--license-file", "--win-dir-chooser", "--win-shortcut-prompt" CLI options specified)
2. "License" dialog (if "--license-file" CLI option specified)
3. "Choose installation directory" dialog (if "--win-dir-chooser" CLI option specified)
4. "Shortcut prompt" dialog (if "--win-shortcut-prompt" CLI option specified)

Help text for "--win-shortcut-prompt" CLI option will be:

Adds a dialog to enable the user to choose if shortcuts 
will be created by installer

Help text for "--win-menu" CLI option will be changed from

Adds the application to the system menu

to

Request to add a Start menu shortcut for this application

Help text for "--win-shortcut" CLI option will be changed from

Creates a desktop shortcut for the application

to

Request to add desktop shortcut for this application