基于 Eclipse SDK 构建软件的方式在开发人员中日益流行，通过本文你将了解到如何提供一个完全的集成环境，把与 ClearQuest 集成的 ClearCase 统一变更管理 （Unified Change Management，UCM）的最佳实践通过单一的视图带给用户。

前言

ClearCase（简称 CC）、ClearQuest（简称 CQ）是 IBM Rational 产品线中的旗舰产品，是全球领先的软件配置管理和变更管理工具，它广泛地应用于众多的企业级软件工程实践之中，拥有众多的企业级用户。

通过客户化定制，无论是十人以下的开发小组还是几千人的分布式研发团队都可以从中得到配置管理和变更管理的最佳实践经验和技术。而集成 CQ 的 CC 统一变更管理 UCM（Unified Change Management） 更是目前第三代配置管理系统的代表，它将配置管理从传统的基于文件、目录等元素为操作对象提升到以活动、基线为驱动的一个更高层次上来。

Eclipse 从诞生之日起已经逐步成为主流的 Java 集成开发环境，而 Eclipse3.1 的推出开始把 Eclipse 从单纯的 Java 集成开发环境逐步转变软件全生命周期工具，随着越来越多的商业公司基于 Eclipse 提供更多的版本化组件，相关插件不断增加，Eclipse 已经成为我们下一代的集成工具平台。

基于 Eclipse SDK 构建软件的方式在开发人员中日益流行，通过本文你将了解到如何提供一个完全的集成环境，把与 CQ 集成的 CC 统一变更管理的最佳实践通过单一的视图带给用户。

文中提到得到 CC、CQ 均为 7.0.0.1（7.0.0.0 + Fix Pack 1）版本。

UCM 介绍

Rational 软件提出的统一变更管理（UCM）是用于管理软件开发过程（包括从需求到版本发布）中所有变更的"最佳实践"流程。UCM定义了一个可以立即用于软件开发项目的一致并基于活动的变更管理流程。通过 Rational CC 和 CQ 的支持，UCM 已成为 Rational 用于软件开发最佳实践的全面框架 —— Rationial 统一过程（RUP）的关键组成部分。

UCM 通过抽象层次的提升简化了软件开发，从而使得软件开发团队从更高的层次根据活动（activity）来管理变更。通过 UCM，一个开发活动可以自动地同其变更集（封装了所有用于实现该活动的项目工件）相关联，这样避免了管理人员手动跟踪所有文件变更。使用UCM还可以获得以下好处：

1. 预定义的工作流程：可以直接采用预定义的 UCM 工作流程，快速提升开发组织的软件配置管理水平；
2. 项目的跟踪和组织：项目管理人员可以实时掌握项目的最新动态，合理分配资源和调度开发活动；
3. 协作自动化：通过将许多耗时较多的任务自动化处理，UCM 使得开发人员更多地将注意力集中在更高层次的开发活动上；
4. 轻松管理基线：UCM 将开发活动嵌入到各个基线中，这样测试人员确切地知道他们将测试什么，而开发人员则确切地知道其他开发人员做了什么；
5. 支持跨功能开发组：UCM 已成为 Rational 产品中的核心部分，从而可以将从需求到测试各个阶段的工件（例如需求文档、设计模型、应用源代码、测试用例以及 HTML 及 XML 内容等）在 UCM 框架下进行统一集成，简化了贯穿整个软件开发周期的变更过程；
6. 基于同一代码构件可以进行多项目开发，简化了多项目开发管理，增大了代码共享，节省了开发资源；

UCM 的上述特点使得开发团队将配置管理和变更管理完整地集成在一起，真正意义上实现了任务驱动的开发模式。UCM 具体是通过 CC 和 CQ 之间的集成来实现的。下面，我们将介绍最新的基于 Eclipse SDK 的 CC/CQ 集成。

在 Eclipse SDK 上安装 CC/CQ 插件

Eclipse 是替代 IBM Visual Age for Java（以下简称 IVJ）的下一代 IDE 开发环境，但它未来的目标不仅仅是成为专门开发 Java 程序的 IDE 环境，根据 Eclipse 的体系结构，通过开发插件，它能扩展到任何语言的开发，甚至能成为图片绘制的工具。Eclipse 最有魅力的地方就是它的插件体系结构。在这个体系中重要的概念是扩展点（extension points），也就是为插件提供的接口。每一个插件都是在现有的扩展点上开发，并可能还留有自己的扩展点，以便在这个插件上继续开发。在 Eclipse 中实现的绝大部分功能是由相应的插件完成的，比如 WrokBench UI 插件完成界面的外观显示，Resource Management 插件完成维护或生成项目或文件等资源管理工作。下图显示了 Eclipse 的插件体系结构。

下文将要介绍的 CC/CQ 插件正是基于 Eclipse 的插件体系构建的。也就是说，现在我们能实现在 Eclipse SDK 的 IDE 开发环境中通过插件的方式直接使用 CC/CQ 提供的功能了。在其他基于 Eclipse SDK 所构建的 IDE 中，例如在 Rational Software Architect 或 Rational Application Developer 中也能通过相同的方式来实现同样的功能。

下面我们将介绍本文所涉及的三个 Eclipse 插件。为了在 Eclipse 上安装 CQ 插件，需要首先下载并安装一个 Eclipse 补充插件 EMF runtime。同时，为了保证在使用过程中不会出异常错误，必须按顺序先安装 EMF runtime 插件，再安装 CQ 插件，最后安装 CC 插件。

安装 CQ 插件

如上文所述，为了在 Eclipse 上安装 CQ 插件，需要首先下载并安装一个 Eclipse 补充插件 EMF runtime。根据 Eclipse SDK 不同的版本下载相应版本的 EMF runtime 插件，与 Eclipse SDK3.2 对应的是 EMF runtime 2.2。EMF runtime 下载地址请参考 下载部分。

CQ 在 Eclipse 上的插件缺省情况下已经部署到 CQ 的安装目录中，一般情况下位于 C:\Program Files\Rational\CQ\eclipse。

1. 为 Eclipse SDK 安装 EMF runtime 插件。

EMF（Eclipse Modeling Framework）是 Eclipse 模型框架插件，CQ 插件在工作中需要依赖于 EMF 插件。如果在 Eclipse SDK 中尚没有该插件，可以通过以下步骤来安装：

• 1) 通过双击 Eclipse 桌面快捷方式启动 Eclipse 工作台，点击Help > Software Updates > Find and Install
• 2) 在弹出的窗口中选择 Search for new features to install 并点击 Next；在弹出的窗口中点击 New Local Site
• 3) 在弹出的浏览窗口中进入下载并解压到本地目录中的 EMF runtime 文件夹，选择其中的 eclipse，点击“确定/OK”；在弹出的窗口中可以选择修改刚创建的 Site 名称，完成后点击 OK；在返回的安装界面中确认新创建的 Site: emf-sdo-runtime-2.2.2/eclipse 被选中，点击 Finish。
• 4) 在返回的窗口中选择新创建的 Site: emf-sdo-runtime-2.2.2/eclipse，点击 Next；在返回的窗口中选择接受许可协议内容，点击 Next
• 5) 如果安装成功则会弹出以下页面，点击 Finish，按照提示重新启动 Eclipse 工作台。

完成上述步骤即可开始安装 CQ 插件。

2. 为 Eclipse SDK 安装 CQ 插件

为了确保安装顺利，需要在安装 CC 插件之前安装 CQ 插件。请按照以下步骤安装 CQ 插件：

• 1) 在 Eclipse 工作台中，点击 Help > Software Updates > Find and Install；选择 Search for new features to install 并点击 Next
• 2) 在弹出的窗口中点击 New Local Site；选择 CQ 安装目录中的 eclipse 文件夹，默认情况下是 C:\Program Files\Rational\CQ\eclipse，点击“确定/OK”。接着系统会弹出另一个窗口，你可以选择修改刚创建的 site 的名字，接着点击“确定/OK”
• 3) 在返回的安装界面中确认新创建的 Site 被选中并点击 Finish；在弹出的窗口中选择 Rational CQ_7.0.0，点击 Next；
• 4) 在返回的窗口中选择接受许可协议内容，点击 Next
• 5) 在返回的安装界面中点击 Finish，按照提示重新启动 Eclipse 工作台。

安装结束后可以通过以下步骤查看 CQ 插件是否安装成功：

1) 在新启动的 Eclipse 工作台中点击 Window > Customize Perspective，在弹出的窗口中确保 command 标签里的 CQ 选项被选中并点击 OK。

2) 在返回的界面中可以看到 Eclipse 工作台主菜单栏中出现 CQ 菜单。

下面开始最后一步的安装，安装 CC 插件。

安装 CC 插件

Rational 提供针对诸多 Eclipse 版本的 CC 插件，请根据 Eclipse SDK 的版本选择一个适当的 CC 插件版本并按照以下步骤进行集成。Eclipse SDK 下载站点请参考 下载部分。

• 1) 从 Rational 官方站点下载适当的插件并解压到本地目录下。本文选择最新的适合 Eclipse3.2 的版本：com.r.cc.win32-20061206.zip。
• 2) 通过双击 Eclipse 桌面快捷方式启动 Eclipse 工作台，选择 Help > Software Updates > Manage Configuration 在弹出的 Product Configuration 窗口中点击 Add > Extension Location
• 3) 在弹出的 “Browser for Folder/浏览文件夹”窗口中选择步骤 1 中从 Rational 官方 Eclipse 插件下载站点下载的插件 com.r.cc.win32-20061206.zip 所解压到本地的文件夹。在打开的插件文件夹中选择 Eclipse 目录并点击“确定/OK”
• 4) 在弹出的 Install/Update 窗口中选择 OK，重新启动 Eclipse

安装结束后可以通过以下步骤查看 CC 插件是否安装成功：

1) 在新启动的 Eclipse 工作台中点击 Window > Customize Perspective，在弹出的窗口检查 command 标签里的 CC 选项是否被选中。

2) 在 Eclipse 工作台中可以看到 CC 菜单项，点击其中的 Connect to Rational CC 后发现菜单中的 CC 命令被激活

至此，我们已经完成了全部插件的安装。安装成功并通过测试后，启动这些软件。如果发现 CC/CQ 工作异常，请通过文后的 参考资源 联系 Rational 技术支持中心。

使用前注意事项及准备工作

在 Eclipse 平台上和 CQ 集成的 CC UCM，使用模式和在普通的 CC、CQ 客户端上有很大的差别。主要是因为 Eclipse 基于 Workspace 和 Project 的操作方法不同于普通的 CC 客户端；还有就是 CC，CQ 在 Eclipse 插件中的使用过程也有一些改变。下文将一一叙述这些差别和需要注意的事项。

使用前的注意事项

CQ 和 CC UCM 集成的过程本身并不是在 Eclipse 上完成的，用户仍然需要使用 CC 普通客户端上使用 Project Explorer 组件来对 UCM 进行管理，例如创建 Component，创建、修改 Project，调整 UCM 的策略等等。

在 Eclipse 平台上多组件使用模式（Multi-Component）受到很大限制，如果需要使用动态视图，还需要另外一个 CC MVFS 插件的支持。下载 CC MVFS 插件请参考 下载部分。

还需要注意的是：如果使用动态视图，由于 Java 开发中很多文件名称是大小写区分的，因此需要设置 CC 的大小写敏感模式。打开控制面板 > CC > MVFS 进行设置。推荐使用 case insensitive MVFS。 如果启动 case preserving，可以保留大小写（如果不启动，创建的所有文件名，MVFS 会自动转换为小写的名字）。

使用前 CC/CQ 的准备工作

在开始使用 CC/CQ 在 Eclipse 上的插件前，需要在 CC 和 CQ Windows 客户端中创建 PVOB，VOB，Component，CQ Schema 数据库，CQ 用户数据库等对象。在和 CQ 集成的 CC UCM 中，所有的活动来自 CQ，当用户执行 workon 或者 set activity 后，来自 CQ 的活动将转化为 CC 中的 activity。下图显示了通过 Activity（活动），把 CC、CQ 集成到一起实现完整的 UCM 工作模式。

1. CQ 中的准备工作

CQ 的模式数据，例如变更类型、字段、流程和表单等存储在模式数据库（Schema Repository）中；而实际使用的数据记录都存储在用户数据中（User Database）；Schema 也称作模式，其中包含有一系列的工作流程和表单，每个 Schema repository 中含有多个 Schema，一个 Schema 可以具有多个版本用来进行版本控制，每个 Schema 的某个版本都可以对应到多个用户数据库中去。连接（Connection）表示你准备连接到哪个模式库。在 CQ 准备工作中，我们需要首先创建 Schema repository，再建立用户数据库，并创建一个和 Schema repository 同名的 Connection。操作步骤如下。

• 1) 创建一个名为 7.0.0 的 Schema repository
• 2) 创建一个基于 Enterprise Schema 模式的用户数据库，名为 demo
• 3) 创建一个和 Schema repository 7.0.0 同名的 Connection

以上步骤完成后可以通过使用缺省管理员账户 admin 密码为空，登录到 demo 数据库中验证 CQ 准备工作是否成功。

2. CC 中的准备工作

在 CC UCM 模式下，CC 用组件（Component）来组织归纳源数据，用 PVOB 来存放项目有关的信息，例如活动、基线、项目以及变更集等信息，同时可以把 CC 中的项目（Project）和 CQ 的用户数据库之间建立其 UCM 连接，这样 CC 中的活动和 CQ 用户数据库中的记录直接对应起来，实现了变更管理系统和配置管理系统的无缝集成。下图展示了 UCM 对象间的各种关联关系。

下面我们来创建各种 UCM 对象，包括 CC 中的 PVOB，CC Component，CC Project 以及各种 CC 视图和流，并且要把 CC Project 和 CQ 的 User DB 建立起 UCM 关联，它们之间的映射关系如下图。

具体操作步骤如下：

• 1) 创建一个名为 DEMO-PVOB 的 UCM Project VOB
• 2) 创建一个 CC Component VOB 名为 demoComps
• 3) 在 demo-comp VOB 中创建一个 component 名为 Current-Projects
• 4) 创建一个 CC Project 名为 demo-proj
• 5) 把项目 demo-proj 和 CQ 中 demo 数据库建立起 UCM 连接
• 6) 加入到 demo-proj 中，同时创建两个静态视图分别为：administrator_demo-proj，administrator_demo-proj_int 前者为开发视图，后者为集成视图
• 7) 从集成视图中在 demoComps 中的 Current-Projects 目录下创建两个子目录分别为 existing project 和 new project

以上步骤完成后 CC 准备工作已经成功完成。

开始在 Eclipse 中使用 UCM

完成了前述准备工作，就可以开始在 Eclipse 中使用 UCM 了。下文将分别介绍在日常工作中最常见的两个场景：
1) 已有 Eclipse 项目在 UCM 中的用例场景。该场景介绍如何把已有 Eclipse 项目导入到 UCM 中并按照 UCM 的工作流程进行开发。
2) 新建 Eclipse 项目在 UCM 中的用例场景。该场景介绍如何在 Eclipse UCM 集成环境中创建项目并按照 UCM 的工作流程进行开发。

已有 Eclipse 项目在 UCM 中的用例场景

本文将根据一个典型的 UCM 工作流程来描述 Eclipse 环境下的操作方式。

在 CC 客户端中，用户加入项目进行开发的时候，系统通常会创建集成流、开发流和集成视图以及开发视图。

对于 UCM 工作流程来说，CC 客户端和 Eclipse 环境没有分别。但在 Eclipse 环境里面，由于在一个 Workspace 中不能存在两个同名的 Project，所以集成环境和开发环境分别用不同的 Eclipse Workspace 来承载。

下面将解释如何在 Eclipse 中已有的开发项目中导入 CC。

1. 在 Eclipse 中将已经存在的项目导入 CC

通常将已经存在的源代码加入到 UCM 项目中会选择在集成流中加入。这样做的目地是让这些源代码的版本树有一个清晰的层次结构。如果在开发流上加入源代码，那么版本树上的集成流和开发流应并行排列，如下图中左边的源代码版本树的层次结构；而我们想要的是图中右边版本树的层次结构，集成流下面是开发流。

操作步骤如下：

• 1) 右键点击 Eclipse 中已经存在的项目，选择 Team > Share Project
• 2) 在弹出的 Share Project 窗口中选择 CC SCM Adapter 并点击 Next
• 3) 选择 administrator_demo-proj_int 视图中 demo-comp VOB 里的 Current-Projects component 下的 existing project 目录，在返回的 Share Project 窗口中选择 Finish
• 4) 在弹出的 Add Element to Source Control 窗口中点击 OK，将把列表中所有被选择的元素加入到 CC 版本控制中。如果不想把中间目标文件和可执行文件加入 CC 中，可以手动选择具体要加入那么文件及目录。接着系统会弹出选择 activity 的窗口，创建或选择一个已有的 activity，点击 OK，整个项目内容都转移到 CC 视图里了。
  图16. 选择导入哪些 Eclipse 项目的内容到 CC 中
  
  图17. 在 CC 中导入 Eclipse 项目时选择一个工作活动
  
• 5) 通过 Project Explorer，在集成流 demo-proj_int 上创建一条基线以包含以上在集成流中所做的变化，并设其为推荐基线。

导入完成后，Eclipse 项目的内容都已经存放到 CC 中了，其他开发人员通过加入到 CC 项目中就可以对 Eclipse 项目进行开发。

2. 其他团队成员如何导入项目内容进行开发

当原有的 Eclipse 项目导入 CC 后，其他开发团队成员需要通过 CC Join Project 功能加入到该项目中并创建开发流、开发视图和集成视图。再将该项目从 CC 开发流中导入到个人的工作空间（workspace）中就可以进行开发了。

对于集成流和集成视图，需要再创建一个工作空间（workspace），并把项目的集成流导入到该工作空间（workspace）中。

• 1) 在开发团队成员的 Eclipse Workspace 中通过 CC 下拉菜单选择 Join Project。在此期间分别创建新的开发流、开发视图和新的集成视图。
• 2) 在开发成员的 Eclipse Workspace 中选择 File 下拉菜单中的 Import，将新建立的 CC 开发视图中的 Eclipse Project 导入到当前的工作空间（workspace）中来。
• 3) 在弹出的 Import 窗口中选择将已经存在的项目导入到工作空间（workspace）中
  图18. 将已经存在的项目导入到工作空间（workspace）中
  
• 4) 点击 Browse 按钮，进入到新创建的开发流中，选择已经导入到 CC 中的原有的名为 existing java project 的 Eclipse Project，不要选择 copy projects into workspace。
  图19. 不要选择 copy projects into workspace
  
• 5) 在返回的导入窗口中点击 Finish，返回到 Eclipse 工作台后可以看到项目已经从 CC 视图中导入到 Eclipse Workspace，形成开发类型的工作空间（workspace）
• 6) 在 Eclipse 中进行日常开发工作。一旦项目加入到 Eclipse 后，对于开发人员来说其使用过程就变的简单了。
  图20. 在 Eclipse 中进行日常开发工作
  
• 7) 切换到新的 Eclipse Workspace 中选择 File 下拉菜单中的 Import，将 CC 集成视图中的 Eclipse Project 导入到新的工作空间（workspace）中来，形成集成类型的工作空间（workspace）

3. 典型的 UCM 工作过程

上面我们讲述了如何把已有的 Eclipse 项目导入到 CC 中进行开发，接下来我们将基于一个典型的 UCM 工作流程介绍在 Eclipse 集成环境上的操作过程。

下文将根据前面介绍的典型 UCM 工作流程来描述 Eclipse 环境下的操作方式。

在这个工作流程中：

• 1) 项目主管把一个任务分配给某个开发人员
• 2) 开发人员工作在这个任务上进行修改代码
• 3) 修改后比较开发流工作空间（workspace）和集成流工作空间（workspace）的不同
  
  图22. 开发流工作空间（workspace）和集成流工作空间（workspace）的不同
  
  　
• 4) 检入代码，并将该任务交付（deliver）到集成流，比较两个工作空间（workspace），发现内容一样
  
  图23. 将该任务交付（deliver）到集成流
  
  　
• 5) 集成人员在集成流上创建新的基线
• 6) 开发人员通过 Rebase 操作更新到最新的基线，继续进行开发。

这样，我们就在 Eclipse 集成环境里完成了一个完整的 UCM 工作过程，实现了在单一开发人员界面中以任务为驱动的开发过程。

新建 Eclipse 项目的 UCM 用例场景

在实际应用中可以把 CC UCM 项目和 Eclipse 项目一一对应，也可以在一个 CC UCM 项目中包含多个 Eclipse 项目，但不能将一个 Eclipse 项目分布在多个 CCUCM 项目中。在 UCM 项目可以存在多个 component，但 Eclipse 项目通常都放在一个 component 中，这样可以保持 Eclipse 项目目录结构的完整性(例如 Java project)；如果要在 Eclipse 项目中使用 UCM 的多 component 模型，则其通常是普通的项目（General project），对于例如 Java project 这样有着固定目录结构的项目，在 UCM 中需要额外使用符号链接的方式才能实现多 component 模型。在本文中我们选择将新的 Eclipse 项目创建在已经存在的 UCM 项目 demo-proj 中唯一的 component :Current-Projects 里。

本用例场景首先由配置管理人员或项目经理在 UCM 的集成视图中创建一个新的 Eclipse 项目，然后开发人员加入该项目并把整个项目导入 Eclipse 环境中进行开发。

1. 在集成视图中创建新的 Eclipse 项目

通过在集成视图中创建 Eclipse 项目，可以维护整个版本树的层次结构，对此我们在上一章已经介绍过了，这里不再叙述。

1) 在 Eclipse 工作台中选择 File > New > Project，在弹出的窗口中选择 Java Project。Eclipse 中有多种类型的项目，它们不会影响 CC 的操作。

2) 在弹出的 New Java Project 窗口中输入 Project 名字，并选择项目的存放位置为 administrator_demo-proj_int 视图中 demo-comp VOB 里的 Current-Projects component 下的 new project目录。

3) 在返回的 New Java Project 窗口中点击Next。

4) CC 提示要将哪些文件纳入版本控制中，点击 OK，CC 提示要有一个活动与之关联。

5) 选择 New 创建一个类型为 BaseCMActivity 的 UCM 活动。

6) 在返回的管理活动的窗口中点击 OK，新的 Eclipse 项目创建完成。

2. 将新创建的项目导入到个人开发空间（workspace）中

上一节介绍了如何在集成视图中创建 Eclipse 项目，为了让其他开发人员加入到新建 Eclipse 项目的开发过程中来，我们需要在集成流上创建一条基线，用来作为其他开发人员的引用对象，并把该基线设为推荐基线。

1) 通过 CC Project Explorer在集成流上创建并推荐新的基线

2) 通过 Rebase 操作，开发人员将新创建的项目引入到开发流中

3) 在 Eclipse Workspace 中点击 File > Import，在弹出窗口中选择 Existing Project into Workspace。在选择来源位置的时候，请选择开发流、开发视图中的内容

4) 导入后的 Eclipse 视图内容，可以看到新创建的项目已经被加入到开发类工作空间（workspace）中了。

3. UCM 工作过程

和已有 Eclipse 项目在 UCM 中的工作过程一样，具体内容请参考上一章。

通过在 Eclipse 集成环境中创建一个新的 Eclipse 项目，我们可以看到 Eclipse 项目在 CC 中的是很容易管理的，并且不改变原有 Eclipse 上的工作方式。需要注意的是，不同的 Eclipse 工作空间需要放到不同的 CC 视图中。

总结

本文重点描述如何在 Eclipse 平台上安装并在 UCM 模式下使用 CC、CQ插件，包括各种插件的安装配置，需要注意的事项等。在典型的 UCM 工作流程下，通过文中两个用例场景我们可以看到 Eclipse 平台强大的整合能力，其通过插件形式把开发人员常用的开发工具、管理工具都集成在一起，减少用户学习不同工具界面的成本，加快用户掌握新工具的速度。通过 CC、CQ 提供的基于活动的统一变更管理流程，以及在此基础上集成需求管理工具 RequsitePro，分析设计工具 RSA 等，可以实现在单一界面中完成软件从需求、分析设计、开发到测试的全生命周期过程。

参考资料

• 在 developerWorks 上可以找到 ClearCase 产品资源页面。
• 参考 “利用 WebSphere Studio 和 Eclipse 的集成 SCM 提高开发人员的生产力”。
• 参考 “第三代配置管理解决方案：统一变更管理（UCM）”。
• 请访问 IBM developerWorks 中国网站 Rational 专区 能得到更多关于 IBM IBM Rational 产品的文章、教程和其他参考资源。