New Prerequisite Option

Command Syntax

/NewPrerequisite <display_name>
                 -prereq_type {FileBased|UrlBased|OpenSite}
                 -prereq_path <prereq_path>
                 [-cmd_line <cmd_line>]
                 [-extract_folder <extract_folder>]
                 [-64bit]
                 [-lzma_compression]
                 [-size <prereq_file_size>]
                 [-md5 <prereq_file_md5>]
                 [-target_os {Win9x|WinNT|Win64}]
                 [-force_install]
                 -search_type {FileVersion|RegSubKeyEnum|RegValue}
                 -search_path <search_path>
                 [-search_depth <search_depth>]
                 [-minversion <minimum_version>]
                 [-maxversion <maximum_version>]
                 [-aditionalfiles <aditional_files>]
                 [-builds <builds_list>]
                 [-package]

This command will add a new prerequisite for your package. Its equivalent UI option is the [ New... ] button from Prerequisites page.

Parameters:

• <display_name>
• The name of the prerequisite. This string will be visible to the user.
• -prereq_type {FileBased|UrlBased|OpenSite}
• Specifies the location of the prerequisite setup file.
• -prereq_path <prereq_path>
• The exact path or URL to the prerequisite setup file.
• [-cmd_line <cmd_line>]
• An optional command line for launching the prerequisite. This parameter cannot be used with "OpenSite" option.
• [-extract_folder <extract_folder>]
• The location where the prerequisite files will be extracted or downloaded. This parameter cannot be used with "OpenSite" option.
• [-64bit]
• Specifies whether your prerequisite is a 64-bit version.
• [-lzma_compresion]
• Specify LZMA Compression for your prerequisites files. To use this option your prerequisite files must be included in the EXE bootstrapper. This parameter can be used only with "FileBased" option.
• [-size <prereq_file_size>]
• The exact size of the prerequisite setup file. This parameter can be used only with "UrlBased" option.
• [-md5 <prereq_file_md5>]
• This field contains the MD5 "fingerprint" of the prerequisite file. This parameter can be used only with "UrlBased" option.
• [-target_os {Win9x|WinNT|Win64}]
• Specifies which Operating System is required for this prerequisite to run. Don't specify this parameter if the prerequisite is for all type of OS.
• [-force_install]
• If this is set the product install operation will not start until the prerequisite is installed.
• -search_type {FileVersion|RegSubKeyEnum|RegValue}
• A value specifying how to obtain the installed prerequisite's version.
• -search_path <search_path>
• Path to a file or registry value from where to get the prerequisite version.
• [-search_depth <search_depth>]
• How deep to search for a file in the subdirectories. This parameter can be used only with "FileVersion" option.
• [-minversion <minimum_version>]
• The minimum version necessary for the installed prerequisite to be accepted.
• [-maxversion <maximum_version>]
• The minimum version necessary for the installed prerequisite to be accepted.
• [-aditionalfiles <aditional_files>]
• A list with additional files for your prerequisite. The files are separated by "|". If you have more than one file include this parameter into quotes. Those files need to by placed next to the file specified in the prereq_path parameter. This parameter can be used only with "FileBased" option.
• [-builds <builds_list>]
• A list of builds to which this prerequisite should be added. If no build is specified, the prerequisite will be added to all the defined builds.
• [-package]
• If this option is enabled, the prerequisite will be set as global.

Example:

AdvancedInstaller.com /edit MyProject.aip 
    /NewPrerequisite DirectX -prereq_type FileBased
    -prereq_path C:\Setup.exe -search_type RegValue 
    -search_path HKLM\Software\Microsoft\DirectX\Version
    -minversion 9.0 -aditionalfiles "file.txt|file1.txt"
    -package

Adding multiple searches for a prerequisite

You can add multiple searches to a prerequisite by using the "/NewPrerequisite" command multiple times and changing the "-search_type" or "-search_path".

Example - adding the first search:

AdvancedInstaller.com /edit MyProject.aip 
    /NewPrerequisite DirectX -prereq_type FileBased
    -prereq_path C:\Setup.exe -search_type RegValue 
    -search_path HKLM\Software\Microsoft\DirectX\Version
    -minversion 9.0 -aditionalfiles "file.txt|file1.txt"
    -package

Example - adding the second search:

AdvancedInstaller.com /edit MyProject.aip 
    /NewPrerequisite DirectX -prereq_type FileBased
    -prereq_path C:\Setup.exe -search_type FileVersion 
    -search_path HKLM\Software\Microsoft\DirectX\Version
    -minversion 9.0 -aditionalfiles "file.txt|file1.txt"
    -package