Inno Setup 3 :语法解析(二

2020-01-14 10:05:18 浏览数 (1)

  接上回。安装脚本段用于解析脚本中各个段的含义及使用方法。其包括[Setup]段、[Files]段、[Run]段等共17个字段,下面逐一进行分析。

[Setup]

  [Setup]段包含用于安装程序和卸载程序的全局设置。某些提示对于你创建的任何安装程序都是必须的。示例如下:

代码语言:javascript复制
[Setup]
AppName=My Program
AppVerName=My Program Version 3.1
DefaultDirName={pf}My Program
DefaultGroupName=My Program

  按默认,指令值的所有首位或末位无显示字符将被分离。这可以通过质控的值包含在双引号 "" 中避免。   [Setup]段中可以包含编译器相关指令(如:SourceDir、OutoutDir、OutputBaseFileName等)和安装程序相关指令(如:AppId、AppName、AppVerName、DefaultGroupName等)。   其中,[Setup]段必须包含的指令如下:

  • AppName
  • AppVerName
  • DefaultDirName

[Types]

  [Types]段是可选的,用来定义安装程序在选择组件页面时可供选择的所有安装类型。如果你在[Components]段定义了组件,但没有定义类型,在编译时将创建一个默认的安装类型设置。如果你正在使用默认(简体中文)消息文件,这些类型等同于下面示例中的类型。[Types]段示例如下:

代码语言:javascript复制
[Types]
Name: "full"; Description: "Full installation"
Name: "compact"; Description: "Compact installation"
Name: "custom"; Description: "Custom installation"; Flags: iscustom

下列是[Types]段所有支持的参数列表:

  • Name(必需的) 类型的内部名字。用于定义[Components]段中组件参数,告诉安装程序组件属于哪个类型。示例: Name: "full"
  • Description(必需的) 类型的描述,可以包含常量。这个描述在安装期间显示。示例: Description: "完全安装"
  • Flags 这个参数是额外选项是设置,多个选项可以使用空格隔开。支持羡慕的选项:  iscustom :  告诉安装程序这个类型是自定义类型。用户在安装期间手动改变了组件选择,安装程序会将安装类型设置为自定义类型。注意,如果未定义自定义类型,安装程序将只允许用户选择一个安装类型,并且不能手动选择/取消选择组件。仅一种类型可以包含该标记。示例如下: Flags: iscustom [Components]   [Components]段是可选的,它定义安装程序向导的选择组件页面中显示的所有组件,以便于用户定制安装类型。   只用这一个组件不会做任何事情,它需要“链接”到其他安装目录。示例如下: [Components] Name: "main"; Description: "主文件"; Types: full compact custom; Flags: fixed Name: "help"; Description: "帮助文件"; Types: full Name: "helpenglish"; Description: "English"; Types: full Name: "helpchinese"; Description: "简体中文"; Types: full 该示例生成四个组件:"main"组件在最终用户选择一个名为"full"或"compact"的类型时安装。带有两个子组件的"help"组件仅在用户选择"full"类型时安装。 下列是所支持的参数列表:
  • Name(必须的) 组件的内部名称。 在组件名称中的 或 / 字符符合计数是调用组件的层次。任何在层次 1 或更高层次的组件是子组件。在子组件前列出的小于子组件层次的组件是上级组件。其他有相同上级组件的组件之间称为同级组件。 如果上级组件未选定,则不能选定它的子组件。如果所有的子组件均未选定,则上级组件也不能选定,除非Components参数引用上级组件或上级组件包含checkablealone标记。 如果同级组件已经标有exclusive标记,则它们之中只有一个可选。示例如下: Name: "help"
  • Description(必须的) 组件的描述,可以包含常量。这个描述用于在安装期间显示给用户参考。示例如下: Description: "帮助文件"
  • Types 用空格隔开所属组件的类型列表。如果用户从这个列表中选择了一个类型,这个组件将被安装。 如果未使用fixed标记(见下文),这个列表中的任何自定义类型(使用iscustom标记的类型)均会被安装程序忽略。示例如下: Types: full compact
  • ExtraDiskSpaceRequired 这个组件所需要的额外磁盘空间,类似于[Setup]段中的ExtrDiskSpaceRequired。示例如下: ExtraDiskSpaceRequired: 0
  • Flags 这个参数是额外选项设置。多个选项可以使用空格隔开。其支持下面的选项:  checkblealone:  指定当一个组件的所有子组件未被选中时,该组件可以被选中。默认的,如果没有Components参数直接引用到该组件,所有未选中的子组件都将导致该组件被设置为未选中状态。  dontinheritcheck:  指定当该组件被上级选中时,不影响组件选择状态。这不影响对顶层的组件,且该标记不能与exclusive标记一起使用。  exclusive:  告诉安装程序该组件与其他拥有exclusive标记的组件是互斥的。  fixed:  告诉安装程序在安装流程中该组件不提供选择项供用户选择。  restart:  告诉安装程序若安装该组件,则无论是否需要,都告诉用户重启电脑。(例如,[Files]段条目用了restartreplace标记),这有点像AlwaysRestart,但并不是每个组件都需如此。  diableenouninstallwarning:  如果这个组件在电脑上已安装,则重建安装时用户取消安装该组件,该标记告诉安装程序不进行警告提示用户将不卸载该组件。  根据组件的复杂性,可使用[installDelete]段和该标记来自动卸载未选定的组件。 示例如下: Flags: fixed [Tasks]   [Tasks]段是可选的,它定义安装程序执行安装期间由用户定制的任务。这些任务以选项框和单选项形式出现在附加任务向导页中。   该段本身是不做任何事情的,它需要“链接”到其他安装条目。示例如下: [Tasks] Name: desktopicon; Description: "创建桌面快捷方式(&D)"; GroupDescription: "添加快捷方式:"; components: main Name: Desktopiconcommon; Description: "对于所有用户"; GroupDescription: "添加快捷方式:"; Components: main; Flags: exclusive Name: desktopiconuser; Description: "仅对当前用户"; GroupDescription: "添加快捷方式: quicklaunchicon; Description: "创建快速启动栏快捷方式(&Q)"; GroupDescription: "添加快捷方式:"; Components: main; Flags: unchecked Name: associate; Description: "文件关联(&A)"; GroupDescription: "其他任务"; Flags: unchecked 下面是所支持的参数列表:
  • Name(必需的)   任务的内部名字。   在组件名称中的 或 / 字符符合计数是调用组件的层次。任何在层次 1 或更高层次的组件是子组件。在子组件前列出的小于子组件层次的组件是上级组件。其他有相同上级组件的组件之间称为同级组件。   如果上级组件未选定,则不能选定它的子组件。如果所有的子组件均未选定,则上级组件也不能选定,除非Components参数引用上级组件或上级组件包含checkablealone标记。   如果同级组件已经标有exclusive标记,则它们之中只有一个可选。示例如下: Name: "desktopicon"
    • Description(必需的)   任务的描述,可包含常量。该描述用于在安装期间进行显示。示例如下: Description: "创建桌面快捷方式(&D)"
    • GroupDescription   任务组的描述,可包含常量。拥有相同描述的连续任务将会被分配到同一个带文字标签的组中。该文字标签用于显示任务组的描述信息。示例如下: GroupDescription: "附加图标"
    • Components 该任务所属的组件列表,列表中组件用空格隔开的。当用户选择一列表中组件时,该任务将被显示;不带组件参数的任务总是被显示。示例如下: Components: main
    • Flags 这个参数是额外选项设置。多个选项可以使用空格隔开。其支持下面的选项:  checkblealone:  指定当一个组件的所有子组件未被选中时,该组件可以被选中。默认的,如果没有Components参数直接引用到该组件,所有未选中的子组件都将导致该组件被设置为未选中状态。  dontinheritcheck:  指定当该组件被上级选中时,不影响组件选择状态。这不影响对顶层的组件,且该标记不能与exclusive标记一起使用。  exclusive:  告诉安装程序该组件与其他拥有exclusive标记的组件是互斥的。  fixed:  告诉安装程序在安装流程中该组件不提供选择项供用户选择。  restart:  告诉安装程序若安装该组件,则无论是否需要,都告诉用户重启电脑。(例如,[Files]段条目用了restartreplace标记),这有点像AlwaysRestart,但并不是每个组件都需如此。  diableenouninstallwarning:  如果这个组件在电脑上已安装,则重建安装时用户取消安装该组件,该标记告诉安装程序不进行警告提示用户将不卸载该组件。  根据组件的复杂性,可使用[installDelete]段和该标记来自动卸载未选定的组件。 示例如下: Flags: unchecked

    [Dirs] [Files] [Icons] [INI] [InstallDelete] [Languages] [Messages] [CustomMessages] [LangOptions] [Registry] [Run] [UninstallDelete] [UninstallRun]

0 人点赞