Embedded SIS

An embedded SIS file is a file that is embedded in another SIS files. A SIS file can contain multiple embedded SIS files.

Syntax

To include a SIS file within another SIS file, the PKG file must specify the name and location of the embedded install files along with their package UID, prefixed with the @ symbol.

@"source-filename", (package-uid)

For example:

IF NOT package(0xE8000097)
; install minimal.sis only if not already installed
@"minimal.sis", (0xE8000097)
endif

During installation, minimal.sis is extracted and installed, unless it has already been installed.

The package() function must be used only if you have to install an embedded package if it has not already been installed. For more information on Embedded SIS files see, Embedded SIS Files.

Language-specific embedded SIS files can be included in a language block, as shown in the following example:

{
@"foo_en.sis"
@"foo_fr.sis"
@"foo_ge.sis"
},(0x11223344)

Example

  • Example to illustrate an embedded SIS file within the parent SIS file

    ; A SIS file which embeds another
    
    ;Languages
    &EN,GE
    
    ;Header
    #{"Embedding-EN", "Embedding-GE"}, (0x10000017), 1, 2, 3
    
    %{"Vendor", "Verkaufer"}
    :"Vendor"
    
    ;Embedded component
    IF NOT package(0x80000002)
    @"sub.sis",(0x80000002)
    endif
    
    ;Ordinary file to system drive
    {
    "text\englishfile.txt"
    "text\germanfile.txt"
    }-"$:\private\10000018\import\lang.txt"
    
    ;Ordinary file to selected drive
    "text\file1.txt"-"!:\private\10000018\import\file1.txt"
    
    ;Display a text file
    "text\textfilec.txt"-"", FT, TC
  • Example to illustrate the format of the SIS file that needs to be embedded into another file

    ; A SIS file which is embedded in another
    
    ;Languages
    &EN,GE
    
    ;Header
    #{"Sub-EN", "Sub-GE"}, (0x80000002), 1, 2, 3
    
    %{"Vendor", "Verkaufer"}
    :"Vendor"
    
    ;Ordinary file to fixed drive
    {
    "text\englishfile.txt"
    "text\germanfile.txt"
    }-"C:\private\80000003\import\InstTest\sub-lang.txt"
    
    ;Ordinary file to selected drive
    "text\file1.txt"-"!:\private\80000003\import\InstTest\sub-file1.txt", FF
    
    ;Display a text file
    "text\textfilesc.txt"-"", FT, TC