控制脚本

对于每个安装程序，您可以指定一个控制脚本，用来与安装程序的部分UI或功能进行交互。控制脚本可以在向导中添加和删除页面，更改现有页面，进行附加检查以及通过模拟用户单击来与UI交互。例如，这允许安装时无需人的参与。

脚本格式必须与QJSEngine兼容。

本节介绍为实现这种控制脚本而调用的函数功能。它还概述了安装程序页面以及每个页面上可用的小部件，例如按钮，单选按钮和行编辑。

编写控制脚本

最小的有效脚本至少需要包含一个构造函数，如下所示：

function Controller()
{
}

以下示例显示了一个更高级的脚本，该脚本使用gui JavaScript全局对象方法，用于在简介页面上设置新页面标题和欢迎消息，并在目标文件夹页面上自动单击下一步按钮：

function Controller()
{
}

Controller.prototype.IntroductionPageCallback = function()
{
    var widget = gui.currentPageWidget(); // get the current wizard page
    if (widget != null) {
        widget.title = "New title."; // set the page title
        widget.MessageLabel.setText("New Message."); // set the welcome text
    }
}

Controller.prototype.TargetDirectoryPageCallback = function()
{
    gui.clickButton(buttons.NextButton); // automatically click the Next button
}

有关可在控制脚本中使用的JavaScript全局对象的更多信息，请参见Scripting API章节。

预定义的安装程序页面

QInstaller JavaScript对象提供对以下预定义安装程序页面的访问：
> 介绍
> 目标文件夹
> 组件选择
> 许可证检查
> 开始菜单选择
> 准备安装
> 执行安装
> 安装完成
buttons JavaScript对象提供了一组可在安装程序页面上使用的按钮。

以下各节描述了可与安装程序页面交互的用户可实现函数，以及每个页面上可用的小部件。

简介页面

实现Controller.prototype.IntroductionPageCallback()函数，用来与简介页面上的部件进行交互。

向导按钮：
> 下一步按钮
> 取消按钮

示例代码：

function Controller()
{
    var widget = gui.pageById(QInstaller.Introduction); // get the introduction wizard page
    if (widget != null)
        widget.packageManagerCoreTypeChanged.connect(onPackageManagerCoreTypeChanged);
}

onPackageManagerCoreTypeChanged = function()
{
    console.log("Is Updater: " + installer.isUpdater());
    console.log("Is Uninstaller: " + installer.isUninstaller());
    console.log("Is Package Manager: " + installer.isPackageManager());
}

许可协议页面

实现Controller.prototype.LicenseAgreementPageCallback()函数，用来与许可协议页面上的部件进行交互。

向导按钮：
> 下一步按钮
> 取消按钮
> 返回按钮

目标文件夹页面

实现Controller.prototype.TargetDirectoryPageCallback()函数，用来与目标文件夹选择页面上的部件进行交互。

向导按钮：
> 下一步按钮
> 取消按钮
> 返回按钮

组件选择页面

实现Controller.prototype.ComponentSelectionPageCallback()函数，用来与组件选择页面上的部件进行交互。

向导按钮：
> 下一步按钮
> 取消按钮
> 返回按钮

Installer Framework 3.1引入了存储库类别，作为一项新功能。 使用包含存储库类别的安装程序时，可以按其显示名称选择类别，获取其内容，然后选择包含的组件进行安装。

您可以从类别中获取组件，如下所示：

Controller.prototype.ComponentSelectionPageCallback = function()
{
    var page = gui.pageWidgetByObjectName("ComponentSelectionPage");

    // if CategoryGroupBox is visible, check one of the checkboxes
    // and click fetch button before selecting any components
    var groupBox = gui.findChild(page, "CategoryGroupBox");
    if (groupBox) {
        console.log("groupBox found");
        // findChild second argument is the display name of the checkbox
        var checkBox = gui.findChild(page, "Archive");
        if (checkBox) {
            console.log("checkBox found");
            console.log("checkBox name: " + checkBox.text);
            if (checkBox.checked == false) {
                checkBox.click();
                var fetchButton = gui.findChild(page, "FetchCategoryButton");
                if (fetchButton) {
                    console.log("fetchButton found");
                    fetchButton.click();
                } else {
                    console.log("fetchButton NOT found");
                }
            }
        } else {
            console.log("checkBox NOT found");
        }
    } else {
        console.log("groupBox NOT found");
    }
    // you can now select components from the fetched category
}

开始菜单文件夹页面

实现Controller.prototype.StartMenuDirectoryPageCallback()函数，用来与准备安装页面上的部件进行交互。

向导按钮：
> 下一步按钮
> 取消按钮
> 返回按钮

准备安装页面

实现Controller.prototype.ReadyForInstallationPageCallback()函数，用来与准备安装页面上的部件进行交互。

向导按钮：
> 提交按钮
> 取消按钮
> 返回按钮

执行安装页面

实现Controller.prototype.PerformInstallationPageCallback()函数，用来与执行安装页面上的部件进行交互。

向导按钮：
> 提交按钮
> 取消按钮

完成页面

实现Controller.prototype.FinishedPageCallback()函数，用来与安装完成页面上的部件进行交互。

向导按钮：
> 提交按钮
> 取消按钮
> 完成按钮

自定义页面

自定义页面被注册为Dynamic${ObjectName}，其中${ObjectName}是在UI文件中设置的对象名称。 因此，将调用Dynamic${ObjectName}Callback()函数。通过部件的对象名称（从UI文件）可以实现对部件的访问。

示例代码：

function Component()
{
    // add page with widget \c SomePageWidget before the target directory page
    installer.addWizardPage(component, "SomePageWidget", QInstaller.TargetDirectory)
}

Component.prototype.DynamicSomePageWidgetCallback = function()
{
    var page = gui.pageWidgetByObjectName("DynamicSomePageWidget");
    page.myButton.click, //direct child of the UI file's widget
    page.someFancyWidget.subWidget.setText("foobar") // nested widget
}

消息框

在执行安装程序时，例如，程序可能会显示一些有关发生错误的消息框。 在用户系统上运行程序时，这没问题，但这可能会破坏自动化测试套件。 为解决此问题，Qt Installer框架显示的所有消息框，均可通过特定标识符进行访问。

示例代码：

function Controller()
{
    installer.autoRejectMessageBoxes;
    installer.setMessageBoxAutomaticAnswer("OverwriteTargetDirectory", QMessageBox.Yes);
    installer.setMessageBoxAutomaticAnswer("stopProcessesForUpdates", QMessageBox.Ignore);
}

原文地址：https://www.cnblogs.com/codeForFamily/p/qt-install-framework-translate-7-3.html