以下各节包含有关Qt安装程序框架的详细信息：

• 配置文件
• 包目录
• 控制器脚本
• 组件脚本
• 运作方式
• 工具类
• 脚本API
• C ++ API

配置文件

配置文件可自定义安装程序的用户界面和行为。该文件通常被调用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文件的位置进行解析。

您可以使用预定义的变量（嵌入@字符）作为元素的值。有关更多信息，请参见预定义变量。

包目录

安装程序包含嵌入到安装程序中或从远程存储库加载的组件。在这两种情况下，都需要为安装程序可以读取的组件使用文件格式和结构。

包目录结构

将所有组件放在同一根目录中，该根目录称为package目录。该目录名称充当类似于域的标识符，用于标识所有组件。例如，com.vendor.root。

在根目录中，创建名为data和的子目录meta。

软件包目录如下所示：

-packages
    - com.vendor.root
        - data
        - meta
    - com.vendor.root.component1
        - data
        - meta
    - com.vendor.root.component1.subcomponent1
        - data
        - meta
    - com.vendor.root.component2
        - data
        - meta

元目录

该meta目录包含指定部署设置和安装过程的文件。安装程序不会提取文件。该目录必须至少包含一个软件包信息文件以及您在软件包信息文件中引用的所有文件，例如脚本，用户界面文件和翻译。

软件包信息文件语法

package.xml文件是有关组件的主要信息来源。以下是打包文件的示例：

<?xml version="1.0"?>
<Package>
    <DisplayName>QtGui</DisplayName>
    <Description>Qt gui libraries</Description>
    <Description xml:lang="de_de">Qt GUI Bibliotheken</Description>
    <Version>1.2.3</Version>
    <ReleaseDate>2009-04-23</ReleaseDate>
    <Name>com.vendor.root.component2</Name>
    <Dependencies>com.vendor.root.component1</Dependencies>
    <Virtual>false</Virtual>
    <Licenses>
        <License name="License Agreement" file="license.txt" />
    </Licenses>
    <Script>installscript.qs</Script>
    <UserInterfaces>
        <UserInterface>specialpage.ui</UserInterface>
        <UserInterface>errorpage.ui</UserInterface>
    </UserInterfaces>
    <Translations>
        <Translation>sv_se.qm</Translation>
        <Translation>de_de.qm</Translation>
    </Translations>
    <DownloadableArchives>component2.7z, component2a.7z</DownloadableArchives>
    <AutoDependOn>com.vendor.root.component3</AutoDependOn>
    <SortingPriority>123</SortingPriority>
    <UpdateText>This changed compared to the last release</UpdateText>
    <Default>false</Default>
    <ForcedInstallation>false</ForcedInstallation>
    <Essential>false</Essential>
    <Replaces>com.vendor.root.component2old</Replaces>
</Package>

软件包信息文件元素的摘要

组件依赖性

组件可以取决于一个或几个实际或虚拟组件。依赖关系是通过使用组件标识符和（可选）组件版本来定义的。使用破折号（-）将版本号与标识符分开。

您可以使用比较运算符（=，>，＆lt;（<），> =或＆lt; =（<=））作为版本号的前缀，以指示该软件包的版本号已与所需版本进行比较，并且必须为等于，大于，小于，大于或等于或小于依赖性中指定的版本号。如果没有给出比较运算符，则默认为=。

资料目录

该data目录包含安装程序在安装过程中提取的内容。您必须将数据打包为7zip存档（.7z）。您可以使用Qt Installer框架随附的archivegen工具，也可以使用其他生成7zip存档的工具。