开始菜单快捷方式示例

使用组件脚本向 Windows 开始菜单添加条目。

开始菜单展示了如何使用组件功能将用于打开 README 文件的条目添加到 Windows 开始菜单。

配置示例安装程序

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

<Name> 元素设置应用程序名称并将其添加到页面名称和介绍文本中。
<Version> 元素设置应用程序版本号。
<Title> 元素设置安装程序名称并在标题栏上显示。
<Publisher> 元素设置软件的发布者（例如，如 Windows 控制面板中所示）。
<StartMenuDir> 元素设置 Windows 开始菜单中产品的默认程序组名称。
<TargetDir> 元素设置默认目标目录位置，位于当前用户家目录中的 IfwExamples 目录内（因为它使用预定义变量 , @HomeDir@, 作为值的一部分）。有关更多信息，请参阅预定义变量。

<?xml version="1.0" encoding="UTF-8"?>
<Installer>
    <Name>Start Menu Shortcut Example</Name>
    <Version>1.0.0</Version>
    <Title>Start Menu Shortcut Example</Title>
    <Publisher>Qt-Project</Publisher>
    <StartMenuDir>Qt Installer Framework Examples</StartMenuDir>
    <TargetDir>@HomeDir@/IfwExamples/startmenu</TargetDir>
</Installer>

创建示例包信息文件

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

<DisplayName> 元素设置组件的易读名称。
<Description> 元素设置组件的易读描述。
<Version> 元素设置组件的版本号。
<ReleaseDate> 元素设置此组件版本的发布日期。

<Default> 元素设置为 true 以在安装程序中预选组件。
<Script> 元素指定要执行操作而加载的 JavaScript 文件名。

<?xml version="1.0" encoding="UTF-8"?>
<Package>
    <DisplayName>README.txt</DisplayName>
    <Description>A README.txt, accessible through a start menu entry.</Description>
    <Version>1.0.0-1</Version>
    <ReleaseDate>2013-01-01</ReleaseDate>
    <Default>true</Default>
    <Script>installscript.qs</Script>
</Package>

在 installscript.qs 中，我们使用 createOperations() 函数调用 component::createOperations() 函数，默认创建一个 Extract 操作

Component.prototype.createOperations = function()
{
    component.createOperations();

在 Windows 上，我们使用 component::addOperation 函数将快捷方式添加到开始菜单中以打开 README 文件

    if (systemInfo.productType === "windows") {
        component.addOperation("CreateShortcut", "@TargetDir@/README.txt", "@StartMenuDir@/README.lnk",
            "workingDirectory=@TargetDir@", "iconPath=%SystemRoot%/system32/SHELL32.dll",
            "iconId=2", "description=Open README file");
    }
}

生成示例安装程序

要创建示例安装程序，切换到命令行上的示例源目录并输入以下命令

在 Windows 上

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

在 Linux 或 macOS 上

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

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

文件

开始菜单快捷方式示例

配置示例安装程序

创建示例包信息文件

向开始菜单添加条目

生成示例安装程序