[Setup]
这个段包含用于安装程序和卸载程序的全局设置
AppId:在注册表中唯一的项名称,安装完64位系统在
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{AppId}_is1
反之在以下路径中
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{AppId}_is1
该项里面的内容包括如下内容
如果不定义AppId,则其安装完之后,在注册表中默认以{AppName}_is1的名字存在
AppName:用以指定你正在安装的应用程序的标题,AppName 始终在安装过程中显示在安装屏幕的左上角以及安装向导中
AppVersion:应用程序版本号
AppVerName:在控制面板中显示的名称
AppPublisher:在控制面板中显示的发布者
DefaultDirName:用于选择目标位置向导面中的默认目录名
DisableProgramGroupPage:
OutputDir:用于打包完程序的输出位置
OutputBaseFilename:打包完程序显示的默认名
Compression:指定要在文件中使用的压缩方法,以及压缩标准
SolidCompression: 如果设为 yes,固实压缩将启用。这会使所有文件一次性压缩
[registry]
本段是对注册表的操作
示例如下:
Root:HKLM;Subkey:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{#AppId};ValueType: string; ValueName:DisplayName; ValueData:{#MyAppServiceName}; Flags: uninsdeletevalue
另外可以http://379910987.blog.163.com/blog/static/3352379720110259414788/该网址下,有关于注册表的参数说明
[Languages]
本段是安装程序默认语言
Name:
"english"; MessagesFile: "compiler:Default.isl"
Name:语言为英文;由于InnoSetup安装包中默认没有带中文语言文件,所以如果需要将它变成中文,则先要下载一个中文语言文件,并把它放到InnoSetup安装目录中的Languages子目录中
MessageFile:则指定了语言文件路径
[Tasks]
这个段是只选的。它定义安装程序在执行安装期间所有由用户定制的任务。这些任务以选项框和单选项形式在附加任务向导页中出现
Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked(不选中)/ checkedonce(默认选中)
[Files]
定义安装程序安装文件到用户系统中的可选文件段
Source: "E:\Softwares\Inno Setup\SourceFile\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
Source:需要打包进去的源文件
DestDir:默认是{app}
Flags: "recursesubdirs" 和 "createallsubdirs",意思是包含文件夹里的所有文件和子文件夹,
注意: 不要在任何共享系统文件上使用“Flags: ignoreversion”,意为不比较版本信息
[Icons]
这个可选段定义所有创建在开始菜单和/或其它位置 (比如桌面) 的快捷方式
Name: "{commonprograms}\{#MyAppName}"; Filename: "{app}\{#MyAppClientName}"
Name: "{commondesktop}\{#MyAppName}"; Filename: "{app}\{#MyAppClientName}"; Tasks: desktopicon;IconFilename:"{app}\eas.ico"
FileName:程序的路径
Name:开始菜单/桌面快捷方式的名称
Tasks:任务(desktopicon:桌面图标)
IconFilename:图标位置
[Run]
Filename: "{app}\installService.bat"; Description: "描述内容";Flags:runhidden
Filename:安装文件
Description: 这是条目的描述,可以包含常量,如果没有指明,将会使用默认的描述
Flags:
这个参数是额外选项设置。多个选项可以使用空格隔开。支持下面的选项:
选项 |
说明 |
hidewizard |
如果指定了这个标记,向导将在程序运行期间隐藏 |
nowait |
如果指定了这个标记,它将在处理下一个[Run] 条目前或完成安装前不等待进程执行完成,不能与waituntilidle或waituntilterminated 组合使用 |
postinstall |
仅在[Run] 段有效。告诉安装程序在安装完成向导页创建一个选择框,用户可以选中或不选中这个选择框从而决定是否处理这个条目。以前这个标记调用showcheckbox。如果安装程序已经重新启动了用户的电脑 (安装了一个带restartreplace标记的文件或如果[Setup] 段的AlwaysRestart指示是yes 引起的),选择框没有机会出现,因此这些条目不会被处理。 |
runhidden |
如果指定了这个标记,它将在隐藏窗口中运行程序。 |
runmaximized |
如果指定了这个标记,将在最大化窗口运行程序或文档 |
runminimized |
如果指定了这个标记,将在最小化窗口运行程序或文档。 |
shellexec |
如果Filename 不是一个直接可执行文件(.exe或.com 文件),这个标记是必需的。当设置这个标记时,Filename可以是一个文件夹或任何已注册的文件类型,当使用shellexec标记时,将不等待,直到生成的进程终止,如果确实需要,则必须添加标记waituntilterminated |
skipifdoesntexist |
如果这个标记在[Run] 段中指定,如果文件名不存在,安装程序不显示错误消息;如果这个标记在[UninstallRun]段中指定,如果文件名不存在,卸载程序不显示“一些元素不能删除”的警告 |
skipifnotsilent |
仅在[Run] 段有效。告诉安装程序如果安装程序未在后台运行则跳过这个条目 |
skipifsilent |
告诉安装程序如果安装程序在后台运行则跳过这个条目 |
unchecked |
告诉安装程序初始为不选中选择框。如果用户希望处理这个条目,可以通过选取选择框执行,如果postinstall标记未同时指定,这个标记被忽略 |
waituntilidle |
如果指定了这个标记,它将在未输入期间等待,直到进程等待用户输入,而不是等待进程终止。(调用WaitForInputIdle Win32函数。) 不能与nowait或waituntilterminted 组合使用 |
waituntilterminated |
如果指定这个标记,将等待到进程完全终止。注意这是一个默认动作 (也就是你不需要指定这个标记),除非你使用了shellexec标记,在这种情况下,如果你要等待,需要指定这个标记。不能与nowait或waituntilidle 组合使用 |
StatusMsg
仅在[Run] 段有效。由于某些程序在执行期间是不可见的(处于安全或者其他原因),但是又不想让用户以为安装程序没有响应,可以通过该参数指定程序执行时显示在向导页的消息,如果这个参数未指定可是空白的,将使用默认的消息“正在完成安装...”。这个参数可以包含常量。
[UninstallRun]
卸载时候做的一些操作
Filename:"{cmd}";Parameters:"/c net stop 服务名称";Flags:runhidden
另外罗列了一些常用的常量
目录常量
{app}
应用程序目录,这是用户在安装向导的选择安装目录页里面所选择的。
例如:如果你使用了 {app}/MYPROG.EXE 作为一项并且用户选择了“C:/MYPROG”作为应用程序的目录,那么安装程序就会将它转换成“C:/MYPROG/MYPROG.EXE”。
{win}
系统的 Windows 目录。 例如:如果你使用了 {win}/MYPROG.INI 作为一项并且系统的 Windows 目录是“C:/WINDOWS”,那么安装程序就会将它转换成“C:/WINDOWS/MYPROG.INI”。
{sys}
系 统的 Windows 系统(System)目录(在 Windows NT/2000 下是 System32)。 例如:如果你使用了 {sys}
/CTL3D32.DLL 作为一项并且系统的 Windows 系统目录是“C:/WINDOWS/SYSTEM”,那么安装程序就会将它转换成“C:
/WINDOWS/SYSTEM/CTL3D32.DLL”。
{src}
这个文件夹指向安装程序所在的位置。
例如:如果你使用了 {src}/MYPROG.EXE 作为一项并且用户是从“S:/ ”安装的,那么安装程序就会将它转换成“S:/MYPROG.EXE”。
{sd}
系统驱动器,它是指 Windows 被安装到的那个驱动器,典型的是“C:”,对于 Windows NT/2000,这个常量同系统的环境变量“SystemDrive”是等效的。
{pf}
程序文件夹(Program Files),这个路径是系统的 Program Files 目录,典型的是“C:/Program Files”。
{cf}
公共文件夹(Common Files),这个路径是系统的 Common Files 文件夹,典型的是“C:/Program Files/Common Files”。
{tmp}
临时目录,这个目录并不是用户的 TEMP 环境变量指向的目录,而是安装程序在启动时在用户的临时目录下建立的一个子目录(它有一个类似于“
C:/WINDOWS/TEMP/IS-xxxxx.tmp”这样的名字),在安装程序退出时所有的文件和子目录将会被删除。对于在 [Run] 段里面要被执行且在安装以后又不需要的程序文件来说这个功能是非常有用的。
{fonts}
字 体目录,在 Windows 95/NT 4+ 下有一个专门为字体设立的目录(通常这个目录在 Windows 目录下且被命名为“FONTS”),这 个常量就指向这个目录。对于 Windows NT 3.51,这个常量是和 {sys} 等效的,因为当时还没有字体目录。
{dao}
DAO 目录,当安装程序运行在 Windows 95/NT 4+ 上时,它被等效为 {
cf}/Microsoft Shared/DAO,当运行于 Windows NT 3.51 时,它被等效为 {
win}/MSAPPS/DAO.
外壳(Shell)文件夹常量
Inno Setup 还 支持另外一套目录常量,这就是涉及到的外壳(shell)文件夹常量,它们具有和其它的目录常量相同的使用方法。然而,如果在脚本的 [Setup] 段 里面放入了 MinVersion=4,3.51 这一行来表示允许支持 NT 3.51,那么将只有 {group} 这个外壳文件夹常量能被使用,并签只能用在 [Icons] 段。
下面的包含了“user”的常量涉及到当前登陆的用户私人文档(profile),而带有“
common”的常量会涉及到全部用户(All Users)的私人文档(profile)。当安装程序运行在 Windows NT/2000 操作系统下并且用户不具有管理员的权限时,所有的带有“common”的常量会强迫同带有“user”的常量等效。
* 标记表示带有“common”的常量在 Windows 9x 操作系统下同带有“user”的常量等效。
{group}
程 序组的路径,取决于用户在安装程序向导的“选择程序组”页的选择。对于 Windows NT,这个文件夹始终被建立在所有用户的私人文档 (All Users profile),除非用户正在安装的这个应用程序不具有管理员的权限,那么在这种情况下它将被建立在用户的私人文档中 (profile).
{sendto}
当前用户的“发送”的路径。(没有公共的“发送”文件夹。)
{userappdata} & {commonappdata}
应用程序数据(Application Data)文件夹的路径。
{userdesktop} & {commondesktop} *
桌面文件夹的路径,推荐桌面快捷方式使用 {userdesktop}.
{userdocs} & {commondocs}
“我的文档”文件夹的路径(或者对于 NT 4.0,是指私人文件夹).
{userfavorites} & {commonfavorites}
“收 藏夹”的路径,这个常量的使用方法是需要 MinVersion 的设置至少为“4.1, 4”,目前只有 Windows 2000 支 持 {commonfavorites},如果使用的是在这之前的版本的 Windows,那么它将会被转换成和{userfavorites} 相同的 目录。
{userprograms} & {commonprograms} *
在开始菜单里面的程序文件夹的路径。
{userstartmenu} & {commonstartmenu} *
开始菜单的定级路径。
{userstartup} & {commonstartup} *
开始菜单里面的启动文件夹的路径。
{usertemplates} & {commontemplates}
模板(Templates)文件夹的路径,目前只有 Windows 2000 支持 {
commontemplates},如果使用的是在这之前的版本的 Windows ,它将会被转换成和 {usertemplates} 相同的目录。
其他的常量
{/}
一个反斜杠字符,请参见本页前面提到的关于常量 {/} 和单字符 / 在使用上有何不同的说明。
{%NAME}
内嵌一个环境变量,这个 NAME 是要使用的环境变量的名字。如果在用户的系统当中指定的环境变量不存在,这个常量就会被一个空的字符串所替代。
{computername}
安装程序正在运行的计算机的名称(就是“GetComputerName”函数的返回值)。
{groupname}
用户在安装程序向导的选择程序组页选择的程序组的名称,这个是不同于 {group} 的,它不包括路径。
{hwnd}
(专门用途)传送安装程序背景窗口的窗口句柄。
{reg:HKxx/SubkeyName,ValueName|DefaultValue}
内嵌一个注册表值。
HKxx 指定根键(root key),参见 [Registry] 段 文档所列出的根键。
SubkeyName 指定要读取的子键的名称。
ValueName 指定要读取的值的名称,要读取一个键的默认值就让 ValueName 为空。
DefaultValue 如果指定的注册表值不存在或者它不是一个字符串类型(REG_SZ 或者 REG_EXPAND_SZ),则嵌入这个值。
如果你希望包括一个逗号,竖线(字符“|”)或大括号闭弧“}”在常量里面,你必须通过“%-编码” 形式用“%”后紧跟一个两位的16进制代码转译后替换原来的字符,一个逗号是“%2c”,一个竖线符是“%7c”,一个大括号闭弧是“%7d”。
DefaultValue 可以包括常量,然而,如上所诉内嵌的常量的大括号的闭弧
(“}”) 必须被改成“%7d”才可以。
{srcexe}
安装程序的文件名全称(包括全程路径和文件名),例如“C:/SETUP.EXE”。
{username}
运行安装程序的用户的名称(函数 GetUserName 的返回值)。
公共参数
有俩个可选的参数可以在所有的段里面的任何项中使用,它们是:
MinVersion
说明:
该 项处理所需的分别最低的 Windows 版本和 Windows NT 版本. 如果将某个版本号指定为 0 那么在该平台上就再也不会处理这项了,版 本创建编号(Build numbers)和(或)服务包级别(Service pack levels)也可以被包括在版本号当中。这个参数将会覆盖位 于 [Setup] 段当中的 MinVersion 关键字。
示例:
MinVersion: 4.0,4.0
OnlyBelowVersion
说明:
基本上是和 MinVersion 相反,该项所指定的最低的 Windows 版本 和 Windows NT
版 本将不会被处理,例如:如果你指定了 4.1,5.0 并且用户运行在 Windows 95 或 NT 4.0 下,那么该项将会被处理,但是如果用户 运行在 Windows 98 (报告的版本信息是 4.1)或 Windows 2000 (报告的版本信息是 NT 5.0),则该项就不会被处理。 使用“0”表示该版本号上限的限制。版本创建编号(Build numbers)和(或)服务包级别(Service pack levels) 也可以 包括在版本号当中。这个参数将会覆盖位于 [Setup] 段当中的 OnlyBelowVersion 关键字。
示例:
OnlyBelowVersion: 4.1,5.0
其它注意事项
安装程序是按照段内的排列顺序来处理所有的项的,[UninstallRun] 段是个例外,卸载时处理所有项的顺序是与安装程序相反的。
在这个示例中:
[INI]
Filename: “{win}/MYPROG.INI”; Section: “InstallSettings”; Flags: uninsdeletesectionifempty
Filename: “{win}/MYPROG.INI”; Section: “InstallSettings”; Key: “InstallPath”; String: “{app}”; Flags: uninsdeleteentry
安 装程序首先记录下第一项的数据 uninsdeletesectionifempty 标记到卸载记录中。创建第二项的键,然后记录 下 uninsdeleteentry 标记的数据到卸载记录中,当程序被卸载时,卸载程序将首先处理 uninsdeleteentry 标记,删除该 项,然后才是 uninsdeletesectionifempty 标记。
如果安装程序在用户的系统中检测到一个 Windows 共享版本,Windows 系统目录是写保护的,{sys} 目录常量将会被转变为用户的 Windows 目录替代系统目录。
在命令行执行编译器
脚本文件也可以在命令行被安装编译器编译。命令行的使用方法如下:
compiler /cc <脚本文件>
示例:
compil16 /cc c:/isetup/sample16/sample16.iss
compil32 /cc “c:/isetup/sample32/my script.iss”
在上面列出的例子中,带有空格的文件名必须用引号括起来。
在命令行运行安装编译器不支持正常的进程显示或任何错误消息。如果编译成功安装编译器将会返回一个退出代码 0,如果是 1 则表示有无效的命令行参数, 2 则表明编译失败。
安装命令行参数 安装程序本身接受三个不同的可选的命令行参数,这些参数能被用于系统管理员和其他程序调用安装程序。
/SP-
在安装程序开始时禁止“即将安装 … ,继续吗?”的提示,当然,它将使 [Setup] 段的 DisableStartupPrompt 关键字设置为 yes 无效
/DIR=”x:/dirname”
替换在“选择目标文件夹”向导页显示的默认的目录名,必需要指定一个全程路径名。如果 [Setup] 段的 DisableDirPage 关键字被设置为 yes, 那么该命令行参数将被忽略。
/GROUP=”group name”
替换在“选择程序组”向导页显示的默认的程序组名,如果 [Setup] 段的 DisableProgramGroupPage 关键字被设置为 yes, 那么该命令行参数将被忽略。