Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added runAsAdministrator attribute

...

Note

This tag is for testing purposes only. Be sure to remove this tag before preparing your installer for production.

lateShortcutInstall

Warning

This option is available from version 5.0.0-beta11, which is not yet released.

The <lateShortcutInstall/> tag has no attributes or content.  Delays the creation of shortcuts until after all packs have been installed (instead of creating shortcuts as soon as 'Next' is clicked). Specify this if you want to show ShortcutPanel before InstallPanel.

...

AttributeDescriptionRequired
type

Specifies the type of shortcut. Valid values are:

  • application
    Creates a shortcut to start any application (native, Java, or shell-script). The GUI-System will launch this Application through its native shell or application launcher. In this case, note that the right workingDirectory is always important on Unix platforms. If the user's PATH environment variable does not contain the application path, this application will not run unless workingDirectory specifies the application path. The "current path" placeholder (i.e. '.') must exist on the PATH, as is the case by default on most systems. Consult the Unix manuals for more details.
  • link
    Creates a shortcut to open a URL in the user's default web browser. In this case, the url attribute must be set.
Yes
urlSpecifies a locally installed HTML file, other file with a known MIME type (e.g. plain text), or a WWW URL (e.g. http://izpack.org/). This value is translated through the variable substitutor, so variables such as $INSTALL_PATH (for local documents) can be used.Yes, if type=link
mimetype

Specifies the MIME type for links pointing to local files when using type=link.

No; recommended if type=link and url points to a local file.
encodingThis should always set to UTF-8.Yes
terminalSet to true to allow the user to see the console output of a program (e.g. in Java applications "System.out").No; defaults to false.
terminalOptions

Specifies attributes for terminal windows when terminal=true (see man pages for setterm).

No
KdeSubstUIDThis is the sudo option for a shortcut. If set to true, you will be asked for the password of the KdeUsername.

No; defaults to false

KdeUsernameThe username with correct sudo permissions where KdeSubstUID is true. This is root in most cases.No; defaults to root.
createForAllIf a user with administrative rights, such as root, performs the installation, set to true to make this shortcut appear to other users as well as root.No; defaults to false.
categories

The category in the Desktop Application Menu where the shortcut will be placed. Here are some sample categories and their apps. For more examples, examine the desktop files in /usr/share/applications in the target environment.

  • Categories="Application;Network;WebDevelopment;" - Nvu
  • Categories="Qt;Development;GUIDesigner;" - QtDesigner3
  • Categories="Application;System;" - VMwareServer-console
  • Categories="Network;WebBrowser;" - Opera
  • Categories="Development;Debugger;" - DDD debugger
  • Categories="Development;IDE;" - Eclipse IDE
  • Categories="SystemSetup;X-SuSE-Core-System;" - Yast2
  • Categories="System;Archiving;" - Sesam archiving
  • Categories="System;Database;" - MySQL Administrator
No; no default.
tryexecSpecifies a command to pass through 'raw' to the operating system.No; default is to use target and (where present) commandLine

Windows-specific attributes

These attributes apply only to Windows-based systems.

AttributeDescriptionRequired
runAsAdministrator

Determines if the target of the shortcut should be run with administrator privileges

Warning

The runAsAdministrator flag will be available in 5.0.0-rc1

 

 

No; defaults to false.

 

createForPack

This is an optional nested element, with one required attribute, name, specifying the name of a pack that must be selected for this shortcut to be created. Multiple <createForPack> elements can be nested in the same <shortcut>.

...