教程：创建安装程序

本教程描述了如何为小型项目创建一个简单的安装程序

本节描述了您必须执行以下任务以创建安装程序

1. 创建一个将包含所有配置文件和安装包的 包目录。
2. 创建一个包含有关如何构建安装程序二进制文件和在线存储库信息的 配置文件。
3. 创建一个包含有关可安装组件信息的 包信息文件。
4. 创建安装内容并将其复制到包目录。
5. 使用 binarycreator 工具创建 安装程序。

   使用配置文件和包信息文件中设置的参数创建安装程序页面。

您可以在 Qt 安装程序框架仓库中的 examples\tutorial 目录中找到示例文件。

创建包目录

创建反映安装程序设计的目录结构，并允许未来扩展。目录必须包含名为 config 和 packages 的子目录。

有关包目录的更多信息，请参阅 包目录。

创建配置文件

在 config 目录中，创建一个名为 config.xml 的文件，内容如下

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

配置文件包括以下信息用于简介页面

• <Title> 元素设置安装程序名称并在标题栏中显示（1）。
• <Name> 元素设置应用程序名称并将其添加到页面编号和简介文本（2）。

其他元素自定义安装程序的行为

• <Version> 元素设置应用程序版本号。
• <Publisher> 元素设置软件的发布者（例如，在 Windows 控制面板中显示的发布者）。
• <StartMenuDir> 元素设置 Windows 开始 菜单中产品的默认程序组的名称。
• <TargetDir> 元素设置和显示 InstallationDirectory，在当前用户的家庭目录中作为默认目标目录提供给用户（因为它使用预定义变量 @HomeDir@ 作为值的一部分）。有关更多信息，请参阅 预定义变量。

有关配置文件格式和可用元素的信息，请参阅 配置文件。

创建包信息文件

在这个简单的场景中，安装程序只处理一个组件，com.vendor.product。为了给安装程序提供有关组件的信息，创建一个名为 package.xml 的文件，内容如下，并将其放置在 meta 目录中

<?xml version="1.0" encoding="UTF-8"?>
<Package>
    <DisplayName>The root component</DisplayName>
    <Description>Install this example.</Description>
    <Version>0.1.0-1</Version>
    <ReleaseDate>2010-09-21</ReleaseDate>
    <Licenses>
        <License name="Beer Public License Agreement" file="license.txt" />
    </Licenses>
    <Default>script</Default>
    <Script>installscript.qs</Script>
    <UserInterfaces>
        <UserInterface>page.ui</UserInterface>
    </UserInterfaces>
</Package>

以下是对示例文件中元素的更详细描述。有关包信息文件的信息，请参阅包信息文件语法。

指定组件信息

组件选择页面显示以下元素的信息

• <DisplayName>元素设置组件列表中组件的名称（1）。
• <Description>元素根据所选组件设置并显示文本（2）。

指定安装程序版本

<Version>元素在可用时为用户提供更新。

添加许可证

<License>元素设置包含许可协议文本的文件名（1）。许可检查页面显示此许可文本。

选择默认内容

<Default>元素指定所选组件是否为默认值。值true将组件设置为选中状态。此示例使用值script在运行时解析值。<Script>元素设置JavaScript脚本文件名，为installscript.qs。

创建安装程序内容

组件的data目录可以存储用于安装的内容。由于只有一个组件，请在packages/com.vendor.product/data目录中放置数据。示例中已经有用于测试的文件，但您可以在目录中放置基本上任何文件。

有关包装规则和选项的更多信息，请参阅数据目录。

创建安装程序二进制文件

您现在可以创建第一个安装程序了。在命令行中切换到examples\tutorial目录。要创建一个名为YourInstaller.exe的安装程序，该安装程序具有由com.vendor.product标识的包，请输入以下命令

• 在Windows上

  ..\..\bin\binarycreator.exe -c config\config.xml -p packages YourInstaller.exe

• 在Linux或macOS上

  ../../bin/binarycreator -c config/config.xml -p packages YourInstaller

Qt安装程序框架将在当前目录中创建安装程序，您可以将其提供给最终用户。

有关使用binarycreator工具的更多信息，请参阅binarycreator。