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，这意味着如果找到不稳定的组件，安装将中止。

---

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

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

---