Qt Installer Framework翻译(5-4)

自定义安装程序

您可以使用脚本通过以下方式来自定义安装程序:

> 添加Qt Installer Framework操作,该操作由脚本提供,并由安装程序执行。
> 添加新页面,该页面由您在package.xml文件中指定,并将其放置在packages文件夹中。
> 修改现有页面,通过插入自定义用户界面元素来作为子部件。
> 添加语言变体。

您可以同时使用组件脚本控制脚本来自定义安装程序。通过在组件的package.xml文件的Script元素中指定组件脚本,可以将该脚本与特定的组件关联起来。当组件的元数据获取完毕时,将加载该脚本。有关组件脚本的更多信息,请参见组件脚本章节。

通过在安装程序的control.xml文件的ControlScript元素中指定控制脚本,可以将该脚本与整个安装程序关联起来。控制脚本可以是安装程序资源的一部分,也可以在命令行中被传递。它们可用于修改安装程序页面,该页面在加载组件之前向用户显示。另外,您可以使用它们来修改卸载程序中的页面。有关更多信息,请参见控制脚本章节。

有关可用于组件/控制脚本的全局JavaScript对象的更多信息,请参见脚本API章节。

添加操作

您可以在安装过程中使用组件脚本执行Qt Installer Framework操作。通常,操作通过移动,复制或修补方式来操纵文件。使用QInstaller::Component::addOperation或QInstaller::Component::addElevatedOperation函数来添加操作。有关更多信息,请参见向组件添加操作章节。

另外,您可以通过派生KDUpdater::UpdateOperation来重新实现方法函数,用于在安装程序中注册自定义安装操作。有关更多信息,请参见注册自定义操作章节。

有关可用操作的总结,请参见操作章节。

添加页面

一个组件可以包含一个或多个用户界面文件,这些文件由组件或控制脚本放置在安装程序中。安装程序自动加载package.xml文件中UserInterfaces元素列出的所有用户界面文件。

使用组件脚本添加页面

要向安装程序添加新页面,请使用installer::addWizardPage()方法,并指定新页面的位置。例如,以下代码在安装准备页面中添加了MyPage实例:

installer.addWizardPage(component,"MyPage",QInstaller.ReadyForInstallation);

您可以使用组件脚本来访问已加载的窗口子部件,方法是通过该部件的类名来调用component::userInterface()方法,如以下代码片段所示:

component.userInterface( "MyPage" ).checkbox.checked = true;

您还可以为添加的页面提供回调函数。要访问它,请使用在UI文件中设置的对象名称(例如,“ MyPage”)。然后创建Dynamic${ObjectName}Callback函数(例如,DynamicMyPageCallback):

Component.prototype.DynamicMyPageCallback = function()
{
    var page = gui.pageWidgetByObjectName("DynamicMyPage");
    page.myButton.click,
    page.myWidget.subWidget.setText("hello")
}

您可以使用在UI文件中设置的对象名称来访问窗口子部件。例如,上面代码中的myButton和myWidget就是子部件对象名称。

添加子部件

您可以使用组件或控制脚本,来将自定义用户界面元素,作为单个窗口子部件(例如复选框)插入到安装程序中。

要插入单个子部件,请使用installer::addWizardPageItem方法。例如,以下代码片段通过脚本,将MyWidget的实例添加到组件选择页面:

installer.addWizardPageItem(component,"MyWidget",QInstaller.ComponentSelection);

与安装程序进行功能性交互

例如,您可以使用控制脚本在测试中自动执行安装程序功能函数。以下代码段说明了如何在目标文件夹选择页面上自动点击“下一步”按钮:

Controller.prototype.TargetDirectoryPageCallback = function()
{
    gui.clickButton(buttons.NextButton);
}

翻译页面

安装程序使用Qt翻译系统,来将用户可读的输出翻译成多种语言。要提供组件脚本和用户界面中包含的字符串的本地化版本,请创建QTranslator文件,安装系统会在加载组件时一起加载该文件。安装程序将加载与当前系统区域匹配的翻译文件。例如,如果系统区域设置为德语,则将加载de.qm文件。另外,如果存在本地化的license_de.txt,那么会显示该文件,而不是默认的license.txt。

需要将翻译添加到package.xml文件中,才能激活组件的翻译:

<Translations>
    <Translation>de.qm</Translation>
</Translations>

将qsTr()函数用于脚本内的文字文本。此外,您可以将Component.prototype.retranslateUi方法添加到脚本中。 当安装程序的语言更改时,翻译文件被加载后,将调用该方法。

用于翻译的上下文,是使用qsTr时脚本文件的基础名,或翻译用户界面时UI文件的类名称。例如,如果脚本为installscript.qs,则上下文将为installscript。

注意:翻译系统还可以用于自定义UI。例如,通过自定义英语版本,使用一个en.ts文件,来替换安装程序中的任意文本。

上一篇:harbor搭建与使用


下一篇:Qt Installer Framework翻译(7-4)