Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

packname

The name of the pack that this one depends on

<os> - OS Restrictions

It is possible to restrict a pack to a certain list of operating systems. This tag takes the following attributes:

family

unix, windows or mac

name

the exact OS name (ie Windows, Linux, ...)

version

the exact OS version (see the JVM os.version property)

arch

the machine architecture (see the JVM os.arch property)

<updatecheck> - Cleaning Up After Updates

...

Attribute

Description

Required

Values
(Default)

targetfile

the file to parse, could be something like $INSTALL_PATH/bin/launch-script.sh A slash will be changed to the system dependant path separator (e.g. to a backslash on Windows) only if no backslash masks the slash.

yes

 

type

Specifies the text file type.

no

"plain" | "javaprop" (Properties) | "xml" | "java" | "shell" | "at" | "ant" (Ant buildfile)
("plain")

encoding

The file encoding

no

A valid Java encoding string
("ISO-8859-1" for type="javaprop",
"UTF-8" for type="xml", otherwise the Java default charset is assumed as encoding)

os

Limits this action on a particular OS, works like for <file>

no

 

condition

Limits this action on a particular condition with the specified ID which has to be fulfilled

no

 

Nested Elements

    ...

    • <os> - restrict parsing depending on the target operating system, see the OS Restriction element
    <executable> - mark file as executable and optionally execute it

    ...

    Attribute

    Description

    Required

    Values
    (Default)

    targetfile

    the file to run, could be something like $INSTALL_PATH/bin/launch-script.sh Slashes are handled special (see attribute targetfile of tag <parsable>).

    yes

    A previously added pack file path

    type

    bin or jar (the default is bin)

    no

    "bin" | "jar"
    ("bin")

    class

    If the executable is a jar file, this is the class to run for a Java program

    no

    A valid Java class within the jar file

    stage

    Specifies at which stage when to launch the executable:

    • never
      will never launch it (useful to set the +x flag on Unix)
    • postinstall
      just after the installation is done
    • uninstall
      when the application is uninstalled. The executable is executed before any files are deleted.

    no

    "never" | "postinstall" | "uninstall"
    ("never")

    failure

    specifies what to do when an error occurs:

    • ask (default) will ask the user what to do
    • abort will abort the installation process
    • warn will just tell the user that something is wrong
    • ignore don't tell the user, just continue

    no

    "ask" | "abort" | "warn" | "ignore"
    ("ask")

    os

    specifies the operating system, works like for <file>

    no


    keep

    Whether the file will be kept after execution

    no

    "true" | "false"
    ("false")

    condition

    ID of a condition which has to be fulfilled to execute this file

    no

    A valid condition ID

    Nested Elements

    ...

    • <os> - restrict parsing depending on the target operating system, see the OS Restriction element
    • <args>
      Pass one or more arguments with nested <arg> tags  (one <arg> tag per argument) to the executable

    ...


    • Attributes: value - the argument value
      Example:
      <args><arg value="-version"/></args>
      Slashes are handled special (see attribute targetfile of tag <parsable>.

    ...

    The nested <os> element is supported.

    ...

    <os> - make a file OS-dependent

    The <os> tag can be used inside the <file>, <fileset>, <singlefile>, <parsable>, <executable> tags to restrict it's effect to a specific operating system family, architecture or version using the following attributes:

    ...

    Attribute

    ...

    Description

    ...

    family

    ...

    unix, windows, mac to specify the operating system family

    ...

    name

    ...

    the operating system name

    ...

    version

    ...

    the operating system version

    ...

    arch

    ...

    Example

    Code Block
    xml
    xml
    <packs>
    (...)
        <pack name="Core" required="yes">
        (...)
            <executable targetfile="$INSTALL_PATH/bin/compile" stage="never">
                <os family="unix"/>
            </executable>
        (...)
        </pack>
    (...)
    </packs>
    

    ...