修改安装程序UI示例

使用组件脚本来修改安装程序UI。

修改安装程序UI演示了如何使用Component()函数更改许可协议页面上复选框标签的默认文本。此示例不安装任何组件,但它在包信息文件中指定了一个虚构组件,因为不允许安装程序没有组件。

配置示例安装程序

安装程序配置文件config.xml位于config目录中,指定了安装程序中使用的文本和默认值

  • <Name>元素设置应用程序名称并将其添加到页面名称和介绍文本中。
  • <Version>元素设置应用程序版本号。
  • <Title>元素设置安装程序名称,并在标题栏上显示它。
  • <Publisher>元素设置软件的发布者(例如,在Windows控制面板中显示的发布者)。
  • <StartMenuDir>元素设置Windows中产品的默认程序组名称。
  • <TargetDir>元素将目标目录位置设置为当前用户家目录中IfwExamples目录内(因为它使用了预定义变量,, @HomeDir@,作为值的一部分)。有关更多信息,请参阅预定义变量
<?xml version="1.0" encoding="UTF-8"?>
<Installer>
    <Name>Change Installer UI Example</Name>
    <Version>1.0.0</Version>
    <Title>Change Installer UI Example</Title>
    <Publisher>Qt-Project</Publisher>
    <StartMenuDir>Qt IFW Examples</StartMenuDir>
    <TargetDir>@HomeDir@/IfwExamples/changeuserinterface</TargetDir>
</Installer>

创建示例包信息文件

安装程序包信息文件package.xml位于meta目录中,指定了可安装的组件

  • <DisplayName>元素设置组件的可读名称。
  • <Description>元素设置组件的可读描述。
  • <Version>元素设置组件的版本号。
  • <ReleaseDate>元素设置此组件版本的发布日期。
  • <Default>元素指定是否在用户界面中将组件默认选中以安装。
  • <Script>元素设置加载的JavaScript文件的文件名。
  • <Licenses>元素设置最终用户接受的许可协议的name以及包含该许可的文件名。
<?xml version="1.0" encoding="UTF-8"?>
<Package>
    <DisplayName>Dummy Component</DisplayName>
    <Description>This example does not install any components. It demonstrates
    modifying the text on the next page.</Description>
    <Version>1.0.0-1</Version>
    <ReleaseDate>2013-01-01</ReleaseDate>
    <Default>true</Default>
    <Script>installscript.qs</Script>
    <Licenses>
        <License name="Beer Public License Agreement" file="license.txt" />
    </Licenses>
</Package>

更新UI文本

在installscript.qs中,Component()函数在最终用户进入页面时添加许可协议检查页面并连接到changeLicenseLabels信号

function Component()
{
    if (!installer.isCommandLineInstance())
        gui.pageWidgetByObjectName("LicenseAgreementPage").entered.connect(changeLicenseLabels);
}

changeLicenseLabels函数更改页面上的接受许可证复选框的文本标签

changeLicenseLabels = function()
{
    page = gui.pageWidgetByObjectName("LicenseAgreementPage");
    page.AcceptLicenseLabel.setText("Yes I do!");
}

注意:不要使用Component()函数添加翻译。

生成示例安装程序

要创建示例安装程序,请在命令行中切换到示例源目录,并输入以下命令

  • 在Windows上
    ..\..\bin\binarycreator.exe -c config\config.xml -p packages installer.exe
  • 在Linux或macOS上
    ../../bin/binarycreator -c config/config.xml -p packages installer

这将在当前目录创建安装程序。

文件

©2021 Qt公司版权所有。本文件中的文档贡献属于其各自的权利人。本文件提供的文档是在自由软件基金会出版的GNU自由文档许可协议(FDL)版本1.3的条款下许可的。Qt公司和Qt以及它们的标志是芬兰和其他国家/地区的商标。所有其他商标均为各自权利人的财产。