开发部SVN使用规范.docVIP

开发部SVN使用规范 文档编号 保密等级 作者 李鹏 最后修改日期 2014.12 审核人 最后审批日期  修改记录 日期 版本 作者/修改者 描述 审核人 2014.12.19 V1.0 李鹏 初稿版本 2014.12.24 VI.1 李鹏 1.增加【测试代码】【源代码】文件夹的 使用规范 2014.12.25 V1.2 李鹏 确定项目库目录结构：【主干代码】 【代码分支】【版本库】【数据库】【文 档】 细化【代码分支】F1录内容 1.目的： 木制度为研发部SVN配置管理的准则和依据，所冇与SVN配置铮理的行为都必须遵照并 服从于木制度。 2.适用范 木制度适用于研发部全体员工。 3. SVN操作规范 3.1账号注册及权限申请 1） 账号注册：员工没有SVN帐号，通过邮件联系SVN管理员（李鹏），邮件正 文注明申请SVN普通帐号，管理员处理完帐号注册事宜后，会邮件回复。 注：普通帐号，只对个人冃录有读取权限。 2） 权限的申请：根据员工所参与的项冃，SVN管理员对其开放相应冃录的读、 写权限。 3） 账号注销：员工离职后，对其账号进行注销。 3.2目录结构规范 文档结构如下： 项n文件夹 卜一主干代码 卜一代码分支 卜一数据库 I —版本库 I —文档 1）主干代码 此文件夹的代码主要用于开发人员进行开发提交，版本提交会比较频繁。 代码捉交每次要有详细的备注说明，要表明修改内容、修改人、修改H期。 代码提交必须是通过编译的源代码，不能提交不能通过编译的源码 C.测试坏境的代码都通过此冃录进行更新，保证测试环境是最新版本。 2） 代码分支 代码分支通过测试代码文件进行生成。 代码分支的定义规则：project name + H期时I可+功能点，比如 it profile ,在创建每一个代码分支时，必须增加标注。 测试代码库作为项冃的主干代码，主耍用于新功能的开发。代码分支建立 的冃的是为了用作发布，或提供不同版木的系统给用户。 创建代码分支必须要有详细的备注说明。 代码分支建立后要定期合并到主干测试代码文件。 3） 数据库 数据库冃录存放侮次版本更新时的数据库文件，包括sql语句执行文件等，冃 录格式为版木名称+更新口期。例如2014年12刀19日系统初始进行发布，发 布内容包含SQL执行文件，此SQL文件要提交到SVN数据库中，建立目录为【初 始版。 4） 版本库 版本库存放项冃的发布版本，每次通过源代码冃录进行生成。当开发进行到一 个阶段，需要进行确定版木的时候，通过对源代码冃录使川SVN的建立分支功 能把当前的代码打包存储在版木库屮。版本库的日录规则为：版木名称+建立 日期+版本号。例如：2014年12月19日发布初始版本,初始版本的源代码就 需要建立版木再版木库中，存放目录名称为【初始版VI. 0] 5） 文档 此文件夹存放开发过程中所产生的各类文档，包括需求文档、开发计划、设计 文档、数据字典、测试计划、测试用例、测试报告等。 3.3说明注释 侮次捉交或建立新版本吋，尽量描述清楚木次修改的内容，以便FI后整理补丁，回 滚版本所需。每条注释前，增加对此注释功能的描述标签，如下所示： +）表示增加了功能 *）表示对某些功能进行了更改 -）表示删除了文件，或者对某些功能进行了裁剪，删除，屏蔽。 b）表示修正了具体的某个bug 3. 4提交规则 1） 负责而谨慎地提交自己的代码 当某一模块功能完成示，并测试无问题，谨慎地提交。 如果提交过程小产生了冲突，则需要同之前的开发人员联系，两个人一起协商 解决冲突，解决冲突之后，需要两人-?起测试保证解决冲突之后，程序不会影响其 他功能。 如果提交过程中产生了更新，则也是需要重新编译并H?完成自己的一些必要测 试，再进行提交。 2） 不要提交自动生成的文件 Ec 1 ipsc会在bui ld. setting和根冃录下生成大虽编译及工作空间信息文件, 不要把这些文件提交。 尽量做到每次提交选择确认提交的文件捉交，而非点击根FI录提交，并把所冇 文件勾选上。 3） 不要提交不能通过编译的代码 代码在提交之询，首先要确认自己能够在木地编译。如呆在代码中使用了第三 方类库，要考虑到项冃组成员中有些成员可能没有安装相应的第三方类库或者没有 放入jre的ext中,项冃经理在准备项冃工作区域的时候，需要考虑到这样的情况， 确保开发小组成员在签出代码之后能够在统一的环境屮进行编译。 4） 不要提交自己不明白的代码和文件 代码在提交入SVN之后，你的代码将被项目成员所分享。如果提交了你不明口 的代码，你看不懂，别人也看不懂，如果在以后出现了问题将会成为项冃质量的隐 患。因此在引入任何笫三方代码Z前，确保你对这个代码冇一个很清晰的了解，同