扩展标识符

From Apache OpenOffice Wiki
Jump to: navigation, search


现在扩展拥有唯一的标识符。这就去除了以前不能部署两个具有相同文件名的扩展的限制。也就是说,两个拥有相同文件名但标识符不同的扩展可以被安装,而有相同标识符的两个扩展则无法都被安装。


标识符在 在线更新 中扮演重要角色。当运行在线更新时,扩展管理器将从扩展仓库或从已安装的扩展所指定的位置下载可用扩展的列表。接着扩展管理器将尝试比较已安装的扩展的标识符和 更新信息 中包含的标识符,来查询一个扩展在列表中的较新的版本。因此,标识符必须具有唯一性。这里还有一个情况,即理论上一样但支持不同的平台两个扩展。在这种情况下可以通过为标识符添加一个平台字串来获得唯一性。'目标平台' 章节说明了在编译环境中如何生成该字串。


技术上,扩展标识符是一个有限的 Unicode 标量值序列。标识符的识别采用逐个序列的元素的识别(没有大小写折叠,没有规范化等等)。它假设扩展的作者会协同保持扩展标识符的唯一性。按照习惯,使用小写的反向域名写法(例如:org.openoffice.)作为前缀来产生唯一(但可理解的)标识符。当编写扩展时,请使用你所拥有的站点的反向域名而不要用 org.openoffice. 作为前缀。以 org.openoffice.legacy. 作为前缀的标识符被保留给旧扩展使用(见下文)。 防止扩展标识符名称冲突使用同样的流程,这应用于扩展配置文件中所有的唯一名称(可扩展列表中的配置节点等)。


扩展标识符从扩展包含的 description.xml 中获得。如果扩展没有显式地指定扩展标识符,那么将在扩展(明显的 Unicode 标量值序列表示的)文件名基础上添加 org.openoffice.legacy. 来产生一个隐式标识符。(标识符的唯一性由假设来保证,即潜在的旧扩展管理不允许两个旧扩展有相同的文件名。)


也请参阅


Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages