Qt Installer Framework创建安装程序

 Qt Installer Framework
时间:

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

本节描述创建安装程序必须完成的以下任务:

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

通过使用您在配置和软件包信息文件中提供的信息来创建安装程序页面。

示例文件位于examples\tutorialQt Installer Framework存储库中的目录中。

创建软件包目录

创建一个目录结构,以反映安装程序的设计并允许将来扩展安装程序。该目录必须包含名为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该值在运行时解析该值。JavaScript脚本文件的名称installscript.qs在该<Script>元素中指定。

创建安装程序内容

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

有关打包规则和选项的更多信息,请参见数据目录。

创建安装程序二进制文件

现在可以开始创建第一个安装程序了。切换到examples\tutorial命令行上的目录。要创建一个名为YourInstaller.exe的安装程序,其中包含com.vendor.product标识的软件包,请输入以下命令:

  • On Windows:
..\..\bin\binarycreator.exe -c config\config.xml -p packages YourInstaller.exe
  • On Linux or macOS:
../../bin/binarycreator -c config/config.xml -p packages YourInstaller

安装程序将在当前目录中创建,您可以将其交付给最终用户。

有关使用该binarycreator工具的更多信息,请参见binarycreator。

注意:如果在运行教程安装程序时显示错误消息,请检查是否使用静态构建的Qt创建安装程序。有关更多信息,请参见配置Qt。


0 评论