Qt Installer Framework翻译(7-1)
配置文件
配置文件可自定义安装程序的用户界面和行为。该文件通常称为config.xml，位于config文件夹中。
最小配置文件由一个<Installer>根元素组成，<Name>和<Version>元素是其子元素。所有其他元素都是可选的，并且可以任意顺序出现。
以下示例显示了一个典型的配置文件：
<?xml version="1.0"?>
<Installer>
<Name>Some Application</Name>
<Version>1.0.0</Version>
<Title>Some Application Setup</Title>
<Publisher>Your Company</Publisher>
<ProductUrl>http://www.your-fantastic-company.com</ProductUrl>
<InstallerWindowIcon>installericon</InstallerWindowIcon>
<InstallerApplicationIcon>installericon</InstallerApplicationIcon>
<Logo>logo.png</Logo>
<Watermark>watermark.png</Watermark>
<RunProgram>@TargetDir@/YourAppToRun</RunProgram>
<RunProgramArguments>
<Argument>Argument 1</Argument>
<Argument>Argument 2</Argument>
</RunProgramArguments>
<RunProgramDescription>My nice application</RunProgramDescription>
<StartMenuDir>Some Application Entry Dir</StartMenuDir>
<MaintenanceToolName>SDKMaintenanceTool</MaintenanceToolName>
<AllowNonAsciiCharacters>true</AllowNonAsciiCharacters>
<Background>background.png</Background>
<TargetDir>@HomeDir@/testinstall</TargetDir>
<AdminTargetDir>@RootDir@/testinstall</AdminTargetDir>
<RemoteRepositories>
<Repository>
<Url>http://www.your-repo-location/packages/</Url>
</Repository>
</RemoteRepositories>
</Installer>
配置文件元素总结
下表总结了配置文件中的元素。
注意：我们建议您将的配置文件中引用的所有文件放在config目录下。但是，您也可以使用相对路径，工具解析这些路径时，是相对于config.xml文件的位置。
您可以使用预定义变量（嵌入@字符）作为元素的值。有关更多信息，请参见预定义变量章节。
| 元素 | 描述 |
|---|---|
| Name | 要安装的产品的名称。这是强制性的。 |
| Version | 要安装的产品版本的格式： [0-9]+((\.|-)[0-9]+)*例如1-1; 1.2-2; 3.4.7.这是强制性的。 |
| Title | 在标题栏显示的安装程序的名称。 |
| Publisher | 软件的发布者（如Windows控制面板中所示）。 |
| ProductUrl | 指向包含产品信息的网站页面的URL。 |
| Icon | 自定义安装程序图标的文件名。通过附加的'.icns'（macOS），'.ico'（Windows）或'.png'（Unix）后缀，查找文件。不推荐使用，请使用 |
| InstallerApplicationIcon | 自定义安装程序图标的文件名。通过附加的'.icns'（macOS），'.ico'（Windows）后缀，查找文件。Unix中无该功能。 |
| InstallerWindowIcon | PNG格式的自定义窗口图标的文件名，用于Installer应用程序。 |
| Logo | logo文件名，用作QWizard::LogoPixmap。 |
| Watermark | 水印文件名，用作QWizard::WatermarkPixmap。 |
| Banner | 横幅文件名，用作QWizard::BannerPixmap（仅用于ModernStyle模式） |
| Background | 图像文件名，用作QWizard::BackgroundPixmap（仅用于MacStyle模式） |
| WizardStyle | 设置向导样式（"Modern", "Mac", "Aero" or "Classic"）。 |
| StyleSheet | 设置样式表文件。 |
| WizardDefaultWidth | 设置向导的默认像素宽度。设置横幅图像将覆盖此设置。您可以将em或ex后缀添加到指定的值，以使用em或ex单位，就像CSS文件一样。 |
| WizardDefaultHeight | 设置向导的默认像素高度。设置水印图像将覆盖此设置。您可以将em或ex后缀添加到指定的值，以使用em或ex单位，就像CSS文件一样。 |
| TitleColor | 设置标题和子标题的颜色（采用HTML颜色代码，例如“＃88FF33”）。 |
| RunProgram | 安装程序完成后被执行的命令，如果用户接受该操作。请给应用程序提供完整的路径。 |
| RunProgramArguments | 参数，传递给 |
| RunProgramDescription | 文本，在安装程序执行完后，显示与运行程序复选框旁。如果设置了 |
| StartMenuDir | Windows“开始”菜单中产品的默认程序组的名称。 |
| TargetDir | 默认安装目标文件夹。在Linux上，通常是用户的主目录。 |
| AdminTargetDir | 具有管理员权限的默认安装目标文件夹。仅在Linux上可用，您通常不想将其安装在管理员用户的主目录中。 |
| RemoteRepositories | 远程存储库列表。该元素可以包含多个 |
| RepositoryCategories | 类别的名称，可以包含一系列 |
| MaintenanceToolName | 生成的维护工具的文件名。默认为maintenancetool。附加了平台特定的可执行文件扩展名。 |
| MaintenanceToolIniFile | 生成的维护工具的配置文件名。默认为MaintenanceToolName.ini。 |
| RemoveTargetDir | 如果在卸载时不应删除目标文件夹，则设置为false。 |
| AllowNonAsciiCharacters | 如果安装路径可以包含非ASCII字符，则设置为true。 |
| DisableAuthorizationFallback | 如果在授权错误的情况下，不要求用户运行授权应急，则将其设置为true。并会立即中止安装。 |
| RepositorySettingsPageVisible | 设置为false，可在设置对话框中隐藏存储库设置页面。 |
| AllowSpaceInPath | 如果安装路径不能包含空格字符，则设置为false。 |
| DependsOnLocalInstallerBinary | 如果要禁止从外部资源进行安装，例如网络驱动器，请设置为true。这可能对非常大的安装程序有意义。该选项仅在Windows上使用。 |
| TargetConfigurationFile | 目标对象上的配置文件名。默认为components.xml。 |
| Translations | 用于翻译用户界面的语言代码列表。要添加几种语言变体，请指定多个 |
| UrlQueryString | 该字符串必须采用“键=值”的形式，并将添加到存档下载请求中。这可用于传输信息到托管资源库的Web服务器。 |
| ControlScript | 自定义安装程序控制脚本的文件名。请参阅控制脚本章节。 |
| CreateLocalRepository | 如果要在安装目录中创建本地存储库，请设置为true。此选项对在线安装程序无效。该存储库将被自动添加到默认存储库列表中。 |
| InstallActionColumnVisible | 如果要在显示安装操作的组件树中添加额外的列，请设置为true。此额外的列指示组件是要进行安装还是要进行卸载，或保持已安装或已卸载。 |
| SupportsModify | 如果产品不支持修改现有安装，则设置为false。 |
| SaveDefaultRepositories | 如果默认存储库 |
| AllowUnstableComponents | 设置为true，如果允许安装其他组件，虽然其中可能存在不稳定的。一个组件是不稳定的，如果组件缺少依赖项，脚本中有错误等则。不稳定的组件在组件树中显示为灰色，因此无法被选择。默认情况下，该值为false，这意味着如果找到不稳定的组件，安装将中止。 |
原创造福大家，共享改变世界
献出一片爱心，温暖作者心灵
