别名定义文件

别名定义文件定义了可用的组件别名及其属性。该文件通常命名为 aliases.xml 并位于 config 目录中。

Qt 安装器框架的组件名称遵循类似域的标识符语法，例如 com.vendor.root、com.vendor.root.subcomponent 等。虽然这允许在图形模式运行安装程序时轻松地从一个组件构建树，但这些名称在命令行使用时可能难以理解，因为在命令行中组件不会以树状视图显示。

除了依赖于类似域的名称在 CLI 使用之外，打包程序也可以为现有组件定义组件别名。别名是对单个组件或组件集合的另一种名称。它可用于声明现有组件的替代名称，这些名称更容易输入，并且可以在同一别名名称下组合多个组件，以便于选择。

以下示例显示了可能的别名定义文件

<?xml version="1.0"?>
<Aliases>
    <Alias>
        <Name>package-full</Name>
        <DisplayName>Full installation package</DisplayName>
        <Description>Complete installation of the product</Description>
        <Version>1.0.0</Version>
        <Virtual>false</Virtual>
        <RequiredAliases>package-essential</RequiredAliases>
        <RequiredComponents>com.vendor.root.extras</RequiredComponents>
        <OptionalAliases>package-optional</OptionalAliases>
    </Alias>
    <Alias>
        <Name>package-essential</Name>
        <DisplayName>Essential components</DisplayName>
        <Description>Essential components for the product</Description>
        <Version>1.0.0</Version>
        <Virtual>false</Virtual>
        <RequiredComponents>com.vendor.root.essential</RequiredComponents>
    </Alias>
    <Alias>
        <Name>package-optional</Name>
        <DisplayName>Optional components</DisplayName>
        <Description>Optional components for the product</Description>
        <Version>1.0.0</Version>
        <Virtual>false</Virtual>
        <OptionalComponents>com.vendor.root.optional1,com.vendor.root.optional2</OptionalComponents>
    </Alias>
</Aliases>

别名定义文件元素概要

以下表格总结了别名定义文件中的元素。

元素	描述
Name	组件别名的名称。
DisplayName	组件别名的可读名称。
描述	组件别名的可读描述。
Version	组件别名的版本号。
Virtual	设置为 `true` 以隐藏安装程序中的组件别名。这也会使别名对用户不可选择。
RequiredComponents	该组件别名所需的组件标识符的逗号分隔列表。当选择组件别名时，会选择组件进行安装。注意，组件必须能够被用户选择，因此无法选择虚拟或不可选择的组件。
RequiredAliases	该组件别名所需的别名的逗号分隔列表。当选择该组件别名时，会选安装所需的别名。
OptionalComponents	该组件别名可能依赖的组件标识符的逗号分隔列表。当选择组件别名时，如果组件存在并且可以由用户选择，则选择组件进行安装。
OptionalAliases	该组件别名可能依赖的别名的逗号分隔列表。当选择该组件别名时，如果别名存在，会选择列表中的别名进行安装。即使别名在安装程序中不存在，该别名也不会标记为不稳定。

配置文件控制器脚本