PB版本控制文档

PB 版本控制 作者：陆海峰 (newmount@163.com) PB 与版本库连接 PB 版本控制同样采用 SourceAnywhere，需要在 PB 中建立与与 SourceAnywhere 的连接， 如下面图解： 第 1 步：版本控制在工作区（workspace）设置。选中工作区，按右键打开。 第 2 步：connect 成功后弹出 login 窗口，输入用户名及口令，选取数据库 第 3 步：选中项目 ET2006 ，按确定后返回上级 1 再按确定即可。 注意选中 Delete PowerBuilder Generated Object Files 和 Suppress prompts to overwrite read-only files 各项连接参数进行说明如下：（高级用户参考） Source Control System 版本控制系统。在这里选择要使用的版本控制系统。这里列出来的是操作系统 中安装了的，能够集成到开发环境中的版本控制系统。 UserID 登录用户账号。是开发者在所选择的版本控制系统中所拥有的登录账号。 Project 在版本控制系统数据库中所存在的，本次开发所需要的项目。 Local Root Directory 本地的根目录。这个路径或者它的子目录要包含 Workspace。 Connect 连接版本控制。注意：有的版本控制在 Project 中不需要填写，在连接的 时候选择 Project。 Advanced… 设置高级属性。相当于执行菜单 Entry→Source Control→Advanced Options（在 Library Painter 中的菜单）。 Require Comments on Check-in 在键入的时候需要填写注释说明。如果选中该项，在 Check-in 的时候， OK 按钮是灰色的，除非你填写了注释说明。 This project requires that I sometimes work offline 选中这一项，在每次打开这个 Workspace 的时候，不会主动连接，而是出 现一个对话框，询问是联机还是脱机 Delete PowerBuilder Generated Object Files 这一项是决定是否自动删除 PB 生成的对象的源文件（*.sr?）。在执行版 本控制的某些活动的时候，比如 GetLastVersion、Check-out、Check-in、 Refresh Status 等操作的时候，PB 会从版本控制系统中取得对象的源代码 放置到本地。如果选中该选项，PB 会在执行完操作以后，自动删除这些文 件。如果不选中该选项，这些临时的源文件将保留在本地。使用某些版本 控制系统比如 Perforce, ClearCase, or Continuus source control 2 systems 等，不可以选择该选项。 另外，有些操作，即便是选择了该选项，可能也不会完全的清除这些临时 的源文件。比如执行 Refresh Status 操作。如果不想保留这些文件，需要 你手工清除。我的办法是使用一个批处理文件（DELSR.BAT），是 Del *.sr?来删除这些文件。 Perform Diff on Status Update 取消了该选项选择，你将看不到本地对象与版本控制系统数据库的对象是 否有差别。即：Refresh Status 命令将无效。 Suppress prompts to overwrite read-only files 这个选项选择时候，在某些时候（具体忘记了），提示你是否覆盖。该选 项可以提醒防止使用旧的文件覆盖新的文件。 Status Refresh Rate 自动刷新状态的时间，以分钟为单位。这里所指的状态是 PB 的对象是否被别人 锁定，或者是否被更改而与本地的不相同。 PB 中显示的图标 名称 图 说明 加号 表示这个对象还没有加入到版本控制数据库中 圆点 表示这个对象加入到了版本控制，并且处在常规状态,可以被检出(check out) 绿勾 表示这个对象被当前的开发者检出/锁定 红叉 表示这个对象被其他的开发者检出/锁定。（其他人不可以再检出。） 问号 表示这个对象的状态未知，一般是还不知道是否与服务器的对象不同。 圆圈 表示这个对象与服务器上的内容不相同。如果是本人检出，则不出现该图标。 有关这个内容可参见 PB 的 HTML 帮助（Compiled HTML Help File）中： PowerBuilder User’s Guide The PowerBuilder Environment Chapter 3 Using Source Control Using a source control system 对此有英文原版解释。 版本控制日常操作 在日常的编程中，我们常用到如下命令： 1．添加到版本控制中 Add to Source Control… 当我们新建了一个对象，要将它加入到版本控制中。我们可以选中要加入的对象，单击 鼠标右键，在菜单中选择“Add to Source Control…”添加到版本控制中。 也可选中库，选择“Add to Source Control…”添加到版本控制中。如下图： 2.检出对象进行工作 Check out 我们要对某个对象进行修改的时候，需要将对象检出。我们选中该对象，执行“Check out” 命令。对象即被当前操作用户检出，并且当前用户所检出的对象已自动更新为服务器上最新 的版本。 3 4 3.检入对象提交更新 Check in 将对象修改完毕，需要提交到服务器上，对要提交的对象执行“Check in”命令即可。这样 将服务器上的对象被检入用户本地的对象所更新。多数的版本控制系统是将该对象以新的版 本号来保存。 4.检查更新 Refresh Status 我们工作了一段时间，同伴们修改了其中的某些对象并提交到了服务器中。我们要检查 服务器上的那些对象与本地的不同？选中库或对象执行“Refresh Status”命令。 5.更新本地对象 Get Last Version… 在适当的时候（比如操作者执行了 Refresh Status，或者 PB 自己更新了状态）我们知 道了本地某些对象与服务器上的不一致，我们可以执行 Get Last Version…命令来同步对 象。 常见问 1. 我在对所有对象执行操作的时候，常常没有执行完成就中断了。 答：的确有这样的现象。我发现往往是版本控制系统慢的情况更容易出现这样的问题。更有 甚者，可能会将 PB 这个关掉。所有我们只能够选择部分的对象分批分次执行操作。你 可以一次操作一个 PBL 内的对象，或者一个 PBL 内一半对象执行操作。 2. 我增加了一些对象，如何让我的同伴获得。 答：只要你将这些对象执行 Add to Source Control，就可以了。版本控制系统会记住这些 对象存在于哪些 PBL 中。 3. 如何检出 Target 对象本身？ 答：要检出 Target 对象本身，在选择 Target 执行 Check out 命令的时候，在弹出的窗口中 选择仅对单一文件操作，这样就是对 Target 对象本身进行操作。 4. 增加了一个 PBL，如何让我同伴获得？ 答：你的同伴会在适当的时候得知，他的 Target 对象与服务器上的不一致，他需要同步他 的 Target 对象。同步过后，并不会立即得知 Target 中新增了一个 PBL。当他下次打开 这个 Target（或者打开当前的 Workspace）的时候，PB 会告诉他，缺少一个 xxx.pbl 文件。并新增这个 PBL 文件。 5. 为何有的 PBL 库在得到最新时报错？ 答：这是因为库中的对象，得到有先后次序，有的对象需要关联其它对象，如 windows 对象 中关联有数据窗口对象，但数据窗口对象还未得，所以报错。我们可以全部完成后，再次得 到最新即可。 PB版本控制 PB与版本库连接 PB中显示的图标 版本控制日常操作  常见问题