推广更新
创建在线安装程序,以便能够向安装产品的用户推广更新。
为了推广更新,需要执行以下步骤:
- 将待更新内容复制到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使用相对路径。