修改安装程序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
这将在当前目录创建安装程序。
文件
- 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 Qt公司版权所有。本文件中的文档贡献属于其各自的权利人。本文件提供的文档是在自由软件基金会出版的GNU自由文档许可协议(FDL)版本1.3的条款下许可的。Qt公司和Qt以及它们的标志是芬兰和其他国家/地区的商标。所有其他商标均为各自权利人的财产。