软件版本管理规范26072
软件版本管理规范
软件版本管理规范软件版本管理是软件开发过程中非常重要的一环,它对于保证软件的稳定性、可靠性和持续改进至关重要。
本文将介绍软件版本管理的规范,并提供一些最佳实践方法。
1. 版本管理概述软件版本管理是指对软件开发过程中产生的各个版本进行有效的记录、追踪和控制的过程。
通过版本管理,开发人员可以更好地管理和控制软件的迭代过程,快速回溯和解决问题,并进行版本发布和部署。
2. 版本控制系统选择为了进行有效的软件版本管理,选择合适的版本控制系统是至关重要的。
目前,常用的版本控制系统包括Git、SVN等。
在选择版本控制系统时,应考虑团队规模、项目需求、安全性和易用性等因素。
3. 分支管理策略分支是版本管理中的一个重要概念,它可以用来组织和管理不同功能或者不同版本的代码。
在进行分支管理时,应采用适当的策略,例如主分支只用于发布稳定版本,开发人员在从主分支拉取新分支进行开发等。
4. 版本命名规范为了方便追踪和识别版本,应采用一致的版本命名规范。
常用的版本命名规范包括主版本号、次版本号和修订号,例如1.0.0。
在进行版本升级时,应遵循一定规则,例如主版本号的升级表示不兼容的变更,次版本号的升级表示向下兼容的功能性变更,修订号的升级表示修复bug或者进行优化。
5. 版本发布和部署流程版本发布和部署是软件开发中的关键环节之一。
为了确保发布和部署的顺利进行,应建立相应的流程和规范。
例如,在进行版本发布前,应进行相关测试,包括单元测试、集成测试和回归测试等。
发布后,还应做好版本的文档更新、用户通知和性能监控等工作。
6. 版本记录和变更日志为了追踪和记录每个版本的变更情况,应建立完善的版本记录和变更日志。
版本记录可以包括版本号、发布日期、变更内容、责任人等信息,而变更日志则可以详细描述每个版本的新增、修改和删除的功能点。
7. 版本回退和紧急修复在软件开发过程中,可能会出现某个版本存在严重问题的情况,需要进行回退或者紧急修复。
为了应对这种情况,应建立相应的应急处理流程和规范,例如定期备份代码、建立热修复机制等。
软件版本管理规范
软件版本管理规范软件版本管理规范一、引言在软件开发过程中,版本管理是非常重要的一环。
它确保了软件的变更能够被跟踪、管理和控制。
有效的版本管理可以提高开发效率,减少错误,促进团队协作。
本规范旨在定义一种通用的、一致的、可扩展的软件版本管理方法,以确保软件项目的顺利进展。
二、版本管理系统的选择1.确定需求:在选择版本管理系统之前,首先要明确团队的需求。
考虑团队规模、项目复杂性、代码库大小等因素。
2.市场调研:收集市场上流行的版本管理系统的信息,评估它们的优点和缺点。
考虑系统的易用性、稳定性、可扩展性和成本效益。
3.选择合适的系统:根据项目需求和市场调研的结果,选择最适合团队的版本管理系统。
常见的版本管理系统包括Git、Subversion(SVN)、Mercurial等。
三、版本管理流程1.代码审查:实施代码审查制度,确保代码质量,减少错误。
可以采用PullRequest、Code Review等方式进行。
2.提交代码:每次提交代码前,确保代码符合团队的编码规范和标准。
提交的代码应该有一个明确的描述,以帮助其他开发者理解本次提交的内容。
3.测试:在提交代码之后,进行自动化测试和手动测试,确保代码的质量和稳定性。
测试包括单元测试、集成测试和系统测试等。
4.发布:经过测试后,将代码发布到生产环境。
在发布前,应进行最后一次代码审查,以确保生产环境的稳定性。
5.维护:在生产环境中,对软件进行维护和监控,确保其正常运行。
当发现问题时,及时修复并发布修复版本。
四、版本管理规范1.编码规范:制定并遵守统一的编码规范,包括命名规范、缩进风格、注释规则等。
这样可以提高代码的可读性和可维护性。
2.提交信息:每次提交代码时,确保提交信息清晰、简洁地描述所做的更改和原因。
这将有助于其他开发者了解代码变更的内容和目的。
3.代码审查:实施严格的代码审查制度,确保代码质量和可维护性。
所有提交的代码必须经过代码审查,并且只有在通过审查后才能被合并到主分支。
软件版本管理规范
XXXX公司技术文件软件版本管理规范XXXX公司二○一八年一月目录第1章引言 .................................................... - 1 -1.1 目的 ................................................... - 1 -1.2 适用范围 ............................................... - 1 -1.3 术语定义和缩写词 ....................................... - 1 -1.4 统一大小写 ............................................. - 1 -1.5 参考资料 ............................................... - 1 -第2章版本规范 ................................................ - 2 -2.1 版本格式 ............................................... - 2 -2.2 版本升级规则 ........................................... - 2 -第3章 TAG 规范 ................................................ - 3 -3.1 TAG 转换规则 ........................................... - 3 -3.2 版本 TAG ............................................... - 3 -3.2.1 ALPHA测试 TAG .................................... - 3 -3.2.2 BETA测试 TAG ..................................... - 3 -3.2.3 Release TAG ...................................... - 3 -3.2.4 产品基线 TAG ..................................... - 4 -第4章 BRANCH 规范 ............................................. - 5 -4.1 固定后缀 ............................................... - 5 -4.2 BRANCH 转换规则 ........................................ - 5 -4.3 项目 BRANCH ........................................ - 5 -I第1章引言1.1目的通过该文档来统一、规范公司的所有软件产品的版本管理,使得版本管理更加正式和有效。
软件版本管理规定
信息系统软件版本管理办法第一章总则第一条为加强软件版本管理,规范软件版本管理工作流程,提高版本运行维护质量,保证信息系统安全可靠高效地运行,特制定本办法;第二条本办法涉及的软件包括在线运行的软件和拟投产的软件;软件版本管理对象包括应用软件版本以及相关操作系统、数据库、中间件等基础软件;第三条软件版本管理是信息系统开发管理和日常维护管理工作的一个重要组成部分,本办法作为软件版本管理的重要依据,软件版本管理归口管理部门、业务支撑部门、风险管理部门、内审部门及各软件供应商要认真履行各自职责,严格执行软件版本管理的各项流程和规定,保障信息系统的安全稳定运行;第四条任何未经版本归口管理部门许可的软件版本不允许在生产环境使用;在商务合同中若涉及信息系统软件版本,应确认为版本归口管理部门允许使用的软件版本;因使用未经许可的软件版本而造成系统故障影响正常业务交易,相关部门及各厂商要承担相应的责任;第五条本办法由信息技术部负责解释和修订,自发文之日起开始执行;第二章组织与职责第六条软件版本管理实行总行集中管理体系;第七条信息技术部是信息系统软件版本的归口管理部门;第八条稽核监控部是信息系统软件版本管理的内审部门;第九条风险管理部是信息系统软件版本管理的风险控制部门;第十条信息系统软件版本管理工作还涉及软件提供商,软件提供商包括软件最终提供商、代理商和维保服务商以下简称厂商;第一节归口管理部门职责第十一条归口管理部门负责制定和完善的软件版本管理办法;第十二条归口管理部门负责制定信息系统软件版本管理工作的工作计划、工作要求和技术规范,并组织实施;第十三条归口管理部门负责审批业务支撑部门上报的版本变更申请,组织进行资料审核和上线测试,安排试运行工作及全行推广实施;第十四条归口管理部门负责建立软件版本信息库,发布软件版本管理各类信息;建立版本预警体系,发布软件版本缺陷信息和版本预警信息;第十五条归口管理部门负责与业务支撑部门、风险管理部门、内审部门、厂商协调信息系统软件版本管理的相关工作;第三节业务支撑部门职责第十六条版本管理业务支撑部门负责业务类需求的日常收集和集中收集;第十七条版本管理业务支撑部门负责发起新版本的试运行申请;第十八条版本管理业务支撑部门负责协助归口管理部门审核新版本发布资料包括申请、厂家及仿真环境测试报告、版本说明文档、升级方案、测试方案等,并协助归口管理部门开展新版本试运行测试工作;第十九条版本管理业务支撑部门负责自查并督促其下属机构履行职责,严格执行版本管理相关制度和流程;第四节风险管理部门职责第二十条版本管理风险管理部门负责重大版本发布前的风险评估;第五节内审部门职责第二十一条版本管理内审部门负责监督和检查版本管理归口管理部门、业务支撑部门、风险管理部门和厂商是否严格执行版本管理的相关制度与流程;第五节厂商义务第二十二条信息系统厂商应严格遵守软件版本管理的规章制度、技术规范;第二十三条信息系统厂商应根据业务发展及运行维护的需要及时更新版本,保证在线运行的软件版本是允许使用的版本;第二十四条信息系统厂商应配合软件版本归口管理部门进行软件仿真测试,及时提供各类运行维护及仿真测试所需的文件资料和技术咨询,并对这些材料的真实性、可靠性和实时性负责;在不具备相应仿真测试环境的情况下,厂商有义务提供仿真环境配合开展测试;第二十五条信息系统厂商应配合进行试运行工作;厂商应根据版本变更情况选择能够测试所有升级功能点的分支机构,并结合用户量、安全性等的要求向提出试验点建议;第二十六条信息系统厂商应配合做好信息系统软件版本管理工作,建立本厂家信息系统软件版本管理资料库信息,协助软件版本归口管理部门做好版本预警信息的发布与管理,提供必要的技术资料和技术支持;第二十七条信息系统厂商应指定专门的版本管理联系人与软件版本归口管理部门衔接,以便配合进行软件的升级实施和及时跟踪处理升级过程中或者升级后出现的各种故障;第二十八条信息系统厂商有义务在升级过程中按照的要求配合完成各项工作,包括协助软件版本归口管理部门模拟重现升级或试运行期间出现的和软件版本相关的故障;第二十九条信息系统厂商有义务在工程招标书中,承诺按照版本管理相关制度和流程履行投标方的义务;第三章版本管理内容与流程第三十条信息系统软件版本分为版本和补丁;版本是指软件系统中的核心部分发生结构性变化、应用部分新增若干功能而生成的软件版本;补丁是指软件系统中不涉及核心部分的变化,只是应用部分的故障修复或功能完善而生成的软件版本;第三十一条版本管理的各项工作必须按照规定的操作流程执行,各相关部门应认真履行本部门的职责,做好部门之间的衔接和协调;第三十二条版本管理工作内容主要包括需求管理、认证管理、变更管理、评估管理和信息管理;其中,需求管理是通过收集、整理和分析版本的新特性需求或未修复缺陷,引导厂家新版本开发,确定待认证的版本;认证管理是依据技术规范,对厂家待认证版本的符合性和可用性进行认证,并对已认证版本进行更新或废止管理;变更管理是对生产运行版本变更的技术审核和流程管控;评估管理是对生产运行版本的版本能力、缺陷等方面的评价和管理;信息管理是对全行软件版本信息及版本管理工作各环节输出信息的动态管理,主要包括信息的收集、整合、关联、更新、价值挖掘和全行共享,是版本管理各项工作的基础;第一节需求管理第三十三条版本需求管理主要分为业务类需求管理和运行维护类需求管理两大类,两大类需求的特点如下:(一)业务类需求:包括对原有业务模型、业务流程进行变更完善的需求,对新业务模式、新业务功能的支撑需求以及与业务推广能力相关的需求等;(二)运行维护类需求:包括运维监控类需求、系统软件版本缺陷和问题解决需求等与运行维护工作直接相关的需求;第三十四条运行维护类需求由信息技术部系统运行中心以下简称运行中心牵头收集整理,业务类需求由信息技术部系统开发中心以下简称开发中心牵头收集整理,最终由软件版本归口管理部门负责进行统一梳理后落实到建设项目中,组织技术规范的修订;第三十五条需求收集分为两种:日常收集和集中征集;(一)日常收集:业务类需求由需求提交部门发起,开发中心收集整理,运行维护类需求由运行中心不定期向综合部提交新需求并填写软件版本需求汇总表见作为附件;(二)集中征集:在专项治理工作中,由专项治理工作归口管理部门发起、在规定时期内征集各方需求,然后统一汇总整理,向需求归口管理部门提交新需求并填写软件版本需求汇总表见作为附件;第二节认证管理第三十六条软件新版本的认证过程包括仿真环境测试和生产环境试运行测试;第三十七条仿真环境测试主要测试内容包括:版本差异化测试新增功能测试、功能变更测试、故障修复有效性测试、新版本回归性验证测试即原有功能点的测试、新版本的升级过程测试、性能测试、业务功能测试等;由厂商自行组织的内部测试也应涵盖上述测试内容;第三十八条原则上,业务类需求导致的新软件版本由信息技术部开发中心组织进行仿真环境测试;运行维护类需求导致的新软件版本由信息技术部运行中心组织进行仿真环境测试;如果新版本包含以上两方面的需求,则由软件版本归口管理部门统一组织新版本的仿真环境测试;新版软件正式开始测试前,厂商应向上述部门提交相关技术资料和说明书;说明书中应包含以下内容:(一)软件版本变更的原因及必要性,新版软件与旧版软件的差异性说明、新增功能说明、新版软件对硬件环境的要求、涉及第三方的软件版本说明;(二)维护手册及有关资料变更部分;(三)新版软件对所在平台及所承载业务的影响以及对相连的系统的影响以及相关接口包括第三方接口变化的说明文档;(四)新版本的历史应用情况,已知缺陷、隐患或与需求含商务需求、设计需求、业务需求、运维需求等不符之处并列出解决方案;(五)对新版软件进行测试的测试方案,包括测试所用的软硬件环境、测试项目及具体测试方法步骤、测试环境要求及预期结果;(六)详细的升级方案及针对各种异常情况的应急预案,升级失败的应急回退方案等;(七)厂商内部测试情况报告;第三十九条对于信息系统软件新版本的仿真环境测试原则上应在提供的仿真环境中进行,对不具备测试条件的,厂商须提供相应的仿真环境;厂商应在测试前,配合进行仿真环境的准备工作;仿真环境应能对版本进行尽量完整的测试;第四十条对于仿真环境下无法测试的测试用例,经归口管理部门审核后可在试运行阶段再进行测试;第四十一条因版本质量问题导致不能完成测试或测试报告结论为不通过的,需由厂商修改问题后重新测试;测试完成后测试单位应向软件版本归口管理部门提交新版本的测试报告XX系统XX版本测试报告见;测试报告文档应包含内容:(一)测试原因(二)测试环境拓扑图(三)测试所需软硬件及其他工具可选(四)基本连接和配置可选(五)测试项目及具体测试方案(六)测试结论包含测试情况如何,该版本功能是否完善,是否符合申请内容以及升级建议等第四十二条对于测试中不满足要求的项目,厂商应给出相应的改进承诺和时间表;第四十三条完成版本测试后,业务支撑部门应向软件版本归口管理部门提出试运行建议申请,并填写XX系统XX版本试运行建议表详见附表四,由软件版本归口管理部门发布新版本的试运行通知;第四十四条信息系统的试运行升级申请应至少在升级日期前七个工作日提交到软件版本归口管理部门,软件版本归口管理部门在收到升级申请后的四个工作日内完成批复,试运行准备时间不少于三个工作日;在紧急情况下,试运行申请至少提前四个工作日提交到软件版本归口管理部门,软件版本归口管理部门在收到申请后两个工作日内完成批复,试运行准备时间不少于两个工作日;升级方案所需要的内容具体参见;第四十五条软件版本归口管理部门组织审核测试报告、升级方案及试运行资料,并填写XX系统XX版本试运行资料审核报告详见;第四十六条重大版本变更厂商在试运行升级时应派专人在现场给予技术支撑,协助定位解决问题;第四十七条软件版本归口管理部门负责组织开展试运行工作,密切关注新版本的运行情况,业务支撑部门应按照试运行测试要求和用例进行完整测试,及时填报测试结果;原则上,试运行时间应不少于三个月;试运行结束后,提交XX系统XX版本试运行报告详见;第四十八条试运行测试完成、确认新版本安全稳定后,由信息技术部在运维管理系统发布新版本相关信息;第四十九条在新版本运行期间若出现涉及危害平台安全、影响业务运行、对客户感知造成重大影响的问题,由业务支撑部门填写XX系统XX版本软件变更申请表见,软件版本归口管理部门在两个工作日内审核回复,组织厂商、信息技术部执行版本回退或修复工作;第五十条厂商应在版本升级后五个工作日内提交版本升级故障分析报告;第五十一条厂商用于投标的软件版本以及新工程中使用的软件版本,均需由厂商向软件版本归口管理部门提出新版本测试申请,按本节管理要求开展测试认证;软件版本归口管理部门和总行验收领导小组应在工程验收时对其使用的软件版本进行检查、把关,确认工程项目中所使用的软件版本是经过测试认证的;第三节变更管理第五十二条版本变更主要指版本和补丁的投入与使用,管理工作主要包括版本升级、补丁输入的申请与审批、版本升级方案含应急措施、测试用例等的制定与审批、升级成功后的资料移交和更新等;第五十三条软件版本升级按发起方不同分为两种:(一)软件版本归口管理部门安排布置的版本升级任务,主要是为了满足总行提出的对全行信息系统的基础建设或维护的需求;(二)业务支撑部门主动提交的版本升级申请XX系统软件变更申请表见,主要是为了满足某个业务需求;第五十四条为了保证平台安全稳定运行,原则上每种平台每月升级次数不超过一次,承载不同业务的平台不安排在同一时间升级;第五十五条软件版本归口管理部门发布批准使用新版本的信息后,总行各业务部室或分支机构可以根据实际情况更换新版本;第五十六条升级方案包含但不限于以下内容:(一)升级目的(二)升级内容(三)各方工作人员职责(四)升级各步骤的时间估算(五)升级涉及范围及对业务的影响(六)具体升级步骤1.升级准备工作及注意事项2.升级操作详细步骤3.升级应急预案和应急预案启动条件4.业务测试用例(七)升级完成核对的内容及步骤(八)备品、备件的升级升级时间、地点、方式(九)运行观察(十)资料归档第五十七条升级过程中间出现升级方案中未预料到的业务中断或中断时间超出预定时间等异常情况时,软件升级工作应立即停止,按照升级方案中的应急预案进行操作,并逐级上报;第五十八条在升级结束后业务支撑部门将升级完成情况汇总,填写XX系统XX版本使用情况汇总表见,在升级完成一周后上报软件版本归口管理部门备案;第五十九条升级结束后,厂商必须向移交:(一)各级用户密码;(二)监控和应用软件的安装程序必须经过测试;(三)设备的详细配置资料;(四)设备维护手册的追加与变更;第四节评估管理第六十条评估管理是对生产环境运行版本的评估,主要包括版本能力、版本缺陷和预警等的管理和评价;版本评估结果是对已认证版本进行更新或废止的重要依据;第六十一条版本变更后,软件版本归口管理部门需跟踪新版本的使用情况,组织版本运行评估工作,对新版本满足业务功能、运行维护管理等需求的能力进行评估;如果新版本能力不足、且认证库中已存在满足需求的版本,则可将此已认证版本作为目标版本适时实施版本变更;如果新版本能力不足、且认证库中不存在满足需求的版本,则将关于新版本使用中所出现问题的评估结果提交版本管理归口管理部门;软件版本归口管理部门对评估结果进行分析,对于当前暂不需要解决的版本遗留问题进行汇总;否则输出至需求归口管理部门进行处理;第六十二条预警定义:预先对因设备软硬件版本缺陷而可能导致业务系统或设备含在线设备和拟投产运行的设备不能正常运行的因素进行警示并防范;版本缺陷的预警管理是保证在线安全、稳定运行的重要措施之一;第六十三条软件版本归口管理部门根据全行在线版本的业务和维护支撑能力、缺陷发生数量及影响、版本变更次数及原因、上线时间等因素,于每年12月20日之前提交年度版本运行评估报告;第五节信息管理第六十四条建立软件版本信息管理体系,实现全行软件版本信息及版本管理工作各环节输出信息的收集、整合、关联、共享、价值挖掘和动态管理;第六十五条软件版本归口管理部门按照统一的版本信息模型,每月初通过运维管理系统提交“全行软件版本使用情况汇总表”见并对汇总信息进行入库和维护更新管理;第六十六条软件版本归口管理部门及时发布版本信息,以便各分支机构和总行各业务部室正确选择使用的版本;各相关单位负责收集、整理、分析辖区内软件版本相关信息,并进行及时更新;版本信息库上包括但不限于以下所示:(一)各厂商的软件版本的状况,包括:版本编号、功能变更说明书、上线测试报告、核准上线日期等;(二)各厂商的软件版本在生产环境中的运行情况,包括:投入运行时间、版本分布情况、主要设备配置、版本的问题等;(三)版本问题登记,包括:软件版本、问题发生时间、原因、现象、影响、排除方法、排除时间及善后处理意见等;(四)其它相关资料,包括:技术标准、企业规范、新业务、新功能的需求汇总、论文资料等;第六节版本管理流程第四章监督与检查第六十七条版本管理内审部门将适时组织检查信息系统的软件版本管理工作情况,并及时通报检查结果;结合本年度全行在线版本管理各项工作情况,于每年底发布全行年度在线版本管理工作情况通报;对于因版本管理不善或使用未经许可的软硬件版本而造成的业务中断故障、用户投诉及经济损失等,内审部门将视具体情况对相关部门、负责人或直接责任人给予通报批评,并反映在部门考核指标中;第六十八条归口管理部门在进行“外包商服务质量评估”时,应将厂家软件版本运行评估情况及对版本管理工作的支撑情况作为评估内容之一,并将评估结果作为采购评标的重要考虑因素;在维保合同中应增加版本管理工作相关要求的条款,并进行相关考核;对于因厂家原因造成的业务中断故障及由此产生的损失,将视具体情况对相关厂家给予处罚并追究相关责任;附表一:XX业务软件需求汇总表附表二:软件版本测试申请表附表三:XX系统XX版本/补丁测试报告XX系统软件版本/补丁测试报告1.测试概况测试目的2.测试环境网络结构图3.测试内容对测试情况的描述4.测试结论测试通过或测试不通过,测试不通过请说明原因;附表四:XX业务XX版本试运行建议表附表五:XX业务XX版本试运行资料审核报告附表六:XX业务系统试运行报告附表七:XX软件变更申请表附表八:XX业务系统软件版本使用情况汇总表。
软件配置版本管理规范
软件配置版本管理规范一、本文概述本文旨在建立一个标准的软件配置版本管理规范,以确保软件开发过程中的配置和版本控制的一致性和有效性。
软件配置管理是软件开发过程的重要组成部分,它能够协调软件开发团队的工作,确保软件产品的质量和可维护性。
二、软件配置版本管理的重要性软件配置版本管理对于软件开发过程具有以下重要性:1、配置一致性:通过版本控制,可以确保所有开发人员使用相同的配置,从而避免混淆和冲突。
1、配置一致性:通过版本控制,可以确保所有开发人员使用相同的配置,从而避免混淆和冲突。
在软件开发过程中,每个开发人员都需要使用相同的代码库、工具和环境。
如果每个开发人员都在自己的本地环境中进行修改,那么很容易出现配置不一致的情况,导致代码冲突和难以维护的问题。
因此,版本控制可以帮助开发团队保持配置一致性,确保每个人都在同一个版本上进行开发和测试,从而避免不必要的麻烦和浪费时间。
版本控制还可以在代码更改时进行记录,跟踪每个文件的修改历史。
这样,如果有任何问题出现,开发团队可以迅速定位问题并找出责任人,以便更快地解决问题。
版本控制还有助于管理代码的变更和合并,使得多个开发人员可以同时对同一代码库进行修改,避免单点故障和代码丢失的风险。
总之,通过版本控制可以确保开发团队的配置一致性,提高开发效率和质量。
因此,在软件开发过程中,必须遵循相应的版本控制规范,确保代码库的完整性和可维护性。
2、问题追踪:版本控制可以帮助开发团队追踪和管理问题,以及时发现和解决问题。
在软件开发过程中,问题追踪和版本控制密不可分。
版本控制可以帮助开发团队实现代码管理,记录代码的每一次修改和变更,从而方便追踪问题的起源和解决。
通过版本控制,开发团队可以及时发现和解决问题,避免因重复工作和无效操作而浪费时间和资源。
当出现问题时,开发团队可以迅速定位到具体的代码版本,找出问题的原因并采取相应的措施。
此外,版本控制还能帮助开发团队在多人协作开发中避免冲突和混乱,确保各个成员的工作能够顺利集成。
软件版本管理规范
软件版本管理规范软件版本管理规范一、引言随着信息技术的快速发展,软件已成为各行各业运营和发展的重要支撑。
软件版本管理是软件开发过程中不可或缺的一环,对于保证软件质量、控制变更、促进团队协作和知识共享具有重要意义。
为了规范公司内部的软件版本管理,提高软件开发效率和质量,降低维护成本,特制定本管理规范。
二、版本管理规范目标本管理规范旨在明确软件版本管理的规范目标,包括以下几个方面:1.保证软件版本的准确性和一致性;2.控制软件版本的变更,保证变更的合理性和规范性;3.促进团队成员之间的协作和知识共享;4.为软件配置管理提供基础数据支持;5.提高软件开发效率和质量,降低维护成本。
三、版本管理规范原则在进行软件版本管理时应遵循以下原则:1.唯一性原则:每个版本应具有唯一的标识符,以便区分和管理;2.标准化原则:版本号应遵循通用的编码规则,以便于阅读和理解;3.实时更新原则:版本应随着软件功能的增加、修改或删除而实时更新;4.记录完整原则:版本变更的历史记录应完整保存,以便追踪和查询;5.安全性原则:版本管理过程中应确保数据的安全性,避免泄露和损坏。
四、版本管理规范流程软件版本管理应遵循以下流程:1.制定版本计划:根据软件开发计划,制定相应的版本计划,明确各阶段的版本发布时间和内容;2.创建版本:按照计划,创建各阶段的版本,并为每个版本分配唯一的标识符;3.版本审批:在创建版本后,应将版本提交给相关人员进行审批,以确保版本的准确性和完整性;4.版本发布:经过审批后,将版本发布至指定平台或范围,以供用户下载和使用;5.版本更新:在软件开发过程中,如需对已发布版本进行修改或升级,应按照本管理规范进行相应的变更管理;6.版本维护:对于已发布版本,应定期进行维护和更新,以确保版本的稳定性和安全性;7.版本归档:在完成特定阶段或项目的开发后,应对相应版本的文档、代码等进行归档和备份。
五、版本管理规范措施为确保本管理规范的有效实施,应采取以下措施:1.培训宣传:组织公司内部培训和宣传活动,让全体员工了解并掌握本管理规范的相关规定和要求;2.制定规范:制定详细的软件版本管理规范,明确各环节的具体操作流程和标准;3.配置管理工具:选择合适的配置管理工具,如Git、SVN等,用于进行版本的存储、追踪和管理;4.设立专责机构:设立专门的版本管理机构或岗位,负责执行和管理公司的软件版本管理工作;5.监督检查:定期对公司的软件版本管理工作进行监督和检查,发现问题及时处理和改进。
软件版本管理规范
软件版本管理规范软件版本管理规范1.目的与范围为规范软件版本的规划、构建、移交和发布过程,特制定本规范。
本规范适用于富岛所有软件版本的管理过程。
2.制定月度版本计划1、每月初,产品经理制定本月的版本计划。
版本计划中应包含转测试版本及最终发布生产版本。
2、版本计划内容包含:版本号、版本用途、版本主要变动点、计划发布时间、发布责任人,参见《版本计划模板》。
3、版本范围必须来自文档化的需求与问题清单,口头传递的内容不得作为工作依据。
4、产品经理、测试经理、交付服务代表一起评审确认版本计划。
3.版本构建1、每个软件子系统应指定版本发布负责人,负责编译、构建版本。
2、构建版本时必须保证所有相关代码都已提交到配置库。
发布负责人从配置库主线取最新源代码,使用的编译、构建工具的型号和版本号必须统一。
3、不得随意变更编译构建工具的版本,如有工具切换或升级需求需提出建议,并评估切换的影响,经过产品经理同意后方可执行切换。
4.版本转测试1、版本发布负责人组织研发自测,输出研发自测报告。
2、版本发布负责人输出《版本转测试说明》,说明版本基本信息、主要变更点、自测结果及测试建议。
3、版本发布负责人将完成开发自测的版本、配套的手册、自测报告、版本转测试说明一起归档到服务器。
4、版本发布负责人邮件发送转测试通知,并将版本转测试说明附在邮件中。
通知发送给产品经理、测试经理、质量代表,抄送项目全体成员。
5.版本发布1、版本正式发布给生产前,版本发布负责人组织版本发布评审。
2、版本发布时需提供《版本说明书》,《版本测试报告》、《版本遗留缺陷清单》。
3、版本发布负责人邮件发送版本发布评审通知。
参与评审的角色包括:产品经理、交付服务代表、测试经理、质量代表、制造代表。
4、版本发布负责人组织召开版本发布评审会议,对版本需求实现情况、测试充分性、遗留问题进行评估,并给出是否同意发布的结论。
所有参与评审的角色均需参加会议。
5、如果评审结论为通过,版本发布责任人通知信息化工程师将版本上传到版本服务器。
项目软件版本号管理规范
项目软件版本号管理规范历史修改记录一. 目的1.1软件版本按照一定的规则保存所有版本,避免发生版本丢失或混淆等现象,并且可以快速准确的查找到任何版本。
1.2软件版本规范有利于公司各部门之间的对接工作,有利于公司内部资料统一管理。
1.3本文档是为规范研发部软件版本管理而制定的。
二. 范围2.1本文档为研发部软件开发版本提供有关版本管理规范的相关内容,包括:2.2版本标识方法及管理2.3版本升级2.4文档及源码的备份制度2.5所有研发部软件工程师成员都必须遵照项目软件管理规范操作,公司内部使用按照文档及源码存放备份制度。
三. 版本管理3.1版本号规则3.1.1每个归档版本都有两个版本号:内部版本号和外部版本号。
版本号使用VP规则,V(Version)是指外部版本号(研发测试版本),P(Patch)是指补丁版本号(可选)。
3.1.2版本号命名:V/B+主版本号+次版本号+修订版本号+日期版本号3.2版本号修改规则3.2.1主版本号:当功能模块有较大的变动,比如增加模块或是整体架构发生变化。
此版本号由项目决定是否修改。
3.2.2次版本号:相对于主版本号而言,次版本号的升级对应的只是局部的变动,但该局部的变动造成程序和以前版本不能兼容,或者对该程序以前的协作关系产生了破坏,或者是功能上有大的改进或增强。
此版本号由项目决定是否修改。
3.2.3修订版本号:一般是Bug 的修复或是一些小的变动或是一些功能的扩充,要经常发布修订版,修复一个严重Bug 即可发布一个修订版。
此版本号由项目经理决定是否修改。
3.2.4日期版本号:用于记录修改项目的当前日期,每天对项目的修改都需要更改日期版本号。
此版本号由开发人员决定是否修改。
如: V8.1.0.XXX (上一级版本号有变动时,下级要归零)3.3版本号修改举例说明如此时版本号为:V8.1.0.XXX ,此时为内部测试阶段3.3.1 开发人员修复了测试人员提交的bug并经测试人员测试验证关闭bug 之后,发布到外网时,此时就进入了软件的下一个阶段,版本号可改为:V8.1.1.XXXX ,如当前日期跟上一个版本号的日期不一样,版本号可改为:V8.1.1.XXX。
软件产品版本管理规范完整版
程序文件、版本需求相关 记录、开发相关记录、测 试相关记录、版本情况及 已知问题说明、使用反馈 记录、发布确认记录等
6
程序名命名规则:ቤተ መጻሕፍቲ ባይዱ
项目名称_产品名称+版本号_地区名首大写拼音(或其它备注,无就不写) 例:Aries_RZAPP1.1.18_0103_SH;Ow1.1.30.0104_BJ;Odnis1.1.20.0106
5
04 版本存档方式
测试过程版本——共享
测试通过版本——SVN
程序、版本需求相关记录、开 发相关记录、测试相关记录等
软件产品版本规范
版本规范
目 录
01 目的概述 02 版本梳理过程 03 版本命名规则 04 版本存档方式
2
01 目的概述
为什么要进 行规范?
统一规则,清晰、直观,利于继承性与归档管理。
在哪些方面 规范?
测试过程版本,测试通过版本。
3
02 版本梳理过程
4
03 版本命名规则
版本号格式规则:
主版本号:当功能模块有较大的变动,需要进行立项讨论,产品在立项成功后确定主版本号; 次版本号:用流水号表示,次版本号变更由三种情况确定 (1、需求重大变更;2、产品里程碑变换;3、产品重大缺陷导致需要短期强制要求实施更新); 修订版本号:程序迭代的流水号,属于日常修复BUG或者代码优化等,研发人员自主; 日期版本号:取日月 对于主版本号、次版本号、修订版本号三者,上一级有变动时,下一级版本号要归1。
软件版本管理制度范文
软件版本管理制度范文软件版本管理制度范一、引言软件版本管理是指对软件产品的版本进行管理,包括版本的发布、升级、回退等操作。
一个完善的软件版本管理制度能够有效地提高开发效率、软件质量和用户体验。
本文将从版本控制工具的选择、版本号的管理、版本发布流程的规范等方面,制定软件版本管理制度。
二、版本控制工具的选择1. GitGit是目前最流行的版本控制工具之一,具有分布式版本控制的特点。
它具有分支管理、代码合并等强大的功能,方便多人协作开发。
在软件版本管理制度中,使用Git作为版本控制工具是一个明智的选择。
2. SVNSVN是另一种常用的版本控制工具,它采用集中式版本控制的方式。
SVN操作简单,支持多人协作开发,但相对于Git而言,功能较为有限。
在选择版本控制工具时,需要根据团队实际情况和需求进行综合考虑,选取最适合的工具。
三、版本号的管理版本号是软件版本的标识,用于区分不同版本的软件。
在软件版本管理制度中,版本号的管理非常重要。
1. 版本号的格式版本号应按照以下格式进行管理:主版本号.次版本号.修订号。
例如:1.0.0。
- 主版本号(Major Version):表示软件的重大更新或改版,通常包括功能的大幅度改进和重大的架构调整。
- 次版本号(Minor Version):表示软件的次要更新或升级,可能包括功能的新增或优化。
- 修订号(Revision Number):表示软件的修复漏洞或错误的补丁。
2. 版本号的变更规则- 主版本号的变更规则:当软件进行了重大改版或有不兼容的API变动时,主版本号必须递增。
- 次版本号的变更规则:当软件新增了功能或进行了功能优化等可向下兼容的变动时,次版本号必须递增。
- 修订号的变更规则:当软件进行了漏洞补丁、错误修复等变动时,修订号必须递增。
版本号的变更规则有助于团队成员快速了解软件版本之间的变动,便于沟通和协作。
四、版本发布流程版本发布是软件发布的重要环节,包括版本的准备、测试、发布等步骤。
(完整word版)软件版本管理规范
软件版本管理目录1。
引言 (1)1.1。
目的 (1)1.2. 范围 (1)1。
3。
术语定义 (1)1。
4。
参考资料 (2)1.5。
版本控制记录 (2)1.6。
版本更新记录 (3)2。
版本管理 (4)2.1. 版本标示方法 (4)2.1.1。
正式版本 (4)2。
2。
目录结构 (5)2。
3。
文档的存放 (5)2。
3。
1. ........................................................................................ 开发文档的存放52.3.2。
源代码的存放 (6)2.3.3. SQL的语句存放 (6)2。
3.4。
........................................................................................ 发行文档的存放7 2。
4. 配置管理流程 (7)2。
5。
权限控制的管理 (8)3. 更新管理 (9)3.1. 源程序的修改 (9)3.2。
版本升级 (10)3.2。
1. 版本升级原则 (10)3。
3. 文档的变更 (11)4。
备份管理 (12)1.引言版本控制就是对软件开发过程中所创建的配置对象不同版本进行管理,保证任何时间都可以取到正确的版本以及版本的组合。
版本控制的主要功能是记录开发过程中的每一次修改,让开发的工作可以随时检查过往历史记录和获得正确版本,是系统的成长记录。
1.1. 目的本文档的编制是为了规范产品部、研发部、测试部对软件产品版本的管理。
1.2. 范围本文档为产品部、研发部、测试部的管理员提供有关版本管理规范的相关内容,包括:●版本标识方法●软件系统数据的存放●文档的修改控制●文档的备份制度1.3. 术语定义SCM软件配置管理(Software Configuration Management)缩写SVM软件版本管理(Software Version Management)缩写SVN一个开源的版本控制系统Subversion。
软件版本管理规范方案V
1)负责对软件功能模块的编码工作
2)工作前对本地工作目录的代码进行检查是否为最新版本,确认后方可进行工作,否则必须先进行本地工作目录的更新
3)工作完成后及时将本地机工作目录下的代码进行checkin,避免代码丢失造成的损失
4)每次涉及到版本机的checkin都必须附上版本说明(说明修改的内容,新增功能,解决的bug等)
4.4.3.3.源码、文档入库编译构建脚本和所有源代码;文档包括需求说明、设计说明、计划,测试文档,操作手册、使用demo等
4.4.3.4.系统工程师进行程序打包标记源码、文档版本tag
4.4.3.5.编写发布说明readme.txtRead me的内容应该包括产品版本说明;本次发布包含的文件包、文档说明;本次发布包含或者新增的功能特性说明;遗留问题及影响说明;版权声明以及其他需要说明的事项
5.
5.1.
5.2.
6.
6.1.
6.2.
6.3.
6.4.
6.5.
7.
《软件组工作流程》
10)对SVN服务器使用情况进行稽查提交《SVN月度稽查报告检查表》
3.2.
1)对软件项目进行模块划分
2)协同版本管理员在版本服务器上进行目录设置,保证代码安全
3)检查组成员的上传代码,保证代码的质量
4)按项目计划时间点,及时提交软件项目文件
5)对单元测试中发现的问题及时进行处理.并在服务器做好备份工作
3)软件版本升级变更时,由系统工程师根据软件工程师提交的源代码和文档在版本服务器进行更新检查并知会版本管理员,然后由版本管理员检查是否满足版本提交条件,最后由版本管理员确认后,再将该版本存档
4)当发生用户需求变更时,系统架构师提交程序需求变更设计说明,并另行标明在源程序和文档中何处进行了更改,最终由软件主管审核通过后,将该版本存档
软件研发版本管理规定
软件版本管理制度1.引言目的本文档是为规范软件研发版本管理而制定的.范围本文档为各产品部、事业部版本管理员提供有关版本管理规范的相关内容,包括:版本标识方法软件系统数据的存放文档的修改控制文档的备份制度术语定义SVNSvn是一个开源的版本控制系统Subversion的简称文档一种数据媒体和其上所记录的数据.配置管理标识和确定系统中配置项的过程,在系统整个生存周期内控制这些项的投放和更动,记录并报告配置的状态和更动要求,验证配置项的完整性和正确性.软件配置软件的具体形态在某时刻的瞬时影像.配置项软件配置管理的对象称为配置项,如:系统规格说明书,项目开发计划,用户手册,源码.基线软件生存周期中各开发阶段末尾的标记,它的作用是把各阶段工作的划分更加明确化,使本来连续的工作在这些点上断开,使之便于检验和肯定阶段成果.版序控制记录版本更新记录A - 增加M - 修改D - 删除2.版本管理2.1版本标识方法为了使工作规范化、统一化,各项目组实行的版本标识管理方法分为:正式版本和特殊版本.2.1.1正式版本公司在市场上发行的正规版本.以“V”开头,版本号放后.V前面增加项目名称,版本号分3节:主版本号,次版本号和内部版本号,每节之间以小数点.间隔.如V2.0.1表示主版本号为2,次版本号为0,内部版本号为1.研发部控制主版本号和次版本号,各项目组控制内部版本号.例如:一体化平台-平阴版 , 一体化平台为产品名称,平阴版为版本名称平阴为具体项目名称,为主版本号+次版本号+内部版本号.2.2目录结构由于各项目组的实际情况不同,目录结构很难统一,但为了能更好地管理各项目组的文档,建议可将被管理的配置项分为三大类:文档类、源码类及安装盘类,这样存放比较清晰,有利于版本管理.至于二级目录是以版本划分,并根据制定的目录结构给出文件级目录清单先给出源程序及文档的文件级目录清单,安装盘的可以后再执行:.现以农电平台的目录结构举例如下:表示正式版本及特殊版本的目录按以下原则定义:(1)正始版本:以“V”开头,版本号放后,主版本号和次主版本号之间的“.”去掉,明细版本号之前加“-”.举例如下:版本号目录名V1.0.1 1.1.2 文档的存放2.3.1 当前版本和历史版本的存放对于源码文件,特别增加了一个Current目录,存放当前正在开发与维护的源码文件,当前未发布版本的所有数据都存放在.....\CURRENT\下.一旦当前版本正式发行,则当前目录被修改为相应的历史目录.历史版本是指已经发行的版本,存放在相应的版本目录之下,一般不允许改动.2.3.2 开发文档的存放根据各项目部自己的情况,将系统用户需求记录、总体设计文档、详细设计及数据结构文件、测试记录、用户手册等放入相应的目录下.2.3.3 源代码的存放源代码包括如:java,jsp,BMP,ICO等相关文件,是未经编译处理的、不能直接交付使用的产品文件以及编译产品所需的文件;联机帮助文件HLP在未生成HLP文件之前的DOC,RTF等格式的文档也视为源代码.各子系统当前的程序源文件放入相应的目录下.对于一个子系统又分多个分子系统的情况,应在该目录下分别建立几个相应的目录.2.3.4 SQL语句的存放各子系统SQL文件放入…..\.......\SQL下,对于不同的数据库,分别建立不同的子目录,如oracle、sysbase、db2等.公共SQL文件直接放入…\SQL下即可,不同数据库的特殊SQL分别放入对应的子目录下.2.3.5发行文档的存放发行文档是指产品交付用户使用所必须的文件.包括:产品可执行文件,用户使用说明书,联机帮助HLP;资源文件BMP,ICO等,环境配置文件等.以上文档作为制作发行盘的素材,放在RELEASE的REL_SRC目录之下,制作好的发行盘放在RELEASE的SETUP目录.2.4权限控制管理为保障文档的安全性,一致性,以及防止意外修改,必须对不同的文档设置不同的访问权限.文档权限类别:只读权限,读写权限.文档类别:设计文档,源码,发行文档.用户类别:开发人员、测试人员、分析设计人员、项目经理、配置管理员、安装盘制作人员、问题及需求管理人员、用户文档编写人员等.为了控制不同的使用权限,根据要求在服务器上分别建立不同的用户,针对不同的配置项所在目录分配不同的权限.为了便于管理,应以表格的形式列出人员与管理对象的访问关系用户权限清单.3.更新管理版本升级版本升级原则版本升级应严格纳入版本管理的控制之下.应当谨慎地控制版本的升级,保障高版本的向下兼容性,或提供严格定义的升级方法.在下面几种情况下,进行版本演化和升级:1、当产品发生重大修改和改进时,主版本号加 1.重大修改和改进包括:1)平台迁移;2)开发工具的迁移;3)体系结构的变迁.2、当产品发生较小的改进或修改时,次版本号可以加1.3、对于改动量比较少的,如修改产品的错误,可增加内部版本号.内部版本号对用户来说是不可见的,只对项目部内部版本控制有用.4、记录版本升级过程.每次版本升级,都要填写版本升级记录表,记录表样例如下:版本升级记录表说明:版本号:记录当前发布的版本.发布日期:该版本批准发布的日期.修改文件:版本修改记录文件,一般为版本修改日志.新版本的发布新版本的发布包括主版本号和次版本号的升级,一般不包括内部版本号的升级.流程如下:1、根据项目进展情况,或者根据用户需要进行发布准备.2、在指定目录中,根据本次发布的版本号建立相应的子目录,将current下的所有内容拷贝至新建目录下.3、可在新建目录下建立,并加入相应的内容.文件是记录该版本与上一版本的不同,作过哪些改动.格式样例如下:4.备份管理为了保证文档的最大可恢复性,要随时及定期地进行备份工作.1、随时备份:(1)开发人员每天都要将自已当日修改的源文件在本地机器上进行备份.(2)开发负责人每天要将所有源文件在本地机备份.(3)建议备份采用循环备份.2、定期备份(1)备份形式为硬盘备份和光盘备份.硬盘备份时,要备份在独立的硬盘上;光盘备份时,要将光盘存放在可靠的地方.(2)备份周期视各产品部、事业部的具体情况而定.如果处于开发阶段,每周应对所有的源程序项进行备份,一般为每周周五;如果处于其它阶段,根据具体情况而定,但周期不能超过两周.(3)备份要由版本管理员负责,备份原则应是保证文档的最大可恢复性.(4)对于历史版本或某用户的特殊版本,如果无特殊原因不再进行修改的话,建议用光盘进行备份,而且应有备份盘说明文件.该文件应该记录以下内容:本次备份时间,备份内容,执行人.5.用户版本管理目前主要以做项目为主,是根据客户要求开发的程序.为了更好地管理源程序,应为每一用户建立一个用户版本文件,该文件应包含以下内容:用户编号:用户名称:软件版本号:开始使用时间:联系人:联系电话:用户程序更改日志样例如下:说明:1)用户购买软件时要为该用户建立一个包含上述内容的一个用户版本文件,并填写有关数据.2)用户进行版本更新时要求填写该文件的版本变更记录,用以反映用户版本的变更情况.6.研发部统一管理阶段性版本阶段性版本的提交到研发部当各项目组更新了新版本以后,如果次版本号发生改变,各项目组配置管理员经项目经理批准后要把次版本修改的内容提交的内容分为修改的源码、新的文档和安装盘提交给研发部版本管理人员.阶段性版本的发布到公司网站上产品新版本发布以后,及时在软件演示环境中进行更新.并且新版本的特色和特点要在公司网站上进行发布,描述新版本特色的文档要由各项目组进行提供给项目部,经项目部保存后,文档提交给公司网站管理人员进行发布,以便供其他项目组和公司营销人员进行了解.各项目组新版本内部及时备份.研发部负责进行所有产品版本的管理,但各个项目组也要自己进行备份.7.版本工具的使用研发部采用svn配置管理工具研发部采用专门的配置管理服务器,此服务器只是专门用于版本的管理,一般不用于其他的应用,配置管理软件采用进行配置管理.8.各项目组提交文档及源码以及规则各项目组需要提交的文档9.周报管理制度各项目组每周向研发部提交周报.周报具体的格式如下:或者各个项目组提交最新的project 文件.Project文件中包含各任务完成百分比,任务分配人,资源情况.10.风险管理制度各项目组每周向研发部提交风险跟踪表.周报具体的格式如下XYZ 项目风险跟踪表风险编号严重性可能性风险描述报告者处理者当前状态解决措施风险严重性:指风险对项目造成的危害程度,例如可以划分为5个等级:5-很严重,4-比较严重,3-中等,2-轻度,1-低微.风险可能性:指风险发生的几率,可以用百分比表示.。
软件版本管理规范标准
软件版本管理目录1. 引言 (1)1.1. 目的 (1)1.2. 范围 (1)1.3. 术语定义 (1)1.4. 参考资料 (2)1.5. 版本控制记录 (2)1.6. 版本更新记录 (3)2. 版本管理 (4)2.1. 版本标示方法 (4)2.1.1. 正式版本 (4)2.2. 目录结构 (5)2.3. 文档的存放 (6)2.3.1. 开发文档的存放 (6)2.3.2. 源代码的存放 (6)2.3.3. SQL的语句存放 (7)2.3.4. 发行文档的存放 (7)2.4. 配置管理流程 (8)2.5. 权限控制的管理 (8)3. 更新管理 (10)3.1. 源程序的修改 (10)3.2. 版本升级 (11)3.2.1. 版本升级原则 (11)3.2.2. 新版本发布 (12)3.3. 文档的变更 (12)4. 备份管理 (13)1.引言版本控制就是对软件开发过程中所创建的配置对象不同版本进行管理,保证任何时间都可以取到正确的版本以及版本的组合。
版本控制的主要功能是记录开发过程中的每一次修改,让开发的工作可以随时检查过往历史记录和获得正确版本,是系统的成长记录。
1.1.目的本文档的编制是为了规范产品部、研发部、测试部对软件产品版本的管理。
1.2.范围本文档为产品部、研发部、测试部的管理员提供有关版本管理规范的相关内容,包括:●版本标识方法●软件系统数据的存放●文档的修改控制●文档的备份制度1.3.术语定义SCM软件配置管理(Software Configuration Management)缩写SVM软件版本管理(Software Version Management)缩写SVN一个开源的版本控制系统Subversion.文档一种数据媒体和其上所记录的数据。
配置管理标识和确定系统中配置项的过程,在系统整个生存周期内控制这些项的投放和更动,记录并报告配置的状态和更动要求,验证配置项的完整性和正确性。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
XXXX公司技术文件软件版本管理规范XXXX公司二○一八年一月目录第1章引言 ............................................................................................................. - 1 -1.1 目的 ............................................................................................................ - 1 -1.2 适用范围 .................................................................................................... - 1 -1.3 术语定义和缩写词 .................................................................................... - 1 -1.4 统一大小写 ................................................................................................ - 1 -1.5 参考资料 .................................................................................................... - 1 -第2章版本规范 ..................................................................................................... - 2 -2.1 版本格式 .................................................................................................... - 2 -2.2 版本升级规则 ............................................................................................ - 2 -第3章TAG 规范 ................................................................................................... - 3 -3.1 TAG 转换规则 ........................................................................................... - 3 -3.2 版本TAG .................................................................................................. - 3 -3.2.1 ALPHA测试 TAG ............................................................................... - 3 -3.2.2 BETA测试 TAG ................................................................................. - 3 -3.2.3 Release TAG .................................................................................... - 3 -3.2.4 产品基线 TAG ................................................................................. - 4 -第4章BRANCH 规范 .......................................................................................... - 5 -4.1 固定后缀 .................................................................................................... - 5 -4.2 BRANCH 转换规则 .................................................................................. - 5 -4.3 项目BRANCH ......................................................................................... - 5 -第5章代码存放及发布规范 ................................................................................. - 6 -5.1 代码存放规则 ............................................................................................ - 6 -5.2 发布规则 .................................................................................................... - 6 -第1章引言1.1目的通过该文档来统一、规范公司的所有软件产品的版本管理,使得版本管理更加正式和有效。
本文档自2018年1月1日开始执行。
1.2适用范围本规范中规定的相关内容适应于公司所有软件产品的版本管理。
1.3术语定义和缩写词版本号:产品/模块的版本标识TAG:SVN 中标识版本集合的工具和术语BRANCH:即分支,SVN 中支持并行开发的工具和术语1.4统一大小写版本管理中所有固定字串统一为大写版本管理中所有提到的产品/模块名称统一为小写1.5参考资料CMMI 规范之--SCM软件版本管理规范2.1版本格式版本号包括:产品/模块简称、主版本号、副版本号、子版本号、build 号格式:<产品/模块简称> <主版本号> . < 副版本号>.<子版本号>.<build 号> 2.2版本升级规则➢ 主版本号升级规则✧ 新产品或模块立项,主版本号为0;✧ 主体构件进行重大修改,主版本号加1;✧ 主版本号变更时,副版本号同时置0。
➢ 副版本号升级(主要针对新功能)✧ 新产品或模块,副版本号为1;✧ 主体构件的重大修改,副版本号加1;✧ 主体构件之间的接口协议重大修改,副版本号加1;✧ 与其他产品或模块之间的接口协议重大修改,副版本号加1;✧ 重大功能增加或增强,副版本号加1;✧ 当副版本号变更时,子版本号同时置0。
➢ 子版本号升级(主要针对修改bug)✧ 新产品或模块立项,子版本号为0;✧ 为增强现有功能模块,不增加新的功能模块,主体构件未做重大修改,并且主体构件之间的接口协议也未做重大修改,子版本号加1;✧ 为修改bug,而产品的主体构件未做重大修改,并且产品的主体构件之间的接口协议也未做重大修改,子版本号加1。
➢ build 号升级✧ build 号部分为生成版本的日期;✧ 每次送测必须有build 号,上线等也必须有build 号;✧ 例:0503313.1TAG 转换规则从版本号和项目编号转换成TAG 的对应部分遵循以下原则:a、字母和数字不变b、空格“”转换成下划线“_”c、小数点“.”转换成减号“-”3.2版本TAG3.2.1ALPHA测试 TAGAlpha版:内测版。
专业测试人员测试用,一般而言,该版本软件的Bug较多,需要继续修改。
格式:<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_ ALPHA格式(例):dhtx_0-1-0-150331_ALPHA3.2.2BETA测试 TAGBeta版:公测版。
该版本相对于Alpha版已有了很大的改进,消除了严重的错误,但还是存在着一些缺陷,需要经过多次测试来进一步消除,此版本主要对像是产品用户。
格式:<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_ BETA格式(例):dhtx_1-1-21-150331_BETA3.2.3Release TAGRelease版:该版本意味“最终版本”,在前面版本的一系列测试版之后,终归会有一个正式版本,是最终交付用户使用的一个版本。
该版本有时也称为标准版。
一般情况下,Release不会以单词形式出现在软件封面上,取而代之的是符号(R) 格式:<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_ R 格式(例):dhtx_1-1-21-150331_R3.2.4产品基线 TAG定义产品基线后缀是:_PD_BL格式:<产品/模块简称>_<主版本号>-<副版本号>-<子版本号>-<build 号>_PD_BL格式(例):dhtx_1-1-21-050331_PD_BL第4章BRANCH 规范4.1固定后缀BRANCH名称的固定后缀为:_BRANCH4.2BRANCH 转换规则BRANCH转换规则同TAG 转换规则4.3项目BRANCH项目分支用来支持并行项目的开发工作,同一项目使用相同的项目分支格式:<项目编号转换结果>_BRANCH第5章代码存放及发布规范5.1代码存放规则1. 软件开发在svn相应项目的trunk目录中进行。