代码管理及出包规范 V1.0

代码管理及出包规范版本信息A代表新增，M代表修改，D代表删除。版本号发布日期提交人A.M.D摘要V1.02016-05-19林彦A拟初稿代码管理及出包规范Copyright(C)2007-2016广东正全科技股份有限公司版权所有第2页共15页1.前言..........................................................................................................................41.1.目的.................................................................................................................41.2.配置管理工具.................................................................................................41.2.1.Git介绍..................................................................................................41.2.2.Git分层结构..........................................................................................41.2.3.工作流程..............................................................................................61.3.角色和职责.....................................................................................................62.配置仓库规范..........................................................................................................72.1.配置仓库说明.................................................................................................72.2.配置仓库管理规范.........................................................................................82.2.1.远程仓库管理......................................................................................82.2.2.本地仓库管理......................................................................................83.分支管理规范..........................................................................................................93.1.分支职责.........................................................................................................93.2.分支工作流程图...........................................................................................113.3.创建分支规范...............................................................................................114.代码管理规范........................................................................................................124.1.提交代码规范...............................................................................................124.1.1.代码提交说明....................................................................................124.1.2.代码提交步骤....................................................................................124.1.3.解决冲突............................................................................................134.2.代码开发测试规范.......................................................................................135.版本管理规范........................................................................................................13代码管理及出包规范Copyright(C)2007-2016广东正全科技股份有限公司版权所有第3页共15页5.1.版本格式.......................................................................................................135.2.命名规则.......................................................................................................145.3.出包说明.......................................................................................................145.4.出包步骤.......................................................................................................14代码管理及出包规范Copyright(C)2007-2016广东正全科技股份有限公司版权所有第4页共15页1.前言1.1.目的规范项目代码管理流程，明确开发人员和项目管理者的职责。规范代码库分支管理和版本管理，使代码分支及版本结构清晰，方便维护。1.2.配置管理工具1.2.1.Git介绍Git是一个开源的分布式版本控制系统，用以有效、高速的处理从很小到非常大的项目版本管理。可以实现数据备份、记录历史、回到过去、多端共享、分工合作。1.2.2.Git分层结构git的工作总共分四层，其中三层是在本地，包括了工作目录，暂存区和本地仓库。工作目录：执行命令gitinit时所在的地方，也是执行一切文件操作的地方。暂存区：在.git文件夹目录中，在工作区和版本库中间起缓存作用的一个区域。它通过gitadd命令添加进暂存区。存储了一些即将被commit的文件。本地仓库：代码管理及出包规范Copyright(C)2007-2016广东正全科技股份有限公司版权所有第5页共15页在.git文件夹目录中，使用了gitcommit命令之后添加进的真正的“仓库”。里面存储了每次commit的记录，每次commit一次会让HEAD指针指向新的目录树，而旧的目录就存在版本库中，可以使用命令来提出之前的目录树。git所存储的都是一系列的文件快照，然后git来跟踪这些文件快照，发现哪个文件快照有变化它就会提示你需要添加到暂存区或是提交到本地仓库来保证你的工作目录是干净的。进入工作区.git文件夹，如下.git目录或文件结构说明：目录或文件说明config文件项目的配置文件，里面有中心服务器的信息和分支信息。HEAD文件指向当前的分支。index文件暂存区的相关信息。logs目录相关操作产生的日志。objects目录存储的就是所有的数据，也就是快照。存放的是实际上的文件资源，每次当使用了gitadd命令之后，就已经把文件存到了objects目录里面。objects目录中的object对象都有一个通过哈希算法计算出来的40位16进制的id，前两位是目录名，后38位是文件名。因为哈希算法可以只比较哈希值，就能知道这两个对象是不是一样的，这样可以提高效率。refs目录存储指向数据提交对象的指针。代码管理及出包规范Copyright(C)2007-2016广东正全科技股份有限公司版权所有第6页共15页1.2.3.工作流程1.3.角色和职责角色名称职责配置管理员管理配置服务器，维护代码仓库、安全设置，定期备份代码仓库。负责为项目提供全面的配置管理基础设施和环境。包括代码仓库建立、人员添加等工作。编写和维护配置管理的相关文档，包括服务器配置管理方法、配置工具使用方法、配置规则与实行方法等。编写培训材料，制定培训计划，对开发人员和项目管理人员进行培训。开发负责人1)管理源代码，构建代码框架，导入配置服务器。2)在配置管理员协助下对源代码进行管理。3)根据项目进展制定开发基线，管理版本编号以及分支版本，必要的时候，负责版本的合并，并解决或指导开发人员解决合并冲突。代码管理及出包规范Copyright(C)2007-2016广东正全科技股份有限公司版权所有第7页共15页4)负责发布新版本。开发人员1)从服务器克隆项目，按照分配的任务，进行分工协同开发。2)从服务器获取代码库最新变更，在自己负责的模块中加入、修改或删除文件。3)及时提交代码到开发分支并附加变更说明。各角色工作流程图2.配置仓库规范2.1.配置仓库说明配置管理员负责建立配置仓库，以便管理源代码、相关文件及提交代码克隆仓库配置管理员远程仓库开发人员开发人员开发人员开发负责人合并分支创建仓库代码管理及出包规范Copyright(C)2007-2016广东正全科技股份有限公司版权所有第8页共15页资料。每个开发人员在本地都有自己的版本库，在服务器上有一个公共的版本库。2.2.配置仓库管理规范根据配置管理的不同角色所分配的不同职责范围，对本地库和版本库进行管理和操作。2.2.1.远程仓库管理配置管理员:创建远程仓库、人员添加等工作。开发负责人:导入该项目到远程仓库并完成分支的创建和设置。2.2.2.本地仓库管理本地库由开发人员和开发负责人负责日常的更新和开发工作。1.克隆远程仓库，搭建开发环境开发人员根据配置管理提供的git访问地址，将远程仓库克隆到本地，使工作区可以正常运行起来，并在开发分支上创建功能分支进行开发工作。2.代码提交开发人员修改完成后提交代码到暂存区，在暂存区域生成文件快照并提交到本地