< 上一课 | 下一课 >

课程 6:源代码控制

源代码控制组件用于存储、检索和共享项目中的源代码和其他工件。Rational Team Concert™ 的源代码控制(SCM)支持很容易用于各种开发方案,但是它与基于常规文件的 SCM 系统略有不同。因此,让我们开始快速浏览“模型的使用”。
Rational Team Concert 中,无论您是否准备与团队共享变更,我们都希望用户可以充分利用 SCM 跟踪变更和将变更版本化的能力。相应地,作为一个用户,您具有自己的私有存储库工作空间,用于存储您所作的变更,无论您何时决定使它们可供您所在的团队使用。有时,您可能工作几个小时之后就决定共享变更,有时候也可能经过一天或者更长时间之后才决定共享变更。关键是您所作的变更保存在存储库中以及您决定何时使它们可供团队使用。当您装入存储库工作空间时,就会将其中的文件和文件夹转移到您使用的计算机上的 Eclipse 工作空间中。要将 Eclipse 工作空间中的变更推送到存储库工作空间,请检入此变更。

用来存储团队的工作。当您想让所作的变更可供团队使用时,请将它们从存储库工作空间交付中。当您希望合并其他团队成员所作的变更时,请从流中接受这些变更。注意,您还可以直接从另一个存储库工作空间中接受变更,从而允许团队成员之间以细粒度方式共享变更。例如,两个团队成员可以协作完成细微错误的修订;或者,如果某个人启动了某项变更,但是他需要去度假,那么另一个团队成员可以继续完成他的工作,稍后再交付变更。

源代码控制工作流程

变更集中包含您在存储库工作空间中进行的所有变更。每个变更集都由对一个或多个文件或文件夹所作的一组显式、原始变更组成。变更集还可以附带注释和进行变更的原因,这通常是通过引用相关工作项来完成的。源文件库是在稳定增长的变更集基础上构建的,每个变更集都以之前的所有变更为基础。每个存储库工作空间或流都基于一系列的变更集。

请开始进行变更并了解可以如何在日常工作中使用这些概念。

创建存储库工作空间

第一步是查找用于团队区域的流。您通过流与团队共享代码。
  1. 团队工件视图中,依次展开 Prelude 项目区域和源代码控制,然后展开团队 1 流以查看组件。如果在源代码控制下方未显示任何条目,请查看屏幕快照中标注的“定制我的过滤器”下拉菜单。打开此下拉菜单并确保选择了所有团队区域
    注: 当您作为多个团队的成员时,您会发现经过定制的过滤器非常有用。

    可以将流和存储库工作空间划分为多个独立的组件。由于每个组件都有它自己的历史记录,因此,如果团队要构建分层软件,其中的各个部分采用半独立式方式进行开发,然后单独进行部署,那么将一个产品分成多个组件对于这些团队来说很有用。简单存储库工作空间和流只包含单一组件。在我们提供的示例中,“团队 1 流”只包含一个组件(称为“缺省组件”),此组件将包含所有文件和文件夹。

    “团队 1 流”的缺省组件流

  2. 为团队区域选择标签为团队 1 流(团队 1)的流。
  3. 单击鼠标右键,然后单击新建 > 存储库工作空间
  4. 新建存储库工作空间向导的新建存储库工作空间页面上,在存储库工作空间名称字段中输入 Chris on Prelude,然后单击完成 此操作将创建新的存储库工作空间并将其装入到 Eclipse 工作空间中。由于此流中尚不包含任何代码,因此会快速完成装入过程。
  5. 装入存储库工作空间之后,它将显示在暂挂的变更视图中。如果未显示暂挂的变更视图,请单击 窗口 > 显示视图 > 暂挂的变更
  6. 可选: 如果您先前已经能够完成团队邀请教程,那么您已经完成了在初始化项目时所创建的其中一个工作项。再次运行打开工作项查询,并记下 [加入团队] 创建存储库工作空间工作项。现在,您可以打开该工作项并像先前解决定义团队成员工作项那样解决此工作项。
已装入的存储库工作空间的特别之处在于,每当您对 Eclipse 工作空间中已装入的文件或文件夹进行变更时,就会跟踪这些变更并将其显示在暂挂的变更视图中。在此视图中,您可以管理变更并执行一些常用任务,例如:
  • 将变更检入到存储库工作空间中。
  • 将变更组织成变更集。
  • 撤销您所作的变更。
  • 使变更集与工作项相关联。

在后续章节中,您将了解有关“暂挂的变更”视图的更多信息,因为它确实是开发者完成日常工作的重心所在。

编辑代码

在加入一个流之后,您可以编写代码和生成用于构成项目的工件。
如果您想尝试使用 Rational Team Concert 来处理一个小项目中的某些 Java™ 包,那么现在就可以从包资源管理器视图中将这些项目导入 Eclipse 工作空间中,这可以通过从上下文菜单中选择导入选项来实现。但是,如果您没有任何感兴趣的代码要开始处理,那么可以创建一个简单的 Java 应用程序,或者创建一个包含单个文本文件的简单项目。
  1. 要获取有关在 Jazz 客户机中创建简单 Java 应用程序的帮助,请单击帮助 > 备忘单
  2. 选择备忘单对话框中,展开 Java 开发类别,然后单击创建 Hello World 应用程序。单击确定 此备忘单将显示在 Jazz 客户机窗口中,它将指导您创建一个简单的 Java 应用程序。有关更高级的帮助,请参阅 Eclipse Java Development User Guide
    注: 本教程的作者已经创建了一个名为 Hello Prelude 的简单 Java 项目。

使代码受 Jazz Source Control 控制

将一些代码导入到 Eclipse 工作空间或者在 Eclipse 工作空间中手动编写代码之后,可以将代码检入到服务器上的存储库工作空间并与团队共享项目。
检入就是将代码从 Eclipse 工作空间移入存储库工作空间的过程。将代码从存储库工作空间移入流中以便与您所在团队共享的过程称为交付。您可以变更 Jazz Source Control 首选项以指定自动检入。您也可以在断开连接的情况下工作,然后在重新连接之后进行检入。

要将项目检入到 Jazz Source Control 中,请执行下列操作:

  1. 打开 Java 透视图。如果这不是当前透视图,请单击窗口 > 打开透视图 > Java
  2. 包资源管理器视图中,选择 Hello Prelude 项目。
  3. 单击鼠标右键,然后单击团队 > 共享项目
  4. 共享项目向导的共享项目页面上,选择 Jazz Source Control,然后单击下一步
  5. 选择组件页面上,确保从页面顶部的下拉列表中选择 chris@localhost 存储库连接。并且,还应确保选中选择现有存储库工作空间中的组件。展开 Chris on Prelude 并选择缺省组件。单击下一步
  6. 尽管您可能不必变更查看已忽略的资源页面上的任何内容,但是应验证或完成要忽略的资源以便于共享。单击完成 现在,已经将您的代码检入存储库工作空间中,但是尚未交付给流。
  7. 可选: 切换到暂挂的变更视图。在 Java 透视图中,单击 窗口 > 显示视图 > 暂挂的变更 此视图应该已在您装入并共享项目时打开。如果展开缺省组件,那么您将看到刚刚共享的项目的变更集。我们已经对共享操作进行跟踪,相应的变更已被自动检入到存储库工作空间中。
  8. 可选: 该变更集已经有共享项目注释与其相关联。要变更注释,或者要对将来未自动获得注释的变更集添加注释,请用鼠标右键单击变更集,然后单击编辑注释。在编辑窗格中,输入注释,然后按 Enter 键。
  9. 可选: 要浏览组件目录结构,请在暂挂的变更视图中右键单击缺省组件,然后单击显示 > 存储库文件。在存储库文件视图中,您将看到刚刚共享的项目。
  10. 可选: 要检查存储库工作空间的历史记录,请在暂挂的变更视图中右键单击缺省组件,然后单击显示 > 历史记录历史记录视图将列示创建组件时生成的初始变更集以及您刚刚创建的第二个变更集。要探查变更集的内容,请双击变更集。变更浏览器视图将打开,并且将允许您浏览该变更集中的文件。

将您的变更交付给团队

在本节中,您将看到用于表示您已编写的代码的变更集。然后,将使您的变更集与现有工作项相关联。最后,将您的代码交付给流。
您迄今为止所作的所有变更都存储在存储库中的存储库工作空间中。

要交付变更并使其可供其余团队成员使用,请执行下列操作:

  1. 暂挂的变更视图中,右键单击变更集,然后单击关联工作项
  2. 在“选择工作项”对话框中,取消选中仅分配给我的工作项复选框。
  3. 包含标识或文本字段中,输入 share 此时将显示在摘要中包含单词 share 的工作项。
  4. 选择标有与 Jazz Source Control 共享代码的工作项并单击确定 此操作将在您编辑的代码与上述操作所解决的工作项之间创建连接。
  5. 要交付并解决工作项,请在暂挂的变更视图中完成下列步骤:
    1. 右键单击变更集,然后单击交付并解决工作项
    2. 交付并解决对话框中,确保选中解决工作项复选框。
    3. 对工作项添加注释窗格中,输入将对该工作项添加的注释。
    4. 单击完成
    该工作项被解决,您的代码现已从服务器上的存储库工作空间交付到团队区域的流,在该流中,它现在可供其余团队成员访问。
  6. 可选: 刷新历史记录视图。此视图将指示该变更集已经与该工作项相关联。
  7. 可选: 团队工件视图中的团队 1 流中,右键单击缺省组件,然后单击显示 > 历史记录历史记录视图将在该流中显示您的变更集。
  8. 可选: 历史记录视图中,要打开与该变更集相关联的工作项,请用鼠标右键单击该变更集,然后单击打开工作项 该工作项被解决,并且将包含指向您为此工作创建的变更集的链接。

课程检查点

在本课程中,您学习了 Jazz Source Control 的基础知识。
< 上一课 | 下一课 >

反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误