Domino开发--版本管理与团队开发探索

文章出处：

Domino开发--版本管理与团队开发探索(一)http://www.lotuschina.net/club/thread-16219-1-1.html

Domino开发--版本管理与团队开发探索(二)http://www.lotuschina.net/club/thread-16227-1-1.html

Domino开发--版本管理与团队开发探索(三)http://www.lotuschina.net/club/thread-16231-1-1.html

笔者从事Domino开发已经很长时间了，虽说之前一直是以团队开发的形式进行，但是实际工作中一直没有用到版本管理软件。后来接触了myeclipse,对SVN的代码版本管理功能羡慕不已。Domino什么时候也能用上SVN来对源代码进行管理那就太好了。

本着这个想法，笔者一直在探索Domino平台上使用SVN的方法。起先是编写代理时全部改为Java代码，然后利用myEclispe的SVN插件进行管理。此方法不好推广而且大多数Domino开发人员未必能接受Java代码写程序。

随着Domino发展到8.5.3版本后，Designer中开始提供了一个新的开发工具--工作组开发。干什么用那，简而言之，就是将NSF数据库的设计元素转成XML文档，并存在本地磁盘。这个功能太好了，那就意味着NSF数据库源代码将以文本文件的形式存在。更意味着NSF源代码终于可以用SVN进行管理了。也许有人会觉得我大惊小怪，其实不然。下面我简单解释下。我们开发一个Domino项目，其中会由多个数据库组成，这就是我们常说的模块开发。过去，一般是一个数据库就是一个模块，每个模块由一个人开发。随着项目规模的膨胀，一个模块会由多个人共同开发才能完成。这在JAVA项目中简单的很。然而在Domino项目开发中，这就是个头疼的事，因为多个共同开发一个数据库经常发生设计冲突，代码覆盖现象。因此一般会有合并代码的一个步骤。现在不需要了，SVN能够自动实现代码合并，源代码冲突管理，源代码版本管理，非常方便。

这么好的一个工具，笔者翻遍大小论坛，很遗憾的是未曾见到有人在论坛中说上只言片语。笔者认为Domino的发展离不开大家的努力，如今Domino的颓势已不可挽回，是不是跟我们的心态有点关系那？夕阳无限好，只是近黄昏！也许Domino平台注定是夕阳下的那一抹晚霞，虽美却是最后的辉煌。

好了，闲言少叙，进入正题。万事具备，只欠东风！如今我们就是要借这个东风。是什么那？我们都知道Designer是基于Eclipse开发平台的，那很自然的我们要寻找的是运行于Eclipse平台的下的SVN插件。

在前文中，笔者用了大量文字来引出了SVN插件。不妨告诉大家，笔者提到的SVN插件是Subversive。以往写一些技术类文章总是离不开插图，原因不说大家也清楚吧。因此本文也不会例外，肯定也是图文并茂。刚才说到了，本文提到的SVN插件Subversive的版本是有要求的，有趣的是，新版本的插件在Designer上没法用的，只能用老版本的。笔者在这上面折腾了一天。当然我们读者是不需要这么辛苦的了，本文所提到的插件我已经给大家准备好了。

唠唠叨叨半天，估计有人已经看烦了。好吧，我们进入正题。开始安装Subversive.

软件要求：
Designer8.5.3
Subversive-connectors-2.2.2.I20111119-1700
Subversive-incubation-0.7.9.I20111123-1700
第一步
启动我们的Designer，打开“文件”菜单，选择“首选项”。

下载 (16.36 KB)

2014-11-15 19:17

第二步
在新打开的对话框中找到Domino Designer项，选中。在“启用Eclipse插件安装”前面打上勾，然后按“确定”按钮关闭对话框。

下载 (22.58 KB)

2014-11-15 19:23

第三步
还是打开“文件”菜单，选择“应用程序”-》“安装”。

下载 (12.89 KB)

2014-11-15 19:31

第四步
在新打开的对话框中，选中“搜索要安装的新功能部件”,此处是单选按钮。选好后，按“下一步”按钮。

下载 (37.1 KB)

2014-11-15 19:40

第五步
在新的弹出窗口中，点击“添加Zip/Jar位置”按钮。

下载 (37.79 KB)

2014-11-15 19:46

第六步
在文件选择框中选择，我们要用的插件安装包。此处两个安装包要分别选取，别落下一个。

下载 (8.01 KB)

2014-11-15 19:51

第七步
编辑本地地点，其实这个不用修改，自动取上一步选择的安装包路径。点“确定”按钮。

下载 (17.82 KB)

2014-11-15 19:56

第八步
两个都打上勾，点“完成”按钮。

下载 (41.38 KB)

2014-11-15 20:06

第九步
在此处有处需要注意的事情。默认情况下所有的功能部件都会自动打上勾，但实际上会出现不支持的功能部件，此时将其勾去即可。插图中有两处已经勾去，就是这个原因。大家在安装时要留意下。勾掉不支持的部件后，点“下一步”按钮。

下载 (91.77 KB)

2014-11-15 20:15

第十步
一定要选择“我接受许可协议中的条款”，然后点“下一步”按钮。

下载 (87.69 KB)

2014-11-15 20:33

第十一步
安装插件，此处会有多次显示询问框，每次都是选择“安装该插件”。

下载 (55.93 KB)

2014-11-15 21:11

下载 (35 KB)

2014-11-15 21:20

最后一步，重启Designer客户端即可。
本文中使用的SVN插件，笔者一并提供给各位读者。
http://pan.baidu.com/s/1qWmGHyO

本章内容结束。下一章，笔者要讲解怎么在Designer中使用版本管理构建工程。

 

看过前面两篇拙文，各位渎者对在Domino平台上使用SVN进行源代码管理有什么见解那？不妨发表一下看法意见。所谓仁者见仁，智者见智，既然是论坛那自然是以讨论为主。还请各位不吝赐教。

闲话到此，进入正题。书接前文，安装完SVN后，开始在实际项目中使用了。传统的Domino开发一般是以开发服务器为中心，多个客户端共用一台服务器。

 

下载 (29.98 KB)

2014-11-16 21:54

 

 

图一

在使用了SVN后，这个开发方式需要变一下了。

下载 (25.17 KB)

2014-11-16 22:08

 

 

图二

 

从此以后，每个开发者都是一个开发中心，我们暂称之为单元吧。源代码统一提交到SVN服务器管理。做J2EE开发的读者可能注意到了，这跟J2EE项目开发模式是一个样的。是的，今后的Domino平台开发方式将向J2EE靠拢。

 

在这些单元中可以分出若干个角色。开发、测试、汇总、代码检查等等。看到这种模式的好处了吧，大家工作互不干扰，而又具有了团队协作开发的实际意义。

 

下面我们来看下如何在Designer中使用SVN插件。

写到此处笔者发现少了一个重要环节，此处先提一下，下一篇文章再详细讲解--搭建SVN服务器。那么我们假定已经存在一个Domino版本库，起名为TESTPROJECT。

 

我们在Designer中打开一个NSF的数据库，本文新建了一个叫testproject.nsf的数据库。在数据库图标处单击右键，弹出菜单，选择“工作组开发—》设置此应用程序的源控件”

 

下载 (35.55 KB)

2014-11-18 22:58

 

 

图三

 

弹出新的对话框，此处是供用户了解源控件的用处。第一次操作的时候还是仔细看看做好。如果以后不想再看此对话框，勾选下方的“以后跳过此帮助程序面板”即可。然后点击“下一步”按钮。

 

下载 (48.1 KB)

2014-11-18 23:00

 

 

图四

 

此处显示新的内容，在项目名文本框中填入此项目名称。此处最好选择与数据库名相同的名称，当然这也不是强制性要求，只是以后项目多了好找而已。还有两处默认的选择框，可根据需要修改。其中“使用缺省位置”可根据项目实际情况改为自己制定的目录，不是必须用缺省值的。此处为了行文方便，一律采用缺省设置。

写完项目名称后，点击“完成”按钮。

 

下载 (31.43 KB)

2014-11-18 23:01

 

 

图五

 

注意看此时的Designer界面自动切换至导航器视图。

 

下载 (16.12 KB)

2014-11-18 23:02

 

 

图六

 

然后在”与testproject.nsf关联”对应的文件夹上单击右键，选择“小组—》共享项目”

 

下载 (36.59 KB)

2014-11-18 23:03

 

 

图七

 

弹出新的对话框，在URL中输入版本库的地址。在“Authentication”下输入用户名和密码。如果不想每次都输入用户名和密码，就勾选“Save authentication”。然后点击“下一步”按钮。

 

下载 (42.35 KB)

2014-11-18 23:04

 

 

图八

 

新的对话框中是定制版本库，为了行文方便，还是选择默认的”Simple Mode”,各位读者可在线下选择”Advanced Mode”试一试。点击“下一步”按钮。

 

下载 (45.36 KB)

2014-11-18 23:06

 

 

图九

 

此处是填写项目说明的。可填可不填，建议各位读者多少写点内容在上面。此处可自行斟酌。然后点击“完成”按钮。

 

下载 (31.74 KB)

2014-11-18 23:07

 

 

图十

 

读者会看到一系列进度条一闪而过。因为速度太快，笔者也没看清内容，只好请各位读者再操作时睁大眼睛看清楚了。进度条过后，显示对话框。此处是选择上传到SVN服务器的文件，一般情况下默认全选就可以了。在“Comment”中可以填入说明文字。此页面中的“Keep Locks”选项，笔者没弄清楚是干什么用的。各位读者有知道的请回复本文。然后点击“确定”按钮，提交源代码到SVN。

 

下载 (42.8 KB)

2014-11-18 23:09

 

 

图十一

提交完成后，项目图标会有所变化。

下载 (3.52 KB)

2014-11-18 23:09

 

 

图十二

 

这说明数据库的源代码已经提交到SVN版本服务器了。此处笔者还要说明一下，在NSF数据库中修改完成后，改动是自动同步到磁盘上的本地项目。

 

提交源代码时，在本地项目上单击“右键”，弹出菜单，选择“小组—》Commit”。如果是更新本地源代码，选择“Update”。其他菜单功能，读者线下研究。

 

下载 (55.67 KB)

2014-11-18 23:11

 

 

图十三

 

源代码能够提交到SVN服务器只是完成了一半工作。既然是团队开发，那当然其他开发者也要从SVN服务器获取源代码才可以。那么下面笔者就讲解获取源代码的过程。笔者的环境为了行文的需要已经将开发环境清空，以方便大家阅读。

打开Designer，在左侧导航器单击右键，在弹出的菜单中选择“导入”。

 

下载 (17.66 KB)

7 天前 00:01

 

 

图十四

 

选择“SVN-》Project from SVN”,然后点击“下一步”按钮。

 

下载 (31.44 KB)

7 天前 00:05

 

 

图十五

 

在接下来的窗口中，如果是新开始引入项目那么选择“Create a new repository location”,如果是已有项目直接选择版本库对应URL就可以了。因为笔者之前已经建立版本库并提交了项目源代码，所以此处会显示已存在的版本库。

 

下载 (35.42 KB)

7 天前 00:06

 

 

图十六

 

此处都是取默认值。在“Revision”标签下，是可以根据时间或者输入版本号来获取版本。不过通常情况下都取最新版本。点击“完成”按钮。

 

下载 (30.95 KB)

7 天前 00:07

 

 

图十七

 

紧接着上一个对话框，此处要求用户选择项目引入方式。默认都是第一项，有兴趣的读者可以试试其他几个选项。点击“完成”按钮。

 

下载 (37.76 KB)

7 天前 00:08

 

 

图十八

 

在此对话框中选择“常规-》项目”，点击“完成”按钮。

 

下载 (34.61 KB)

6 天前 16:14

 

 

图十九

 

此处输入项目名称，然后点击“完成”按钮。

 

下载 (33.28 KB)

6 天前 16:15

 

 

图二十

 

请注意，此时是在本地磁盘上生成了一个项目，到此时还不是我们传统的数据库。还需要根据此项目生成数据库。

 

下载 (12.78 KB)

6 天前 16:16

 

 

图二十一

 

在此项目上单击右键，选择“工作组开发-》与新NSF关联”。

 

下载 (40.77 KB)

6 天前 16:18

 

 

图二十二

 

弹出的新对话框是不是很熟悉，就是新建数据库。此处笔者无需多加解释了。选择服务器，输入数据库路径和名称，点击“完成”按钮。

 

下载 (23.45 KB)

6 天前 16:19

 

 

图二十三