使用Qt Installer Framework制作软件安装包

概述

Qt Installer Framework（缩写QIF）是Qt官方用于生成软件安装包的工具。包括Qt Creator和Qt Installer Framework自身的安装包都是由这个工具制作的。详细说明请访问QIF的官方文档。

环境

我使用的环境是Windows7 64位和Qt Installer Framework 2.0.3

下载

首先根据自己的平台（Linux或Windows等）去Qt官网下载Qt Installer Framework的安装包或者源码。为了简单起见，我下载是安装包。然后像普通软件那样双击安装。

目录结构

安装好后，并不是一个直接可用的图形界面软件。而是提供了一些可执行的工具程序（Windows下是exe文件），然后根据规则，利用这些工具生成安装包。

假设安装在D:\，则生成目录D:\QtIFW2.0.3，其中2.0.3是版本号。目录结构如下图所示。

1、bin

bin中包含的就是我们需要用到的工具。最简单地，我们只用其中一个，叫binarycreator.exe

2、doc

doc中包含帮助文档。文档的格式是网页（html）。也可以去官方网站上查看文档。文档是英文。不过很详细。

3、examples

examples中包含了很多Qt Installer Framework的例子。初学者只需要将例子作为模板，按照自己的情况修改即可。

4、Licenses

Licenses中包含了Qt Installer Framework的Licenses，例如LGPL等。

准备

1、目录结构

用QIF生成安装包时，必须先按照规范建立目录结构。

参考examples中的目录结构，例如examples/tutorial目录中的结构如下：

规范的目录结构中，包含一个config文件夹和一个packages文件夹。其中config文件夹中只包含一个config.xml文件，用于描述软件以及安装包的一些信息。packages文件夹包含了安装包的信息描述、行为描述以及数据。其中，packages中的每一个子文件夹都表示不同的软件，或者软件的一个模块或者部件，例如com.vendor.product1、com.vendor.product2等等。

其结构可能如下

-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

对于简单的软件，可能只有一个模块，对应一个文件夹。

每个子文件夹下都有两个文件夹data和meta，前者包含了所有软件的数据，包括可执行文件、链接库文件、配置文件等等，将所有这些文件压缩成.7z压缩包后，放入此文件夹；后者包含了至少3个文件，installscript.qs、license.txt、package.xml，分别用于描述安装行为、许可信息、模块或软件的描述（用于选择模块的页面上），其中license.txt文件名可变，只需要在脚本中做相应修改即可。

2、config.xml

config/config.xml定义了安装程序的行为。

例子如下：

<?xml version="1.0" encoding="UTF-8"?>
<Installer>
    <Name>Your App</Name>
    <Version>1.0.0</Version>
    <Title>Your App Installer</Title>
    <Publisher>You</Publisher>
    <StartMenuDir>Your App</StartMenuDir>
    <TargetDir>@HomeDir@/Your App</TargetDir>
</Installer>

其中各个标签的含义如下：

• < Name> 软件名称
• < Version> 版本号
• < Title> 安装程序窗口标题
• < Publisher> 发布者名称
• < StartMenuDir> 要生成的windows开始菜单目录
• < TargetDir> 默认安装路径

config.xml支持的标签很多，不过多数都是可选的，只有上述这些是必须的。请参考官方文档，根据需要添加标签。

3、data

data文件夹下包含了你要发布的软件的全部数据文件，包括可执行文件、链接库文件、数据库、配置文件等等。将所有文件用.7z格式打包后，放在data文件夹下即可。

4、meta/installscript.qs

installscript.qs的语言类似于javascript，用于定义安装软件包的行为（如果软件有多个组件，每个分别配置），例如是否默认选中、是否生成开始菜单快捷方式、是否生成桌面快捷方式、是否有额外的安装步骤需要添加到常规步骤中。具体说明请参考examples中的例子以及官方文档。

5、meta/license.txt

将软件有关的许可信息，写在此文件中，会在安装过程中显示并要求用户同意。

文件名称可以修改，不过修改过后要修改package.xml中对应的脚本。

6、meta/package.xml

meta/package.xml定义了安装包在处理此部件时要显示的信息。

例子如下：

<?xml version="1.0" encoding="UTF-8"?>
<Package>
    <DisplayName>The main component</DisplayName>
    <Description>the main component of your app</Description>
    <Version>1.0.0-1</Version>
    <ReleaseDate>2016-06-01</ReleaseDate>
    <Name>com.vendor.product</Name>
    <Licenses>
        <License name="Your App Agreement" file="license.txt" />
    </Licenses>
    <Default>script</Default>
    <Script>installscript.qs</Script>
    <UserInterfaces>
        <UserInterface>page.ui</UserInterface>
    </UserInterfaces>
</Package>

其中各个标签的含义如下：

• < DisplayName> 显示的名称
• < Description> 描述
• < Version> 部件的版本号
• < ReleaseDate> 发行日期
• < Name> 部件名称（与文件夹名一致）
• < Licenses> 许可信息名称以及许可文件名
• < Script> 脚本文件
• < UserInterfaces> 额外的界面（如果需要的话，而且需要去installscript.qs中配置）

同样地，支持的标签很多，不过多数都是可选的，上述这些也不一定是必须的。请参考官方文档，根据需要添加标签。

制作安装包

完成上述准备工作后，使用binarycreator.exe工具生成安装包。

需要在命令行中操作。在开始菜单中搜索cmd，或按下win+r输入cmd回车，打开命令行。转到刚才准备好的目录中。

例如：

C:\> D:
D:\> cd QtIFW2.0.3\examples\yourapp
D:\ ..\..\bin\binarycreator.exe -c config\config.xml -p packages YourInstaller.exe

其中，路径一定要对，YourInstaller.exe是安装包文件名，换成你想要的名称即可。