指定 cleartool 可执行文件的路径

NetBeans IDE 使用计算机中的 $PATH 系统变量自动标识 cleartool 可执行文件的位置。不过，根据您使用的平台或者是否将 ClearCase 客户端安装到了不同位置，可能需要明确指定可执行文件的路径。要在 IDE 中设置 ClearCase 可执行文件的路径。

1. 从主菜单中选择“工具”>“选项”。此时将打开“选项”对话框。
2. 选择对话框顶部的“其他”图标，然后单击“版本控制”选项卡。在“版本控制系统”下面的左侧窗格中，选择 ClearCase。对话框主窗口中将会显示 ClearCase 的用户定义选项：
   
   
3. 在“指定 cleartool 可执行文件路径”文本字段中，输入可执行文件的路径或者单击“浏览”在系统中找到它。
4. 单击“确定”，然后重新启动 IDE，使更改生效。

注意：更多信息请参见 NetBeans ClearCase 集成设置和发行说明。

在 IDE 中打开一个已有项目

如果您已经有一个 ClearCase 版本化项目，那么可以在 IDE 中打开它，版本控制功能将自动变为可用。IDE 扫描打开的项目，如果它们位于 ClearCase 视图目录中，那么文件状态和上下文相关支持会被自动激活。

打开一个 ClearCase 版本化项目：

1. 在主菜单中选择“文件”>“打开项目”，并跟随“打开项目”向导继续操作。指定项目位置时，导航到 ClearCase 视图目录中的项目位置。完成向导之后，该项目就会在“项目”窗口中显示（Ctrl-1），版本控制支持也被激活。

注意：您也可以在“收藏夹”窗口中打开一个项目或目录。如果 ClearCase 目录不是 NetBeans 项目，可能就需要使用这种方法。为此，在“收藏夹”窗口（Ctrl-3）中右键单击，选择“添加到收藏夹”。在显示的“添加到收藏夹”对话框中，导航到计算机上的顶层 ClearCase 视图目录，单击“添加”，一个目录的树视图将会添加到“收藏夹”窗口。

创建一个新项目并将它置于源控制下

也可以创建一个新项目，并将其置于源控制下，然后继续在 IDE 中使用它。在创建新项目时，您需要在 ClearCase 视图中指定它的位置。这会让 IDE 意识到需要版本控制支持。创建项目之后，所有文件起初都被视为 视图私有的文件。然后使用“IDE 添加到源控制”命令将项目添加到 ClearCase 服务器。

要创建新项目：

1. 在主菜单中选择“文件”>“新建项目”，并跟随“新建项目”向导继续操作。第二步是名称和位置，选择 ClearCase 视图中的一个目录。单击“完成”，则项目被创建，并且其目录的树视图被添加到“项目”窗口（Ctrl-1）。创建后，IDE 会自动意识到该项目位于视图中，并且所有相关的 ClearCase 操作和文件状态信息都变为可用。

在 IDE 中打开一个版本化项目时，所有文件和文件夹名称都呈现为绿色，指示它们处于“新”状态。（显示为灰色的任何文件都处于“忽略”状态。更多信息请参见下面的 标识和颜色编码。）IDE 自动决定每个版本化项目文件是否可用于版本控制。（即，包中的源文件通常被视为版本化的，而项目私有文件通常会被忽略）。

可以使用以下选项修改 IDE 处理私有文件视图的方式：

• “ClearCase 选项”对话框中的“计划视图私有文件”检测选项。
• 可以选择“工具”>“选项”>“高级选项”>“系统”>“系统设置”>“忽略的文件”获得忽略的文件设置

既然您的项目已经创建完成，那么您可以使用 IDE 的“添加到源控制”命令使其与 ClearCase 服务器同步。

1. 在“项目”窗口中右键单击项目节点，选择“添加到源控制”。“添加”对话框打开并列出被 IDE 自动忽略的所有新建的视图私有文件。
   
2. 在“描述消息”文本区输入消息。也可以单击右上角的“最新消息”（) 图标，查看以前使用的消息的列表并从中选择消息。
3. 为单独的文件指定操作后，单击“添加”。当“添加”操作发生时，位于界面右下角的 IDE 状态栏将会显示。成功添加后，版本控制标志就会从“项目”、“文件”和“收藏夹”窗口中消失，并且签入文件的颜色编码会变成黑色。

注意：可以在“添加”对话框中指定是否把某些文件排除在“添加”操作之外。为此，单击选定文件的“操作”列，从下拉列表中选择“不添加”。

在源编辑器中查看更改

当在 IDE 的“源编辑器”中打开一个版本化文件时，针对资源库中以前的签出版本对文件进行修改时，可以查看该文件上发生的实时更改。您在操作时，IDE 通过“源编辑器”空白部分中的颜色编码传达了以下信息：

“源编辑器”左侧空白逐行显示发生的更改。当修改给定行时，所做更改会立即在左侧空白中显示出来。

单击空白部分的颜色分组可以恢复新更改。例如，当单击红色图标时，左下方的屏幕截图显示可用的小部件，指示从签出文件中移除的行。

“源编辑器”右侧空白提供了对文件所做的更改的整体视图，从上到下显示。更改文件之后，将会立即生成颜色编码。

注意：单击空白部分的特定点可以让内嵌光标立即转到文件中的该位置。想要查看受影响行的行号，可以将鼠标放在右侧空白中的彩色图标上：

左侧空白

右侧空白

查看文件状态信息

使用“项目”（Ctrl-1）、“文件”（Ctrl-2）、“收藏夹”（Ctrl-3）或“版本控制”窗口时，IDE 提供了一些可视化功能，有助于查看文件状态信息。在下面这个例子中，请注意标志（例如），文件名的颜色和相邻状态标签是如何保持一致的，以提供一种简单有效的方式来跟踪文件的版本控制信息：

标志、颜色编码、文件状态标签和最重要的“版本控制”窗口都有助于在 IDE 中有效地查看和管理版本控制信息。

• 标志和颜色编码
• 文件状态标签
• “版本控制”窗口

标志和颜色编码

标志应用于项目、文件夹、包节点，通知您包含在该节点中的文件状态：

下表显示了用于标志的颜色方案：

UI 组件	描述
蓝色标志 （）	指示当前被签出、劫持或添加的文件或文件夹。对于包来说，这个标志仅应用于包本身，而不用于它的子包。对于项目或文件夹来说，标志将指示出该项及其所包含的任何子文件夹中的更改。

颜色编码应用于文件名，以指示它们的当前状态：

颜色	示例	描述
蓝色		指示文件已被签出。
绿色		指示文件是新建的，并且未被添加至源控制
灰色		指示文件被 ClearCase 忽略，并且不会被包含于版本控制命令中。（例如，“添加到源控制”或者“签入”）如果文件没有被版本化，那么它们只能被忽略。
删除		指示文件被从签入或者“添加到源控制”操作中排除。当选择从一个操作中排除单独的文件时，只能在特定位置删除文本，比如“版本控制”窗口，“签入”对话框和“添加到源控制”对话框。其他 ClearCase 命令（如“更新”命令）仍然会影响到此类文件。

文件状态标签

文件状态标签提供了一个文本指示，指示 IDE 窗口中版本化文件的状态。默认情况下，IDE 在窗口中列出的文件右侧以灰色文本显示它们的状态（新的、保留的、不保留的、忽略的等）信息。然而，您可以根据需要修改此格式。例如，如果您想将版本选择器添加至状态标签，请进行以下操作：

1. 从主菜单中选择“工具”>“选项”。此时“选项”窗口被打开。
2. 选择窗口顶部的“其他”图标，然后单击下面的“版本控制”选项卡。确保版本控制系统下的左侧面板中的 ClearCase 被选上。（请参考上面的 屏幕截图）。
3. 单击状态标签“格式”文本字段右侧的“添加变量”按钮。在显示的“添加变量”对话框中，选择 {version} 变量，然后单击“确定”。版本变量被添加至状态标签“格式”文本字段。
4. 要重新设置状态标签的格式，以在文件右侧仅显示状态和版本选择器，可以按照下列顺序重新排列排列“状态标签格式”文本字段的内容：

   [{status}; {version}]

   单击“确定”。状态标签现在列出文件状态和版本选择器（可用时）：
   

从主菜单中选择“视图”>“显示版本控制标签”，可以打开和关闭文件状态标签。

“版本控制”窗口

ClearCase“版本控制”窗口为您提供了一个实时列表，其中包括对本地工作副本的选定文件夹中的文件所做的所有更改。默认情况下，它会在 IDE 的底部面板中打开，列出新建的、签出的或者劫持的文件。

要打开“版本控制”窗口，选择一个版本化文件或文件夹（例如，从“项目”、“文件”或“收藏夹”窗口中选择），然后从右键菜单中选择 ClearCase >“显示更改”或者从主菜单中选择“版本控制”>“显示更改”。下面的窗口出现在 IDE 底部：

默认情况下，“版本控制”窗口显示一个列表，此列表中包括选定的包或文件夹中的所有文件显示值得注意的状态（即新的、保留的、不保留的等）。您可以单击列出文件之上的列标题，按照名称、状态、位置或者规则对文件排序。

“版本控制”窗口工具栏还包含一些按钮，可用于调用列表中显示的所有文件上的最普通的 ClearCase 任务。下表列出了“版本控制”窗口工具栏中可用的 ClearCase 命令。

图标	名称	功能
	刷新状态	刷新选定文件和文件夹的状态可以对“版本控制”窗口中显示的文件进行刷新以反映任何外部更改。
	全部比较	打开比较查看器，其中提供了本地更改与资源库保存的版本的逐项比较。
	全部更新	更新所有选定文件。（仅适用于快照视图。）
	全部签入	用于签入本地更改。

选择与一个文件对应的表行并从右键菜单中一个命令，这样可以访问“版本控制”窗口中的其他 ClearCase 命令。

例如，您可以在文件上执行以下操作：

显示注释： 在“源编辑”中打开的文件的左侧空白部分显示作者和修订号信息。
从签入中排除： 执行签入时，可以把文件标记为排除。

更改签出文件

如果您在签出文件上执行比较，那么可以在“比较查看器”中直接更改。为此，可以将光标放在“比较查看器”的右侧窗格中，并且相应地修改文件，也可以每个高亮显示的更改旁边的内嵌图标。

替换 （）：	把早期版本中高亮显示的文本插入到签出版本中。
全部移动 （）：	把文件的签出版本恢复为选定的先前版本的状态
删除 （）：	从签出版本中删除高亮显示的文本，使之可以反映出先前版本。

在比较文件之间的差异中导航

如果您的比较中包含多个差异，则可以使用工具栏中的箭头图标在它们之间导航。箭头图标可用于查看从上到下列出的差异：

转至上一个差异 （）：	转至比较中显示的上一个差异
转至下一个差异 （）：	转至比较中显示的下一个差异