Qt Installer Framework翻译(7-2)

2024-02-17 17:10:36

包文件夹

安装程序包含的组件，要么是内嵌的，要么可以从远程存储库加载。在这两种情况下，都需要为组件使用一种安装程序可以读取的文件格式和结构。

包文件夹结构

将所有组件放在相同的根文件夹中，即包文件夹。该文件夹的名称充当类似于域的标识符，用于标识所有组件。例如，com.vendor.root

在根文件夹中，创建名为data和meta的子文件夹。

包文件夹结构如下所示：

-packages
    - com.vendor.root
        - data
        - meta
    - com.vendor.root.component1
        - data
        - meta
    - com.vendor.root.component1.subcomponent1
        - data
        - meta
    - com.vendor.root.component2
        - data
        - meta

元文件夹

元文件夹包含多个文件，用于指定部署和安装过程的设置。安装程序不提取这些文件。该文件夹必须至少包含一个包信息文件，以及您在包信息文件中引用到的所有文件，例如脚本，用户界面文件和翻译文件。

包信息文件语法

package.xml文件是组件的主要信息来源。以下是示例：

<?xml version="1.0"?>
<Package>
    <DisplayName>QtGui</DisplayName>
    <Description>Qt gui libraries</Description>
    <Description xml:lang="de_de">Qt GUI Bibliotheken</Description>
    <Version>1.2.3</Version>
    <ReleaseDate>2009-04-23</ReleaseDate>
    <Name>com.vendor.root.component2</Name>
    <Dependencies>com.vendor.root.component1</Dependencies>
    <Virtual>false</Virtual>
    <Licenses>
        <License name="License Agreement" file="license.txt" />
    </Licenses>
    <Script>installscript.qs</Script>
    <UserInterfaces>
        <UserInterface>specialpage.ui</UserInterface>
        <UserInterface>errorpage.ui</UserInterface>
    </UserInterfaces>
    <Translations>
        <Translation>sv_se.qm</Translation>
        <Translation>de_de.qm</Translation>
    </Translations>
    <DownloadableArchives>component2.7z, component2a.7z</DownloadableArchives>
    <AutoDependOn>com.vendor.root.component3</AutoDependOn>
    <SortingPriority>123</SortingPriority>
    <UpdateText>This changed compared to the last release</UpdateText>
    <Default>false</Default>
    <ForcedInstallation>false</ForcedInstallation>
    <Essential>false</Essential>
    <Replaces>com.vendor.root.component2old</Replaces>
</Package>

包信息文件元素总结

元素	描述
DisplayName	组件的可读名称。强制项。可将组件名称的翻译指定为DisplayName的附加标签，并将xml:lang属性设置为正确的语言环境。
Description	组件的可读描述。强制项。可以参考DisplayName标签类似地指定翻译。如果找不到与语言环境匹配的本地化翻译，并且存在未翻译的版本，则将使用该版本。否则，将不会显示该语言环境的描述。用户可点击的外部链接，例如组件的主页，可以包括在组件描述中，通过指定如下URL地址:{external-link}='https://www.qt.io/'。该URL必须有效，并且包含所需资源的完整路径。
Version	组件版本的格式:[0-9]+((\.\|-)[0-9]+)*，例如1-1;1.2-2; 3.4.7。强制项。如果一个包需要显示子包的版本号而不是它自己的版本号（由于子包的分组），则可以使用需要继承该版本号的包名称，来指定InheritVersionFrom属性。
ReleaseDate	组件版本发布的日期。强制项。
Name	组件的类域标识。强制项。
Dependencies	逗号分隔的组件标识符列表，此组件的依赖项。可选的，你可以指定版本号，用破折号(-)分隔。您可以在版本号前使用比较运算符(=，>，<，>=或<=)。请记住，必须使用字符引用"<"来转义左尖括号（使用"<"代替"<"，使用"<="代替"<="）。可选项。有关更多信息，请参见组件依赖章节。
AutoDependOn	逗号分隔的组件标识符列表，本组件自动依赖。仅当所有指定依赖满足时，才安装本组件。如果其中某个组件自动依赖于其他组件，则组件树中该组件旁边的复选框将不可见。复选框自动进行选择。如果以前未安装过本组件，则仅当列表中的所有组件都被选择安装时，才可选择安装本组件。如果已经安装了本组件，当列表中选择了至少一个组件进行卸载时，则该组件也将被选择进行卸载。有关更多信息，请参见组件依赖章节。
Virtual	设置为true可以从安装程序中隐藏该组件。请注意，在根组件上设置此功能无效。
SortingPriority	树中组件的优先级。该树从最高优先级到最低优先级排序，最高优先级在顶部。
Licenses	用户将接受的许可协议列表。要添加多个许可证，请添加多个<License>子元素，每个都指定许可证名称和文件。许可证文件支持ASCII和UTF8文件格式。如果列出了此组件的翻译，安装程序还将查找翻译后的许可证。它们需要与原始许可证文件同名，但具有附加的语言环境标识符。例如，如果许可证文件名为license.txt，并指定了德语翻译，则安装程序还将包含license_de_de.txt文件（在德语系统上安装时显示）。
Script	正在加载的脚本的文件名。可选项。有关更多信息，请参见添加操作章节。
UserInterfaces	要加载的页面列表。要添加多个页面，请添加多个<UserInterface>子元素，每个指定页面的文件名。可选项。有关更多信息，请参见添加页面章节。
Translations	要加载的翻译文件列表。要添加多种语言变体，请指定多个<Translation>子元素，每个指定一种语言变体的文件名。可选项。有关更多信息，请参见翻译页面章节。
UpdateText	描述，添加到组件描述中。如果这是对组件的更新。可选的。
Default	可能的值为:true,false和script。设置为true，则预先选择安装程序中的组件。这仅对没有可见子组件的组件有效。 true和false会被直接评估，而script在运行时解析。在此文件中，添加脚本名，作为<Script>元素的一个值。有关示例脚本，请参见选择默认内容章节。
Essential	将包标记为必要的，用于强制重启MaintenanceTool。如果某个必要组件有可用的更新，则包管理器将保持禁用状态，直到该组件被更新为止。运行更新程序时，将自动安装新引入的必要组件。
ForcedInstallation	确定必须始终安装该包。用户无法在安装程序中取消选择。
Replaces	要替换的逗号分隔的组件列表。可选项。
DownloadableArchives	列出供在线安装程序下载的数据文件（用逗号分隔）。如果组件内部有一些数据，并且package.xml和/或脚本没有DownloadableArchives值，则repogen工具会自动注册找到的数据。
RequiresAdminRights	设置为true，如果需要使用提升的权限来安装包。可选项。
Checkable	设置为false，如果要隐藏项目的复选框。当仅应选择几个子组件而不是全部时，这很有用。可选项。
ExpandedByDefault	设置为true，如果要在树结构中默认扩展此项。可选项。

组件依赖

组件可以依赖一个或多个真实或者虚拟的组件。依赖通过组件标识或者可选的组件版本来定义。使用破折号（-）将版本号与标识符分开。

可以使用比较运算符(=，>，、<(<)，>=或<=(<=))作为版本号的前缀，以指示包的版本号，并与所需版本进行比较，并且必须等于、大于、小于、大于等于依赖项的版本号。如果没有给出比较运算符，则默认为=。

数据文件夹

数据文件夹包含安装程序在安装过程中要提取的内容。您必须将数据打包为.7zip存档（.7z）。您可以使用Qt Installer框架随附的archivegen工具，也可以使用其他生成7zip存档的工具。

码农公寓