Versions Compared

Key

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

...

Attribute to
<native>
ValuesRequiredDescription
type

izpack | 3rdparty

(default: izpack

yes

Specifies the type of the native library:

  • izpack - The library's source code is part of the IzPack project.
  • 3rdparty - The library's source is from another project or there is no source code available.
nameAny resource file name.yes

The file name of the resource to be added.

There must be a file name for each processor architecture, 32 and 64 bit. The 64 bit libraries must have the suffix _64 in its base name.

src

Any valid resource path.

(default: com/izforge/izpack/bin/native/<type>/<name>) 

no

Root path of the native resource. This is used for finding the resource to add. The destination path is always com/izforge/izpack/bin/native/<type>/<name>.

In case src is set to a value the source path to get the native library from is assembled from the attribute values described here like this: <src>/<type>/<name>.

Native resources needed for a couple of IzPack components:

  • ShellLink.dll (type: izpack)

  • ShellLink_x64.dll (type: izpack)

  • WinSetupAPI.dll (type: izpack)

  • WinSetupAPI_x64.dll (type: izpack)

  • COIOSHelper.dll (type: 3rdparty)

  • COIOSHelper_x64.dll (type: (type: 3rdparty))

don't need this attribute to be set, the default path is the correct one here.

stage

install | both | uninstall

(default: install)

no

Specifies whether the native library should be packed into the installer, uninstaller or both:

  • install - Pack the library to the installer only
  • both - Pack the library to both, the installer and uninstaller
  • uninstall - Pack the library to the uninstaller only

Example

For using the Shortcut Panel on Windows there are required the ShellLink native libraries to access some native APIs:

...