Qt Installer Framework翻译(5-3)

2024-04-08 09:51:15

推广更新

创建在线安装程序，以便能够向安装产品的用户推广更新。

为了推广更新，需要执行以下步骤：

将待更新内容复制到package文件夹。
在package.xml文件中增加待更新组件的元素的值。
使用repogen工具重新创建具有待更新内容的联机存储库，并在存储库的根目录中生成Updates.xml文件。
将存储库上传到Web服务器。
使用binarycreator工具创建安装程序。

配置更新

安装程序在启动时会下载Updates.xml文件，并拿该文件中的版本号与已安装的版本号进行比对。如果该文件中的在线版本号更大，则安装程序会在可用更新列表中显示该组件。

在package.xml文件中增加组件的元素的值。

重新创建存储库

提供更新的最简单方法是重新创建存储库，并将其上传到Web服务器。有关更多信息，请参见创建存储库章节。

存储库部分更新

以下情况，完整更新整个存储库可能不是最佳选择：

> 该存储库非常大，上传需要很长时间。
> 您只想交付更改的组件。
注意：repogen每次被调用时都会重新创建多个7zip存档。7zip存储所包含文件的时间戳（在此过程中，文件可能会被移动或复制），因此每个存档的SHA值的和都会发生变化。所有SHA值的总和用于验证下载的存档是否被篡改，因此SHA需要与7zip匹配起来。由于SHA值的总和存放在Updates.xml文件中，因此您将*上传整个存储库。可以通过使用repogen的--update选项来避免这种情况。

创建部分更新

重新创建在线存储库时，请使用--update参数。它以现有存储库作为输入，仅更改附加参数指定的组件。全局配置中也仅更改那些组件的SHA值的和。

上传部分更新

将以下项目上传到Web服务器：

> 组件目录（通常类似于com.vendor.product.updatedpart）。
> 存储在联机存储库的根目录中的全局Updates.xml。
注意：上传的顺序非常重要。如果在实时服务器上更新存储库，请首先更新组件，然后更新Updates.xml。包名称包含版本号，因此，用户在新的包完全上传之前，会收到旧的包。

变更储存库

要使当前更新用存储库指向其他存储库，请在当前存储库中编辑Updates.xml文件。您可以添加，替换或删除存储库。

<RepositoryUpdate>
  <Repository action="..." OPTIONS />
  <Repository action="..." OPTIONS />
</RepositoryUpdate>

添加存储库

要更新存储库，请使用以下选项将子元素添加到元素中：

<Repository action="add" url="http://www.example.com/repository" name="user" password="password" displayname="Example Repository" />

url元素将作为绝对URL来解析Updates.xml文件。如果url本身是相对的，它将在当前文档的绝对URL的基础上进行解析。

displayname用于在维护工具的“设置”页面中命名存储库。

名称和密码（可选）在受保护存储库中指定验证凭证。

删除存储库

要删除存储库，请使用以下选项将子元素添加到元素中：

<Repository action="remove" url="http://www.example.com/repository" />

url必须与要删除的存储库URL完全匹配。

更换储存库

要将一个存储库替换为另一个，请使用以下选项将子元素添加到元素中：

<Repository action="replace" oldUrl="http://www.example.com/repository" newUrl="http://www.example.com/newrepository" name="user" password="password" displayname="New Example Repository" />

oldUrl必须与要被替换的存储库URL完全匹配。

newUrl必须与要进行替换的存储库URL完全匹配。

重定位存储库

一些项目包含多个存储库。要创建可重定位的存储库集，您应该使用相对路径。

因此，如果地址为http://www.example.com/repositories/generic的基础存储库可用，斌且Updates.xml包含具有以下选项的元素：

<Repository action="add" url="../module" name="user" password="password" displayname="Module Repository" />

这样，添加的存储库的解析地址将变为http://www.example.com/repositories/module，以便该存储库不包含有关其绝对位置的信息。

如果要更改地址，只需按原样复制存储库集即可。建议将旧的存储库保留一段时间，并如上所述替换新的地址。您还可以为更新程序提供新的基础地址。

您可以在元素中为参数url，oldUrl和newUrl使用相对路径。

码农公寓