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,这意味着如果找到不稳定的组件,安装将中止。 |
原创造福大家,共享改变世界
献出一片爱心,温暖作者心灵
![](https://img2018.cnblogs.com/blog/1921368/202002/1921368-20200223073938417-815334096.jpg)