Qt Installer Framework更改安装程序UI示例

Change Installer UI Example

更改安装程序UI示例

Using a component script to change the installer UI.

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

Change Installer UI demonstrates how to use the Component() function to change the default text for the check box label on the license check page. This example does not install any components, but it specifies a dummy component in the package information file, because installers without components are not allowed.

​Change Installer UI演示了如何使用Component（）函数更改许可证检查页面上复选框标签的默认文本。此示例不安装任何组件，但它在包信息文件中指定了一个虚拟组件，因为不允许没有组件的安装程序。

Configuring the Example Installer

配置示例安装程序

The installer configuration file, config.xml, in the config directory specifies the text and default values used in the installer:

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

• The <Name> element sets the application name and adds it to the page name and introduction text.
• <Name>元素设置应用程序名称并将其添加到页面名称和介绍文本中。
• The <Version> element sets the application version number.
• <Version>元素设置应用程序版本号。
• The <Title> element sets the installer name and displays it on the title bar.
• <Title>元素设置安装程序名称并将其显示在标题栏上。
• The <Publisher> element sets the publisher of the software (as shown in the Windows Control Panel, for example).
• <Publisher>元素设置软件的发布者（例如，如Windows控制面板所示）。
• The <StartMenuDir> element sets the name of the default program group for the product in the Windows Start menu.
• <StartMenuDir>元素在Windows“开始”菜单中设置产品的默认程序组的名称。
• The <TargetDir> element sets the default target directory location to be within the IfwExamples directory in the home directory of the current user (because it uses the pre-existing variable , @HomeDir@, as part of the value). For more information, see Predefined Variables.
• ​<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>

Creating the Example Package Information File

创建示例包信息文件

The installer package information file, package.xml, in the meta directory specifies the components that are available for installation:

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

• The <DisplayName> element sets the human-readable name of the component.
• <DisplayName>元素设置组件的人类可读名称。
• The <Description> element sets the human-readable description of the component.
• <Description>元素设置组件的人类可读描述。
• The <Version> element sets the version number of the component.
• <Version>元素设置组件的版本号。
• The <ReleaseDate> element sets the date of release for this component version.
• <ReleaseDate>元素设置此组件版本的发布日期。

• The <Default> element specifies whether the component is preselected for installation in the user interface by default.
• <Default>元素指定默认情况下是否预选组件以在用户界面中安装。
• The <Script> element sets the file name of the loaded JavaScript file.
• <Script>元素设置加载的JavaScript文件的文件名。
• The <Licenses> element sets the name of the license agreement that the end user accepts, as well as the filename of the file that has the license.
• <Licenses>元素设置最终用户接受的许可协议的name ，以及具有许可证的file 的文件名。

<?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>

Updating UI Text

更新UI文本

In installscript.qs, the Component() function adds the license check page and connects to the changeLicenseLabels signal when end users enter the page:

在installscript.qs中，Component（）函数添加许可证检查页面，并在最终用户进入页面时连接到changeLicenseLabels信号：

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

The changeLicenseLabels function changes the text label for the accept license check box on the page:

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

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

Note: Do not use the Component() function to add translations.

注意：不要使用Component（）函数添加翻译。

Generating the Example Installer

生成示例安装程序

To create the example installer, switch to the example source directory on the command line and enter the following command:

要创建示例安装程序，请在命令行上切换到示例源代码目录，然后输入以下命令：

• On Windows:

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

• On Linux or macOS:

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

This creates the installer to the current directory.

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

Files:

• changeuserinterface/changeuserinterface.pro
• changeuserinterface/config/config.xml
• changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/installscript.qs
• changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/license.txt
• changeuserinterface/packages/org.qtproject.ifw.example.changeuserinterface/meta/package.xml

© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. The Qt Company, Qt and their respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.