Difference between revisions of "Zh/Documentation/DevGuide/Extensions/Extension Versions"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (New page: {{Documentation/DevGuide/ExtensionsTOC/Zh |ShowPrevNext=block |PrevPage=Zh/Documentation/DevGuide/Extensions/Extension Identifiers |NextPage=Zh/Documentation/DevGuide/Extensions/Target Pla...)
 
m
 
Line 9: Line 9:
 
随着时间的过去扩展会被不断的改进。这意味着,发行者要发布带有新功能和(或)修改补丁的相同扩展的新版本。加入“扩展版本”允许发行者发布新版本,并允许 {{PRODUCTNAME}} 检测和处理“由用户安装的扩展是一个已安装扩展的更新”这种情况。
 
随着时间的过去扩展会被不断的改进。这意味着,发行者要发布带有新功能和(或)修改补丁的相同扩展的新版本。加入“扩展版本”允许发行者发布新版本,并允许 {{PRODUCTNAME}} 检测和处理“由用户安装的扩展是一个已安装扩展的更新”这种情况。
  
技术上说,扩展版本 v 由一个无限的非负的实数序列来定义:v = ‹v<sub>0</sub>, v<sub>1</sub>, ...›,其中一些有限数量的元素值为零。全序是版本上通过字典序比较定义。版本 v 的文字表达 v = ‹v<sub>0</sub>, v<sub>1</sub>, ...› 就是一个从 BNF 创建的无限的字串
+
技术上说,扩展版本 v 由一个无限的非负的整数序列来定义:v = ‹v<sub>0</sub>, v<sub>1</sub>, ...›,其中除了一些有限数量的元素的值以外都为零。全序是版本上通过字典序比较定义。版本 v 的文字表达 v = ‹v<sub>0</sub>, v<sub>1</sub>, ...› 就是一个从 BNF 创建的无限的字串
  
 
   version ::= [element (“.” element)*]
 
   version ::= [element (“.” element)*]
 
   element ::= (“0” | “1” | “2” | “3” | “4” | “5” | “6” | “7” | “8” | “9”)+  
 
   element ::= (“0” | “1” | “2” | “3” | “4” | “5” | “6” | “7” | “8” | “9”)+  
  
拥有 n ≥ 0 个元素,每个元素是十进制表示的 v<sub>i</sub>(其中0 ≤ i < n),而对于 i ≥ n 每个 v<sub>i</sub> = 0。
+
拥有 n ≥ 0 个元素,每个元素是十进制表示的 v<sub>i</sub>(其中0 ≤ i < n),而对于 i ≥ n 每个 v<sub>i</sub> = 0。例如版本为 2.0.3.8.7,用上面表达式可理解为 v = ‹v<sub>0</sub>, v<sub>1</sub>, ...›;这里 n = 5,这个版本中一共包含有 5 个 元素,v<sub>0</sub> = 2,v<sub>1</sub> = 0,v<sub>2</sub> = 3,v<sub>3</sub> = 8,v<sub>4</sub> = 7;对于 i ≥ n 的元素,即 v<sub>5</sub>,v<sub>6</sub> 等被视为 0,也就是说 2.0.3.8.7 也被看作 2.0.3.8.7.0.0.0...。
  
The extension version is obtained from the description.xml contained in the extension. If the extension does not specify such an explicit version, then an implict textual version representation of the empty string (representing a version of all zeroes) is assumed.
 
  
No general semantics are prescribed to versions, other than the total order which determines whether one version is less than, equal to, or greater than another version, respectively. However, extension publishers are encouraged to use the widely accepted three-level scheme of major (incompatible changes), minor (compatible changes), micro (bug fixes) where applicable.
+
扩展版本可以从扩展包含的 description.xml 中获得。如果扩展没有显示指定版本,那么会采用一个隐式的的文本版本(为空字符串,用来表示一个零版本)。
  
  
'''See also'''
+
除了全序一般的语义没法指定版本,它判定一个版本是小于,等于或大于另一个版本。然后我们鼓励扩展发行者们在可行时使用已被广泛接收的“三层方案”,即 major (主要的修改,指不兼容的修改),minor(次要的修改,指兼容的修改)和 micro(细微的修改,指bug 修复)。
*[[Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/version|XML description for description.xml]]
+
 
*[[Documentation/DevGuide/Extensions/Example|Example of description.xml]]
+
 
 +
'''也请参阅'''
 +
*[[Zh/Documentation/DevGuide/Extensions/Description of XML Elements#Element /description/version|description.xml 的 XML 说明]]
 +
*[[Zh/Documentation/DevGuide/Extensions/Example|description.xml 示例]]
  
  
 
{{PDL1}}
 
{{PDL1}}
  
[[Category:Documentation/Developer's Guide/Extensions]]
+
[[Category:文档/开发者指南/扩展]]

Latest revision as of 05:48, 27 September 2008


随着时间的过去扩展会被不断的改进。这意味着,发行者要发布带有新功能和(或)修改补丁的相同扩展的新版本。加入“扩展版本”允许发行者发布新版本,并允许 OpenOffice.org 检测和处理“由用户安装的扩展是一个已安装扩展的更新”这种情况。

技术上说,扩展版本 v 由一个无限的非负的整数序列来定义:v = ‹v0, v1, ...›,其中除了一些有限数量的元素的值以外都为零。全序是版本上通过字典序比较定义。版本 v 的文字表达 v = ‹v0, v1, ...› 就是一个从 BNF 创建的无限的字串

 version ::= [element (“.” element)*]
 element ::= (“0” | “1” | “2” | “3” | “4” | “5” | “6” | “7” | “8” | “9”)+ 

拥有 n ≥ 0 个元素,每个元素是十进制表示的 vi(其中0 ≤ i < n),而对于 i ≥ n 每个 vi = 0。例如版本为 2.0.3.8.7,用上面表达式可理解为 v = ‹v0, v1, ...›;这里 n = 5,这个版本中一共包含有 5 个 元素,v0 = 2,v1 = 0,v2 = 3,v3 = 8,v4 = 7;对于 i ≥ n 的元素,即 v5,v6 等被视为 0,也就是说 2.0.3.8.7 也被看作 2.0.3.8.7.0.0.0...。


扩展版本可以从扩展包含的 description.xml 中获得。如果扩展没有显示指定版本,那么会采用一个隐式的的文本版本(为空字符串,用来表示一个零版本)。


除了全序一般的语义没法指定版本,它判定一个版本是小于,等于或大于另一个版本。然后我们鼓励扩展发行者们在可行时使用已被广泛接收的“三层方案”,即 major (主要的修改,指不兼容的修改),minor(次要的修改,指兼容的修改)和 micro(细微的修改,指bug 修复)。


也请参阅


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