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 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.

Example

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

...

Code Block
languagehtml/xml
titleHow to include native DLLs for ShortcutPanel
<natives>
    <native type="izpack" name="ShellLink.dll"/>
    <native type="izpack" name="ShellLink_x64.dll"/>
</natives>
Both 32-bit and 64-bit versions are built-in to IzPack.