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 文本,在安装程序执行完后,显示与运行程序复选框旁。如果设置了,但未提供描述文本,则UI将显示Run Now。
StartMenuDir Windows“开始”菜单中产品的默认程序组的名称。
TargetDir 默认安装目标文件夹。在Linux上,通常是用户的主目录。
AdminTargetDir 具有管理员权限的默认安装目标文件夹。仅在Linux上可用,您通常不想将其安装在管理员用户的主目录中。
RemoteRepositories 远程存储库列表。该元素可以包含多个子元素,每个子元素都包含子元素,用于指定访问存储库的URL。有关更多信息,请参阅配置存储库章节。
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 如果默认存储库不应保存到MaintenanceToolName.ini,则设置为false。默认情况下,默认存储库被保存。不保存存储库意味着,您在运行maintenancetool时没有默认存储库可使用。
AllowUnstableComponents 设置为true,如果允许安装其他组件,虽然其中可能存在不稳定的。一个组件是不稳定的,如果组件缺少依赖项,脚本中有错误等则。不稳定的组件在组件树中显示为灰色,因此无法被选择。默认情况下,该值为false,这意味着如果找到不稳定的组件,安装将中止。

原创造福大家,共享改变世界

献出一片爱心,温暖作者心灵


posted @ 2020-01-28 11:28  codeForFamily  阅读(310)  评论(0编辑  收藏  举报