Inno Setup 3 ：语法解析

Posted 2020-11-20

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

[Setup]

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

[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]段示例如下：

[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]

  [Dirs]

  [Files]

  [Icons]

  [INI]

  [InstallDelete]

  [Languages]

  [Messages]

  [CustomMessages]

  [LangOptions]

  [Registry]

  [Run]

  [UninstallDelete]

  [UninstallRun]