文件版本管理系统

i8studio 版权所有 蜜 蜂 软 件 产品使用 摘要 蜜蜂软件 FVM(FileVersionManage)系列属于文件版本管理软件，SeeVersion系统是FVM系列中的代码F1。SEEVERSION系统主要用于IT企业中软件文件的版本更新管理以及对安装包的发布前后的版本维护。本手册分为五章，第一章：如何做好安装包的版本管理；第二章: 如何查看更新文件；第三章: 如何留言；第四章：如何下载安装包；第五章：如何录入更新信息；第六章：如何修改后台信息。每个操作或者功能都有相应的截图，以便查阅使用。 由于团队力量有限，手册中难免出现错误，还请读者见谅。如果因为错误而给您带来的困扰，请给我们留言或者发邮件，我们将第一时间给您解决。谢谢合作！ 1蜜 蜂 软 件 1产品使用手册 1摘要 2第一章 如何做好安装包的版本管理 31.1安装包更新列 41.2 安装包评论信息 41.3 搜索安装包 4第二章 如何查看更新文件 52.1查看BS程序文件更新 52.2 查看CS程序文件更新 62.3 最新文件列表 7第三章 如何留言 73.1 提交留言 8第四章 如何下载安装包 94.1 下载安装包 94.2 评价安装包 10第五章 如何录入更新信息 105.1 登录后台 105.2 录入CS程序文件更新信息 115.3 录入BS程序文件更新信息 125.4 录入安装包版本更新信息 135.5 录入最新文件更新信息 14第六章 如何修改后台信息 146.1 添加和修改后台管理员 156.2 修改安装包版本信息 156.3 修改CS程序文件更新信息 156.4 后台表结构 第1章 如何做好安装包的版本管理 如何做好安装包的版本管理是大部分IT企业比较关心和头痛的问题，SeeVersion系统是i8studio员工亲自参加企业软件打包工作而开发出来的一款时尚软件。可以记录安装包的发布时间、功能模块、MD5、更新说明以及我们对他的评论等。 1.1安装包更新列表 更新列表中可以清楚的查看安装包的名称、发布时间、MD5、版本号、更新说明、默认功能等，鼠标放在安装包名称列的相应列表上就会弹出安装包的详细信息，如图1；当鼠标放在更新简述列和默认功能模块列上也会有弹出层，如图2。 图1 安装包列表界面 图2 弹出层显示 1.2 安装包评论信息 安装包评论信息是从留言簿中输入的，主要是针对安装包的使用情况对固定的安装包种类和对应的版本号进行留言， 这样就方便别人在使用安装包的时候可以有个依据，从而判断安装包的稳定性，当然打包人员也可以根据它来确保安装包的稳定性，留言结果，如图1。 1.3 搜索安装包 搜索安装包主要是根据安装包的种类和安装包的版本号来定位搜索，如图3。 图3 搜索安装包 第二章 如何查看更新文件 更新文件分为二大类：一类是BS程序（譬如，网站页面的更新、网页样式的改变等）二类是CS程序（譬如，动态链接库、Winfrom程序或者客户端程序等）。 2.1查看BS程序文件更新 我们可以在BS程序中相关文件更新列表中查看BS程序文件更新，列表中主要记录了BUG描述信息、变更人、变更时间以及安装包版本，如图4；当然列表中显示的描述信息有限，当鼠标放在列表上的时候就会显示修改的全部信息，如图4；在BS程序文件列表中可以搜索“从多少版本到多少版本谁更新了什么”，如图4。 图4 BS程序文件更新列表 2.2 查看CS程序文件更新 我们可以在CS程序中相关文件更新列表中查看CS程序文件更新，列表中主要记录了文件名称、变更人、变更时间、变更前版本、当前版本、变更目的以及安装包版本，如图5；当然列表中显示的变更目的有限，当鼠标放在列表上的时候就会显示当前文件的全部变更目的，如图5；在CS程序文件列表中我们除了可以搜索“从多少版本到多少版本谁更新了什么”，还可以搜索特定文件的变更列表，这样就方便研发看到自己文件的更新记录，如图5。 图5 CS程序更新文件列表 2.3 最新文件列表 最新文件列表主要是针对CS程序，在CS程序列表中记录的是很多重复文件的变更记录而最新文件列表中记录的是每个文件最新的文件名称、最新版本号、提交时间、提交人、文件路径（是指安装包将释放在系统的哪个目录，方便技术人员查找文件排查问题的）、相关说明（当然可以是更新说明）、使用范围（是指这个文件只能存在哪个项目或者安装包中），如图6；最新文件列表也有搜索功能，可以查找特定文件的最新信息和某个研发人员所有文件或者功能模块的最新信息，如图6。这个列表是不需要我们来更新的，而是系统更新CS列表中的文件更新信息自动更新，方便我们查看的，当然也可以导出Excel表格进行查看，如图6。 图6 最新文件列表 第三章 如何留言 留言功能主要是针对安装包更新列表来说的，留言结果在安装包更新列表的安装包名称列的详细信息和留言列表中可以看到。这样的温馨留言是安装包稳定性评估的重要依据，多个人对一个版本的留言会进行累加，系统会记录下留言人的姓名、内容、留言IP、留言时间以及可以选择留言的重要与否，如图7。 3.1 提交留言 打开网站，点击【留言簿】，如图7；填写姓名、内容、选择包种类、版本号以及勾选重要后点击【提交】按钮即可完成一次留言功能，如图7；当勾选中重要信息后，留言信息就会在“重要留言列表”中显示，如图7；其中，留言排行列表会根据留言列表中人员的留言情况统计出留言最多的前15位，如图7。 图7 留言簿 第四章 如何下载安装包 要想下载安装包请到安装包下载列表中，当然，这个列表也是可以下载更新文件的，当然需要我们把更新文件当作为安装包的类型来上传。在安装包下载列表中包括安装包的MD5、安装包大小、产品版本号、上传者、上传时间、产品介绍、评价以及评价统计等，如图8。 4.1 下载安装包 在安装包下载列表中直接点击【下载】按钮图标，如图8。 4.2 评价安装包 在安装包列表中点击【留下吧！BUG少】图标按钮或者【丢弃吧！BUG多】图标按钮，当然一个IP只能点击一个按钮一次，这样系统会精确统计票数，也是可以作为安装包稳定性评估的依据，如图8。 图8 安装包下载列表 第五章 如何录入更新信息 录入更新是从系统后台输入的，录入的内容包括BS程序文件更新信息、CS程序文件更新信息、上传安装包信息以及输入最新文件信息。 5.1 登录后台 输入用户名和密码，默认用户名：i8studio，密码：seeversion，当然我们也可以自己添加用户，下章将介绍如何添加用户，如图9。 图9 系统登录 5.2 录入CS程序文件更新信息 文件类型选择CS程序类型，页面就会显示所有CS程序文件更新需要填写的信息，其中包括文件名称、变更人姓名、文件变更时间（默认是当前系统时间）、文件当前版本、文件变更前版本、文件适用范围、安装包版本号（更新文件所在的安装包版本号）、更新内容、代码改动说明、文件路径选择（仅当勾选“是否把CS程序文件同步到最新列表中”）如图10。 图10 上传CS程序文件更新信息 5.3 录入BS程序文件更新信息 文件类型选择BS程序类型，页面就会显示所有BS程序文件更新需要填写的信息，其中包括变更人姓名、文件变更时间（默认是当前系统时间）、安装包版本号（更新文件所在的安装包版本号）、更新内容（如果有多个BS程序在详细）、如图11。 图11 上传BS程序文件更新信息 5.4 录入安装包版本更新信息 文件类型选择安装包类型，页面就会显示所有安装包版本更新需要填写的信息，其中包括文件变更时间（默认是当前系统时间）、安装包名称、安装包MD5、默认功能（是指安装包中的默认功能）、安装包版本号（通常如果列表中没有本次版本号，就需要点击【记住此版本号】按钮）、安装包发布日期、更新内容（可以写详细一些因为会在下载列表中显示）、上传安装包文件（安装包文件会上传到下载列表中）如图12。 图12 上传安装包版本更新信息 5.5 录入最新文件更新信息 文件类型选择最新文件记录类型，页面就会显示所有文件更新需要填写的信息，这里和CS更新文件基本相同。其中包括文件名称、变更人姓名、文件变更时间（默认是当前系统时间）、文件当前版本、文件变更前版本、文件适用范围、安装包版本号（更新文件所在的安装包版本号）、更新内容、代码改动说明、文件路径选择（仅当勾选“是否把CS程序文件同步到最新列表中”），于CS更新文件页面不同的就是文件路径的显示与不显示，如图13。仅当我们在输入CS程序更新文件的时候没有勾选，但又需要这个文件在最新列表中记录的时候才选择文件类型“最新文件记录”。 图13 最新文件格 第六章 如何修改后台信息 在SeeVersion系统中修改信息和其他厂商的文件版本管理系统一样都是采用SQL语句直接操作数据库的，不过在SeeVersion系统中有自己的定制语句，系统中默认执行的SQL语句前需要添加“#”号，脚本的执行是从选系统后台SQL脚本执行框中输入执行的如图13，下面我们将介绍一些通用SQL语句以及后台表结构。 6.1 添加和修改后台管理员 第一，添加管理员信息 Insert into user(userName,userPwd)values(‘i8studio’,’seeversion’) 第二，修改管理员信息 Update user set userName=’xufeng’ ,userPwd=’888888’where userName=’i8studio’ 6.2 修改安装包版本信息 修改安装包版本信息就需要定位一条安装包版本信息，定位条件可以是MD5、安装包版本号、发布日期等 第1， 根据安装包MD5值，修改安装包发布日期 update file set packageMakeDate='2012年03月07日' where packageMd5 like '%74CD0C281D73E98A9C07%' 第2， 根据安装包名称和安装包版本号，修改安装包名称 update file set packageName='[蜜蜂软件][SeeVersion]' where packageName='[蜜蜂软件][SeeVersion]' and packageVersion='1.0.0.1001' 6.3 修改CS程序文件更新信息 第一，更新文件更新日期和文件名称，修改文件当前版本和更新前版本 update file set fileCurVersion='1.0.0.1066',filePrevVersion='1.0.0.1065',fileName='i8studio.exe' where fileName='i8studio.exe' and fileUpdateDate='2012年08月16日' 6.4 后台表结构 第一，file表，这个表是所有文件更新内容的表，大多数修改信息都是操作这张表，如图14。 图14 File表 第二，newFile表，如图15 图15 newFile表 PAGE 4 www.i8studio.com i8studio.taobao.com