银河中间件开发须知.pdfVIP

一、版本号对应

由于平台、中间件都处在完善阶段，期间可能会有修改和变动，每次更改和

变动都会有相应的修改记录和版本号。

应用需要根据库的版本号对应关系来选取相应的库，对应关系如下。

1.1平台接口版本号

################################################

##平台接口版本号：XXX

################################################

##数字XXX：平台接口版本号；

说明：该版本号由中间件定义，对应一份平台接口头文件和文档；平台在实现了这

份头文件发布时，需要在发布的压缩包文件名上注明平台接口版本号，以方便应用开发

人员查找相应版本的平台发布包。

此版本号修改后，说明中间件和平台之间的接口发生了变化，平台库及相关附件需

要重新发布。

备虑到各平台发布内容的不一致，中间件要求平台发布时版本号的第一位为

平台接口版本号，完整的平台版本号由各平台自己定义。

################################################

1.2中间件版本号格式说明

################################################

##格式：vX.XXX.XXXXX(.BX.XX)(.TXX)

################################################

##v：version简称

##第一区块数字：标识中间件对上接口版本；

说明：该版本号如果改变，表示应用和中间件第组件使用中间件的方式（包括

平台接口中的OS、FS部分）发生了变化；

第组件和应用需要修改接口变动的部分，然后重新编译。第还需要重新标

识版本号并发布；

##第二区块数字：标识平台接口主版本号；

说明：该版本号用于和平台发布库相版本号对应；

例如中间件版本v15.014.00001需要与平台V014版本的发布库相对应。

##第三区块数字：标识中间件代码的修本；

说明：如果中间件功能有增删、变动，或者发现Bug，经过修改，该版本号需

要更改；

##第四区块数字：分支版本号，不是中间件分支版本的不需要此区块版本号；

说明：只允许修改某一版本中间件代码的实现部分来产生分支，不允许修改中间件

的对上接口来产生分支。

例如：对中间件v15.014.00001修改产生的第一个分支的首个版本号为

v15.014.00001.B1.01，第二个分支的首个版本号为v15.014.00001.B2.01，分

支版本的平台接口和对应中间件主干版本的平台接口保持一致。

分支的修改，以v15.014.00001.B1.01版本为例，修改后版本号为

v15.014.00001.B1.02，15、014、00001.B1这些版本数字不会改变。

##第五区块数字：测试版本号，不是中间件测试版本的不需要此区块版本号；

说明：测试版本通常是针对某个地方的具体问题，中间件做修改所发布的版本。

与正式发布相比，测试版本通常只会生成该地方项目所选平台的中间件库，不会在所有

已知平台上生成对应的中间件库。分支版本上也可以产生测试版本。

例如：对中间件v15.014.00001修改产生的首个测试版本生成版本号为

v15.014.00001.T01;对中间件分支版本v15.014.00001.B1.01修改产生的首个

测试版本生成版本号为v15.014.00001.B1.01.T01。

################################################

1.3第版本号格式说明

################################