blob: 731ab055b32027b3a096b06860be122628feea81 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<meta name="author" content="troy.giunipero@sun.com">
<meta name="description" content="A preview of ClearCase Features in NetBeans IDE 6.9 and more recent">
<meta name="keywords" content="NetBeans, IDE, integrated development environment,
ClearCase, IBM, versioning, open source, developers, collaborate">
<link rel="stylesheet" type="text/css" href="../../../netbeans.css">
<link rel="stylesheet" type="text/css" href="../../../lytebox.css" media="screen">
<script type="text/javascript" src="../../../images_www/js/lytebox-compressed.js"></script>
<title>Использование поддержки ClearCase в IDE NetBeans</title>
</head>
<body>
<!--
Copyright (c) 2009 - 2014 Oracle and/or its affiliates. All rights reserved.
-->
<h1>Использование поддержки ClearCase в IDE NetBeans</h1>
<p>Поддержка ClearCase в среде IDE рассчитана на помощь пользователю в выполнении задач контроля версий напрямую в проекте при работе в среде IDE.</p>
<p>Настоящий документ содержит пошаговое описание базовых шагов по использованию ClearCase в IDE NetBeans.</p>
<p>Rational ClearCase является программным средством контроля версий, разработанным корпорацией IBM. ClearCase формирует основу контроля версий для проектов на многих крупных и средних предприятиях.</p>
<p><strong>Содержание</strong></p>
<img alt="Содержимое этой страницы применимо к IDE NetBeans 6.9 и более поздним версиям" class="stamp" src="../../../images_www/articles/73/netbeans-stamp-80-74-73.png" title="Содержимое этой страницы применимо к IDE NetBeans 6.9 и более поздним версиям">
<ul class="toc">
<li><a href="#settingUp">Установка и настройка ClearCase</a>
<ul>
<li><a href="#specifying">Указание пути к исполняемому файлу <tt>cleartool</tt></a></li>
</ul></li>
<li><a href="#starting">Начало работы над файлами с контролем версий</a>
<ul>
<li><a href="#opening">Открытие существующего проекта в среде IDE</a></li>
<li><a href="#addingSourceControl">Создание нового проекта и внесение его в систему контроля версий</a></li>
</ul></li>
<li><a href="#editing">Изменение файлов исходного кода</a>
<ul>
<li><a href="#viewingChanges">Просмотр изменений в редакторе исходного кода</a></li>
<li><a href="#viewingFileStatus">Просмотр информации о состоянии файла</a></li>
<li><a href="#comparing">Сравнение версий файлов</a></li>
</ul></li>
<li><a href="#checkingin">Возврат файлов исходного кода после изменения</a></li>
<li><a href="#seeAlso">Дополнительные сведения</a></li>
</ul>
<p><strong>Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.</strong></p>
<table>
<tbody>
<tr>
<th class="tblheader" scope="col">Программное обеспечение или материал</th>
<th class="tblheader" scope="col">Требуемая версия</th>
</tr>
<tr>
<td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">IDE NetBeans</a></td>
<td class="tbltd1">версия 6.9 и более поздние</td>
</tr>
<tr>
<td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Комплект для разработчика на языке Java (JDK)</a></td>
<td class="tbltd1">версия 6, 7 или 8</td>
</tr>
<tr>
<td class="tbltd1">Клиентское программное обеспечение ClearCase</td>
<td class="tbltd1"> Версия 7.0 и более поздние</td>
</tr>
<tr>
<td class="tbltd1">Подключаемый модуль ClearCase для среды IDE NetBeans </td>
<td class="tbltd1">Версия 0.9.х и более поздние</td>
</tr>
</tbody>
</table>
<p><strong class="notes">Примечание. </strong>Чтобы получить подключаемый модуль ClearCase NetBeans, перейдите в диспетчер подключаемых модулей в IDE ('Сервис' > 'Подключаемые модули' из главного меню) и установите подключаемый модуль, как показано ниже:</p>
<p class="align-center">
<a href="../../../images_www/articles/74/ide/clearcase/cc-plugin.png" rel="lytebox" title="Подключаемый модуль ClearCase NetBeans доступен с помощью диспетчера подключаемых модулей"> <img alt="Подключаемый модуль ClearCase NetBeans отображается в диспетчере подключаемых модулей" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/cc-plugin-small.png"></a>
</p>
<a name="settingUp"></a>
<h2>Установка и настройка ClearCase</h2>
<p>Перед тем, как пользоваться поддержкой ClearCase в среде IDE, необходимо установить и запустить на своем компьютере клиентское программное обеспечение ClearCase.</p>
<p>Поддержка ClearCase в среде IDE NetBeans работает как с представлениями <em>моментальных снимков</em>, так и с <em>динамическими</em> представлениями. <strong>Представления должны быть настроены за пределами IDE и подключение к серверу ClearCase должна быть правильно настроено.</strong> Для доступа к файлам в представляениях снимков не требуется дополнительная настройка. Но если необходим доступ к файлам из динамического представления, это представление сперва необходимо инициализировать с помощью встроенных средств ClearCase, установленных на компьютере вместе с ним.</p>
<p><strong class="notes">Примечания:</strong></p>
<ul>
<li>Подключение к веб-интерфейсу ClearCase (CCWeb) в настоящий момент невозможно.</li>
<li>Ограничение *nix-подобных систем состоит в том, что для получения доступа к своим файлам среду IDE необходимо запустить из контекста динамического представления.</li>
</ul>
<p>Поддержка ClearCase в среде IDE работает посредством взаимодействия с клиентом <tt>cleartool</tt> для выполнения команд управления версиями. В зависимости от системы и того, установлен ли клиент <tt>cleartool</tt> в местоположении, отличающемся от местоположения по умолчанию, может быть необходимо зарегистрировать путь к исполняемому файлу <tt>cleartool</tt> в среде IDE.</p>
<div class="indent">
<a name="specifying"></a>
<h3>Указание пути к исполняемому файлу <tt>cleartool</tt></h3>
<p>IDE NetBeans автоматически выполняет попытку определить местоположение исполняемого файла <tt>cleartool</tt> с помощью системной переменной <tt>$PATH</tt> на компьютере пользователя. Но в зависимости от платформы и того, установлен ли клиент ClearCase в ином местоположении, может быть необходимо указать путь к исполняемому файлу напрямую. Чтобы установить путь к исполняемому файлу ClearCase в среде IDE, выполните следующие действия.</p>
<ol>
<li>Выберите Tools (&quot;Сервис&quot;) &gt; Options (&quot;Параметры&quot;) (NetBeans &gt; Preferences (&quot;Настройки&quot;) на Mac) из главного меню. Откроется диалоговое окно Options (&quot;Параметры&quot;).</li>
<li>Выберите значок Miscellaneous (&quot;Разное&quot;) наверху диалогового окна, затем щелкните вкладку Versioning (&quot;Управление версии&quot;). В левой панели, под Versioning Systems (&quot;Системы управления версиями&quot;), выберите ClearCase. Определенные пользователем параметры ClearCase отобразятся в основном окне диалога:
<p class="align-center"><a name="ccOptions"></a> <a href="../../../images_www/articles/74/ide/clearcase/cc-options.jpg" rel="lytebox" title="Диалоговое окно &apos;Параметры ClearCase&apos; с параметрами, определенными пользователями"> <img alt="Диалоговое окно &apos;Параметры ClearCase&apos; с параметрами, определенными пользователями" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/cc-options-small.jpg"></a></p></li>
<li>В текстовом поле Specify the <tt>cleartool</tt> Executable Path (&quot;Указать путь исполнения cleartool&quot;) введите путь к исполняемому файлу, либо нажмите кнопку Browse (&quot;Обзор&quot;) для перехода к нему в дереве каталогов.</li>
<li>Нажмите кнопку &quot;ОК&quot; и перезапустите среду IDE, чтобы изменения вступили в силу.</li>
</ol>
<p><strong class="notes">Примечание. </strong> Дополнительные сведения приведены в документе <a href="http://versioncontrol.netbeans.org/clearcase/install.html">Настройка интеграции ClearCase в среде IDE NetBeans и заметки о выпуске</a>.</p>
</div>
<a name="starting"></a>
<h2>Начало работы над файлами с контролем версий</h2>
<p>При первом использовании ClearCase в среде IDE необходимо начать с открытия существующего проекта с контролем версий или создания нового проекта <strong>внутри представления ClearCase</strong> на компьютере.</p>
<ul>
<li><a href="#opening">Открытие существующего проекта в среде IDE</a> </li>
<li><a href="#addingSourceControl">Создание нового проекта и внесение его в систему контроля версий</a></li>
</ul>
<div class="indent">
<a name="opening"></a>
<h3>Открытие существующего проекта в среде IDE</h3>
<p>Если уже имеется проект ClearCase с контролем версий, над которым шла работа, его можно открыть в среде IDE, и функции контроля версий автоматически станут доступными. Среда IDE выполняет поиск по открытым проектам, и если они расположены в каталоге представления ClearCase, состояние файла и контекстная поддержка автоматически становятся доступными. </p>
<p>Чтобы открыть проект ClearCase с контролем версий, выполните следующие действия.</p>
<ol>
<li>Выберите File (&quot;Файл&quot;) &gt; Open Project (&quot;Открыть проект&quot;) из основного меню и пройдите через этапы работы мастера открытия проектов. При указании местоположения проекта перейдите к каталогу местоположения <strong>внутри представления ClearCase</strong>. По завершении работы мастера проект отобразится в окне проектов (Ctrl-1), и поддержка управления версиями станет активной.</li>
</ol>
<p><strong class="notes">Примечание. </strong>Также можно открыть проект или каталог в окне 'Избранное'. Это может быть необходимо, если каталог ClearCase не является проектом NetBeans. Для этого щелкните правой кнопкой мыши в окне 'Избранное' (Ctrl-3) и выбрав 'Добавить в Избранное'. В появившемся диалоговом окне добавления к избранному перейдите к каталогу представления ClearCase верхнего уровня на своем компьютере и нажмите кнопку Add (&quot;Добавить&quot;). К окну избранного будет добавлено представление каталога в виде дерева.</p>
<a name="addingSourceControl"></a>
<h3>Создание нового проекта и постановка его под контроль версий</h3>
<p>Как вариант, можно создать новый проект и поставить его под контроль версий ClearCase, после чего продолжить работу в среде IDE. При создании нового проекта необходимо указать его местоположение <strong>внутри представления ClearCase</strong>. Это позволяет среде IDE обнаружить, что требуется поддержка контроля версий. При создании проекта все файлы первоначально находятся в состоянии <em>для частного просмотра</em>). После этого можно добавить проект к серверу ClearCase, используя команду среды IDE Add to Source Control (&quot;Добавить к управлению версиями&quot;).</p>
<p>Для создания нового проекта выполните следующие действия.</p>
<ol>
<li>Выберите File (&quot;Файл&quot;) &gt; New Project (&quot;Создать проект&quot;) из основного меню и пройдите через этапы работы мастера создания проектов.</li>
<li>На этапе 2, Name and Location (&quot;Имя и местоположение&quot;), выберите каталог в представлении ClearCase.</li>
<li>При нажатии кнопки Finish (&quot;Готово&quot;) проект будет создан, и представление дерева его каталога будет добавлено к окну проектов (Ctrl-1). <br> При создании проекта среда IDE автоматически распознает, что в представлении находится проект, и все соответствующие действия ClearCase, а также информация о состоянии файлов, становятся доступными.</li>
</ol>
<p>При открытии проекта с контролем версий в среде IDE все имена файлов и папок показываются зеленым, что обозначает их состояние как вновь созданных. (Файлы, отображаемые серым, являются &quot;игнорируемыми&quot;. Дополнительные сведения приведены ниже в разделе <a href="#badges">Метки и условные цвета</a>.) Среда IDE автоматически определяет для каждого файла проекта с контролем версий, является ли он кандидатом на постановку под контроль версий или нет (т. е. файлам исходного кода в пакетах обычно требуется контроль версий, тогда как закрытые файлы проекта обычно игнорируются).</p>
<!-- <p><span class="tips"></span>It is possible to to modify the way IDE handles private file views using the
following options:</p>
<ul>
<li>Schedule View Private Files For checkin option in the <a href="#ccOptions">ClearCase Options dialog</a></li>
<li>Ignored Files setting available under Tools &gt; Options (NetBeans &gt; Preferences on Mac) &gt;
Advanced Options &gt; IDE Configuration &gt; System &gt; System Settings &gt; Ignored Files</li>
</ul> -->
<p>Теперь проект создан, и его можно синхронизировать с сервером ClearCase, используя команду среды IDE Add to Source Control (&quot;Добавить под контроль версий&quot;):</p>
<ol>
<li>Щелкните правой кнопкой мыши узел проекта в окне проектов и выберите Add to Source Control (&quot;Добавить под контроль версий&quot;). Откроется диалоговое окно добавления, в котором перечислены все новые файлы для частного просмотра, кроме игнорируемых средой IDE автоматически:
<p class="align-center"><a name="addDialog"></a> <a href="../../../images_www/articles/74/ide/clearcase/add-dialog.jpg" rel="lytebox" title="В диалоговом окне &apos;Добавить ClearCase&apos; перечислены все файлы для добавления к управлению версиями"> <img alt="Диалоговое окно &apos;Добавить ClearCase&apos;" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/add-dialog-small.jpg"></a></p></li>
<li>Введите сообщение в текстовую область Describing Message (&quot;Сообщение с описанием&quot;), В качестве альтернативы щелкните значок 'Последние сообщения' ( <img alt="значок &apos;Последние сообщения&apos;" src="../../../images_www/articles/74/ide/clearcase/recent-msgs.png"> ), расположенный в правом верхнем углу, чтобы просмотреть и выбрать необходимое из ранее использованного списка сообщений.</li>
<li>После указания действий для отдельных файлов нажмите кнопку Add (&quot;Добавить&quot;). При выполнении действия добавления отобразится строка состояния среды IDE, расположенная в нижнем правом углу интерфейса. После успешного добавления значки контроля версий исчезнут в окнах Projects (&quot;Проекты&quot;), Files (&quot;Файлы&quot;) и Favorites (&quot;Избранное&quot;), и цвет возвращенных после изменения файлов изменится на черный.</li>
</ol>
<p><strong class="notes">Примечание. </strong>В диалоговом окне 'Добавить' можно указать, следует ли исключить отдельные файлы из действия 'Добавить'. Чтобы сделать это, щелкните столбец Action (&quot;Действие&quot;) выбранного файла и выберите Do not Add (&quot;Не добавлять&quot;) из раскрывающегося списка.</p>
</div>
<a name="checkingout"></a>
<h2>Взятие файлов исходного кода для изменения</h2>
<p>После того, как проект с управлением версиями ClearCase открыт в среде IDE, можно приступить к внесению изменений в файлы исходного кода. Для изменения файлов под управлением версиями ClearCase их сперва нужно взять для изменения или <em>захватить</em>. Поддержка ClearCase в среде IDE NetBeans предоставляет два способа сделать это: </p>
<ul>
<li><strong>Вручную</strong>: просто щелкните правой кнопкой мыши узел файла и выберите ClearCase > 'Проверить' (или ClearCase > Hijack).</li>
<li><strong>Использование функции взятия для изменения по требованию</strong>: при каждом действии, которое требует от файла доступности для записи, среда IDE автоматически запускает соответствующую команду ClearCase (например изменение содержимого файла в редакторе в первый раз или выполнение команды реорганизации).</li>
</ul>
<p><span class="tips"></span>Функцию взятия для изменения по требованию можно настроить под свои требования, используя параметр On Demand checkout (&quot;Взятие для изменения по требованию&quot;) в диалоговом окне <a href="#ccOptions">Options (&quot;Параметры&quot;) ClearCase</a>.</p>
<a name="editing"></a>
<h2>Изменение файлов исходного кода</h2>
<p>Как и в случае с любым проектом в IDE NetBeans, пользователи могут открывать файлы в редакторе исходного кода двойным щелчком их узлов, как они отображаются в окнах IDE (например, Проекты (Ctrl-1), файлы (Ctrl-2), Избранное (Ctrl-3) Windows).</p>
<p>При работе с файлами исходного кода в среде IDE можно пользоваться различными компонентами пользовательского интерфейса, помогающими как в просмотре, так и в работе с командами контроля версий:</p>
<ul>
<li><a href="#viewingChanges">Просмотр изменений в редакторе исходного кода</a></li>
<li><a href="#viewingFileStatus">Просмотр информации о состоянии файла</a></li>
<li><a href="#comparing">Сравнение версий файлов</a></li>
</ul>
<div class="indent">
<a name="viewingChanges"></a>
<h3>Просмотр изменений в редакторе исходного кода</h3>
<p>Открыв файл под контролем версий в редакторе исходного кода среды IDE, можно просматривать изменения, происходящие с файлом, в реальном времени по мере внесения изменений в ранее взятую из хранилища для изменения версию. По ходу работы среда IDE использует условные цвета на полях редактора файлов исходного кода для передачи следующей информации:</p>
<table class="cell">
<tr>
<td class="align-right cell"><strong>Синий</strong> ( <span style="background-color:#b8cfe5">     </span> )</td>
<td>Строки, измененные по сравнению с предыдущей версией.</td>
</tr>
<tr>
<td class="align-right cell"><strong>Зеленый</strong> ( <span style="background-color:#b4ffb4">     </span> )</td>
<td>Строки, добавленные к предыдущей версии.</td>
</tr>
<tr>
<td class="align-right cell"><strong>Красный</strong> ( <span style="background-color:#ffa0b4">     </span> )</td>
<td>Строки, удаленные из предыдущей версии.</td>
</tr>
</table>
<p>В левом поле редактора исходного кода отображаются изменения для каждой отдельной строки. При изменении определенной строки изменения немедленно показываются в левом поле.</p>
<p>Щелкнув группировку по цвету на полях, можно отменить недавние изменения. Например, на приведенном ниже снимке экрана показаны элементы оформления, доступные, если щелкнуть красный значок, указывающий, что из взятого для изменения файла удалены строки.</p>
<p>На правом поле редактора исходного кода предоставлен обзор изменений, внесенных в файл в целом, сверху донизу. Условные цвета применяются сразу после внесения изменений в файл. </p>
<p>Обратите внимание, что можно щелкнуть определенную точку внутри поля, чтобы немедленно перенести курсор в строке к этому месту файла. Для просмотра числа затронутых строк наведите мышь на цветные значки в правом поле:</p>
<table class="cell" style="width:500px">
<tr>
<td><a href="../../../images_www/articles/74/ide/clearcase/left-ui.png" rel="lytebox" title="Цветовая кодировка управления версиями отображается на левой границе редактора"> <img alt="Цветовая кодировка управления версиями отображается на левой границе редактора" class="b-all" src="../../../images_www/articles/74/ide/clearcase/left-ui-small.png"></a> <br><strong>Левое поле</strong></td>
<td><img alt="Цветовая кодировка управления версиями отображается на правой границе редактора" class="b-all" src="../../../images_www/articles/74/ide/clearcase/right-ui.png" title="Цветовая кодировка управления версиями отображается на правой границе редактора"> <br><strong>Правое поле</strong></td>
</tr>
</table>
<a name="viewingFileStatus"></a>
<h3>Просмотр информации о состоянии файла</h3>
<p>При работе в окнах Projects (&quot;Проекты&quot;) (Ctrl-1), Files (&quot;Файлы&quot;) (Ctrl-2), Favorites (&quot;Избранное&quot;) (Ctrl-3) или Versioning (&quot;Управление версиями&quot;) среда IDE предоставляет несколько визуальных функций, помогающих в просмотре информации о состоянии файлов. В примере, приведенном ниже, обратите внимание, как метка (например, <img alt="синяя метка" src="../../../images_www/articles/74/ide/clearcase/blue-badge.png">), цвет имени файла и смежная метка состояния соответствуют друг другу для предоставления для пользователей простого и эффективного способа отслеживания данных об изменениях версий файлов:</p>
<p class="align-center">
<img alt="синяя метка управления версиями отображается в окне &apos;Избранное&apos;" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/badge-example.jpg" title="синяя метка управления версиями отображается в окне &apos;Избранное&apos;"></p>
<p>Метки, условные цвета, ярлыки состояния файлов и, что, пожалуй, наиболее важно, окно контроля версий вместе дают дополнительные возможности по просмотру и управлению сведениями о версиях в среде IDE.</p>
<ul>
<li><a href="#badges">Метки и условные цвета</a></li>
<li><a href="#fileStatus">Ярлыки состояния файлов</a></li>
<li><a href="#versioning">Окно управления версиями</a></li>
</ul>
<div class="indent">
<a name="badges"></a>
<h4>Метки и условные цвета</h4>
<p>Метки относятся к узлам проектов, папок и пакетов. Они сообщают о состоянии файлов внутри соответствующего узла:</p>
<p>Ниже в таблице приведена цветовая схема, используемая для меток.</p>
<table>
<tr>
<th class="tblheader" scope="col" style="width:120px">Элемент пользовательского интерфейса</th>
<th class="tblheader" scope="col">Описание</th>
</tr>
<tr>
<td class="tbltd1 align-center"><strong>Синяя метка</strong> (<img alt="синяя метка" src="../../../images_www/articles/74/ide/clearcase/blue-badge.png">)</td>
<td class="tbltd1">Указывает на присутствие файлов или папок, которые были взяты для изменения, захвачены или добавлены. Касательно пакетов, данная метка относится только к самому пакету, но не к его подпакетам. Что касается проектов и папок, метка указывает на изменения как внутри самого элемента, так и внутри любых его подпапок.</td>
</tr>
</table>
<br><a name="color-coding-table"></a>
<p>Условные цвета применяются к именам файлов, чтобы указать текущее состояние этих файлов:</p>
<table>
<tr>
<th class="tblheader" scope="col" style="width:40px">Цвет</th>
<th class="tblheader" scope="col">Пример</th>
<th class="tblheader" scope="col">Описание</th>
</tr>
<tr>
<td class="tbltd1 align-center"><strong>Синий</strong></td>
<td class="tbltd1"><img alt="текст, выделенный синим" src="../../../images_www/articles/74/ide/clearcase/blue-text.png"></td>
<td class="tbltd1">Указывает, что файл взят для изменения.</td>
</tr>
<tr>
<td class="tbltd1 align-center"><strong>Зеленый</strong></td>
<td class="tbltd1"><img alt="текст, выделенный зеленым" src="../../../images_www/articles/74/ide/clearcase/green-text.png"></td>
<td class="tbltd1">Указывает, что файл новый и еще не добавлен под контроль версий.</td>
</tr>
<tr>
<td class="tbltd1 align-center"><strong>Серый</strong></td>
<td class="tbltd1"><img alt="текст, выделенный серым" src="../../../images_www/articles/74/ide/clearcase/gray-text.png"></td>
<td class="tbltd1">Указывает, что данный файл игнорируется ClearCase и не будет охвачен командами контроля версий (например, Add to Source Control (&quot;Добавить под контроль версий&quot;) или Checkin (&quot;Возврат после изменения&quot;)). Файлы можно сделать игнорируемыми, только если они еще не добавлены под контроль версий.</td>
</tr>
<tr>
<td class="tbltd1 align-center" style="width:120px"><strong>Перечеркивание</strong></td>
<td class="tbltd1 align-center"><img alt="перечеркнутый текст" src="../../../images_www/articles/74/ide/clearcase/strike-through-text.png"></td>
<td class="tbltd1">Указывает, что файл не будет затронут операциями возврата после изменения или добавления под контроль версий. Перечеркнутый текст появляется только в определенных местах, таких как диалог возврата после изменения окна контроля версий и диалог добавления под контроль версий, где можно выбрать исключение из действия для отдельных файлов. Подобные файлы затрагиваются прочими командами ClearCase, такими как Update (&quot;Обновление&quot;).</td>
</tr>
</table>
<br><a name="fileStatus"></a>
<h4>Ярлыки состояния файлов</h4>
<p>Ярлыки состояния файлов предоставляют в окнах среды IDE текстовое указание на состояние файлов, включенных в управление версиями. По умолчанию сведения о состоянии отображения среды IDE (новый, зарезервированный, незарезервированный, игнорируемый и т. д.) отображаются серым цветом справа от файлов, перечисленных в окнах. Однако этот формат можно изменить под свои потребности. Например, если к ярлыкам состояния необходимо добавить селекторы версий, сделайте следующее:</p>
<ol>
<li>Выберите Tools (&quot;Сервис&quot;) &gt; Options (&quot;Параметры&quot;) (NetBeans &gt; Preferences (&quot;Настройки&quot;) на Mac) из главного меню. Откроется окно &quot;Options&quot;.</li>
<li>Выберите кнопку Miscellaneous (&quot;Разное&quot;) наверху диалогового окна, затем щелкните вкладку Versioning (&quot;Контроль версий&quot;) под ним. Убедитесь, что ClearCase выбран в Versioning Systems (&quot;Системы управления версиями&quot;) на левой панели. (Для справки см. <a href="#ccOptions">снимок экрана</a> выше).</li>
<li>Нажмите кнопку Add Variable (&quot;Добавить переменную&quot;) справа от текстового поля строки состояния Format (&quot;Формат&quot;). В отображаемом диалоговом окне Add Variable (&quot;Добавить переменную&quot;) выберите переменную <tt>{version}</tt> и нажмите кнопку &quot;ОК&quot;. Переменная версии добавляется к текстовому полю Format ярлыка состояния.</li>
<li>Для изменения формата ярлыков состояния, чтобы справа от файлов отображались только состояние и селектор версий, измените содержимое текстового поля Status Label Format (формат ярлыка состояния) на следующее:<br>
<pre class="examplecode">[{status}; {version}]</pre>
Нажмите кнопку &quot;ОК&quot;. В ярлыках состояния теперь приводятся состояние файла и селектор версий (где он есть):
<p class="align-center">
<img alt="метки файлов, отображаемые рядом с именами файлов" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/file-labels.jpg" title="метки файлов, отображаемые рядом с именами файлов"></p>
</li>
</ol>
<p><span class="tips"></span>Ярлыки состояния файлов можно включать и отключать, выбирая View (&quot;Представление&quot;) &gt; Show Versioning Labels (&quot;Показать ярлыки версий&quot;) из главного меню.</p>
<a name="versioning"></a>
<h4>Окно контроля версий</h4>
<p>Окно Versioning (&quot;Контроль версий&quot;) ClearCase предоставляет обновляемый в реальном времени список всех изменений, внесенных в файлы внутри выбранной папки или локальной рабочей копии. По умолчанию оно открывается в нижней панели среды IDE, в нём отображаются новые, взятые для изменения и захваченные файлы. </p>
<p>Чтобы открыть окно контроля версий, выберите версию файла или каталога (например, из окна &quot;Проекты&quot;, &quot;Файлы&quot; или &quot;Избранное&quot;) и либо выберите &quot;ClearCase&quot; &gt; &quot;Показать изменения&quot; из контекстного меню, либо &quot;Управление версиями&quot; &gt; &quot;Показать изменения&quot; из главного меню. В нижней панели среды IDE откроется следующее окно:</p>
<p class="align-center">
<a href="../../../images_www/articles/74/ide/clearcase/versioning-window.jpg" rel="lytebox" title="В окне управления версиями отображаются локально измененные файлы"> <img alt="В окне управления версиями отображаются локально измененные файлы" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/versioning-window-small.jpg"></a></p>
<p>По умолчанию в окне контроля версий отображается список всех файлов внутри выбранного пакета или папки, состояние которых заслуживает внимания (т. е. новый, зарезервированный, незарезервированный и т. д.). Щелкая заголовки столбцов над перечисленными файлами, эти файлы можно упорядочить по их именам, состоянию, местоположению или правилу.</p>
<p>На панель инструментов окна управления версиями имеются кнопки, позволяющие вызывать типичные задачи ClearCase для всех файлов, отображаемых в списке. В таблице ниже перечислены все команды ClearCase, доступные через панель инструментов окна Versioning.</p>
<table>
<tr>
<th class="tblheader" scope="col">Значок</th>
<th class="tblheader" scope="col" style="width:110px">Имя</th>
<th class="tblheader" scope="col">Функция</th>
</tr>
<tr>
<td class="tbltd1 align-center"><img alt="значок &apos;Обновить состояние&apos;" src="../../../images_www/articles/74/ide/clearcase/refresh.png"></td>
<td class="tbltd1 align-center"><strong>Refresh Status (&quot;Обновить состояние&quot;)</strong></td>
<td class="tbltd1">Обновление состояния всех выбранных файлов и папок. Файлы, отображаемые в окне контроля версий, можно обновить для отражения любых изменений, внесенных извне.</td>
</tr>
<tr>
<td class="tbltd1 align-center"><img alt="значок &apos;Сравнить все&apos;" src="../../../images_www/articles/74/ide/clearcase/diff.png"></td>
<td class="tbltd1 align-center"><strong>Diff All (&quot;Сравнить все&quot;)</strong></td>
<td class="tbltd1">Открывает окно Diff Viewer (&quot;Просмотр различий&quot;), позволяющее рассмотреть локально измененные версии параллельно с версиями, остающимися в хранилище.</td>
</tr>
<tr>
<td class="tbltd1 align-center"><img alt="значок &apos;Обновить все&apos;" src="../../../images_www/articles/74/ide/clearcase/update.png"></td>
<td class="tbltd1 align-center"><strong>Update All (&quot;Обновить все&quot;)</strong></td>
<td class="tbltd1">Обновление всех выбранных файлов. (Применимо только к представлениям моментального снимка).</td>
</tr>
<tr>
<td class="tbltd1 align-center"><img alt="значок &apos;Фиксировать все&apos;" src="../../../images_www/articles/74/ide/clearcase/commit.png"></td>
<td class="tbltd1 align-center"><strong>Сheckin All (&quot;Вернуть все после изменения&quot;)</strong></td>
<td class="tbltd1">Позволяет вернуть версию после локальных изменений.</td>
</tr>
</table>
<br>
<p>Для доступа к другим командам ClearCase в окне контроля версий необходимо выбрать строку таблицы, соответствующую файлу, а затем выбрать команду в контекстом меню:</p>
<p class="align-center">
<img alt="Контекстное меню отображается для выбранного файла в окне &apos;Управление версиями&apos;" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/versioning-right-click.jpg" title="Контекстное меню отображается для выбранного файла в окне &apos;Управление версиями&apos;"></p>
<br>
<p>Для примера, с файлом можно выполнить следующие действия:</p>
<table>
<tr>
<td style="width:200px">
<ul>
<li><strong>Показать аннотации</strong>: <br><br> Сведения об авторе и номере редакции в левом поле файлов, открытых в редакторе исходных файлов.</li></ul></td>
<td class="f-page-cell">
<a href="../../../images_www/articles/74/ide/clearcase/annotations.jpg" rel="lytebox" title="аннотации отображаются на левой границе в редакторе исходного кода"> <img alt="Аннотации отображаются на левой границе в редакторе исходного кода" class="b-all" src="../../../images_www/articles/74/ide/clearcase/annotations-small.jpg"></a></td>
</tr>
<tr>
<td style="width:200px">
<ul>
<li><strong>Исключить из возврата</strong>: <br><br> Пометить файл, чтобы он был исключен при выполнении возврата после изменения.</li></ul></td>
<td class="f-page-cell">
<img alt="Файлы помечены как исключенные в диалоговом окне возврата после изменения" class="b-all" src="../../../images_www/articles/74/ide/clearcase/exclude-from-checkin.jpg" title="Файлы, помеченные как исключенные в диалоговом окне возврата после изменения"></td>
</tr>
</table>
</div>
</div>
<a name="comparing"></a>
<h3>Сравнение версий файлов</h3>
<p>Сравнение версий файлов &ndash; обычная задача при работе над проектами под контролем версий. Среда IDE позволяет сравнивать версии, используя команду Diff, доступную в контекстном меню выбранного элемента (ClearCase > Diff), а также в окне контроля версий. В окне 'Управление версиями', вы можете выполнить сравнение либо двойным щелчком указанного файла, либо щелкнув значок 'Сравнить все' (<img alt="значок &apos;Сравнить все&apos;" src="../../../images_www/articles/74/ide/clearcase/diff.png">), расположенный на панели инструментов в верхней части.</p>
<p>При выполнении сравнения в главном окне среды IDE открывается графическое представление различий для выбранного(ых) файла(ов). Средство просмотра различий отображает две копии в расположенных рядом панелях:</p>
<p class="align-center">
<a href="../../../images_www/articles/74/ide/clearcase/diff-viewer.jpg" rel="lytebox" title="Средство просмотра различий ClearCase"> <img alt="Средство просмотра различий ClearCase" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/diff-viewer-small.jpg"></a></p>
<p>В просмотре различий используются те же <a href="#viewingChanges">условные цвета</a>, что используются и в других местах для показа изменений под контролем версий. На показанном выше снимке экрана зеленый блок указывает содержимое, добавленное к более новой версии. Красный блок указывает содержимое предыдущей версии, которое удалено из последующей. Синий указывает, что в выделенных строках произошли изменения.</p>
<p>Также при выполнении сравнения в группе файлов, таких, как проект, пакет или папка, или при щелчке 'Сравнить все' (<img alt="значок &apos;Сравнить все&apos;" src="../../../images_www/articles/74/ide/clearcase/diff.png">), вы можете переключаться между различиями с помощью щелчков файлов, перечисленных в верхней области 'Средства просмотра различий'.</p>
<p>Средство просмотра различий также предоставляет следующие функции:</p>
<ul>
<li><a href="#makeChanges">Внесение изменений в файлы, взятые для изменения</a></li>
<li><a href="#navigateDifferences">Переходы между различиями</a></li>
</ul>
<div class="indent">
<a name="makeChanges"></a>
<h4>Внесение изменений в файлы, взятые для изменения</h4>
<p>В случае выполнения сравнения файлов, взятых для изменения, изменения можно вносить напрямую из просмотра различий. Чтобы сделать это, поместите свой курсор внутри правой панели просмотра различий и измените свой файл соответственно, либо используйте значки, отображающиеся в строке рядом с каждым выделенным изменением:</p>
<table>
<tr>
<td class="align-right cell" style="width:120px"><strong>Заменить</strong> (<img alt="значок &apos;Заменить&apos;" src="../../../images_www/articles/74/ide/clearcase/insert.png">):</td>
<td>вставляет выделенный текст из предыдущих версий во взятую для изменения версию.</td>
</tr>
<tr>
<td class="align-right cell" style="width:120px"><strong>Переместить все</strong> (<img alt="значок &apos;Переместить все&apos;" src="../../../images_www/articles/74/ide/clearcase/arrow.png">):</td>
<td>возвращает взятую для изменения версию файла к состоянию выбранной предыдущей версии.</td>
</tr>
<tr>
<td class="align-right cell" style="width:120px"><strong>Удалить </strong> (<img alt="значок &apos;Удалить&apos;" src="../../../images_www/articles/74/ide/clearcase/remove.png">):</td>
<td>удаляет выделенный текст из взятой для изменения версии, чтобы она отражала предыдущую версию.</td>
</tr>
</table>
<a name="navigateDifferences"></a>
<h4>Переходы между различиями в сравниваемых файлах</h4>
<p>Если сравнение содержит несколько изменений, между ними можно переходить, используя значки стрелок, отображающиеся на панели инструментов. Значки стрелок позволяют просматривать появляющиеся различия сверху донизу:</p>
<table>
<tr>
<td class="align-right cell" style="width:120px"><strong>Предыдущий</strong> (<img alt="кнопка &apos;Предыдущее отличие&apos;" src="../../../images_www/articles/74/ide/clearcase/diff-prev.png">):</td>
<td>переход к предыдущему различию, отображенному в сравнении.</td>
</tr>
<tr>
<td class="align-right cell" style="width:120px"><strong>Далее</strong> (<img alt="кнопка &apos;Следующее отличие&apos;" src="../../../images_www/articles/74/ide/clearcase/diff-next.png">):</td>
<td>переход к следующему различию, отображенному в сравнении.</td>
</tr>
</table>
</div>
<a name="checkingin"></a>
<h2>Возврат файлов исходного кода после изменения</h2>
<p>После внесения изменений в файлы исходного кода мы возвращаем их в хранилище. Среда IDE позволяет вызвать команду возврата после изменения следующими способами:</p>
<ul>
<li>В окне 'Проекты', 'Файлы' или 'Избранное' правой кнопкой мыши щелкните новые или изъятые элементыи выберите 'ClearCase' > 'Проверить'.</li>
<li>В окне 'Управление версиями' или 'Средства просмотра различий' нажмите кнопку 'Вернуть все после изменения' (<img alt="значок &apos;Вернуть все после изменения&apos;" src="../../../images_www/articles/74/ide/clearcase/commit.png">) на панели инструментов.</li>
</ul>
<p>Откроется диалоговое окно возврата после изменения, в котором выведены:</p>
<ul>
<li>все извлеченные файлы;</li>
<li>все новые файлы, которые будут первыми автоматически добавлены под контроль версий (т. е., файлы для частного просмотра, которые пока не добавлены под контроль версий и не игнорируются средой IDE).</li>
</ul>
<p class="align-center">
<a href="../../../images_www/articles/74/ide/clearcase/checkin-dialog.png" rel="lytebox" title="В диалоговом окне &apos;Вернуть после изменения&apos; отображаются файлы, которые будут возвращены после изменения"> <img alt="В диалоговом окне &apos;Вернуть после изменения&apos; отображаются файлы, которые будут возвращены после изменения" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/checkin-dialog-small.png"></a>
</p>
<p>Из диалогового окна возврата после изменения можно указать, следует ли исключить отдельные файлы из числа возвращаемых. Чтобы сделать это, щелкните столбец Checkin Action (&quot;Действие возврата после изменения&quot;) выбранного файла и выберите Exclude from Checkin (&quot;Исключить из возврата&quot;) из раскрывающегося списка.</p>
<p>Для возврата после изменения выполните следующие действия.</p>
<ol>
<li>Введите сообщение в текстовую область Checkin Message (&quot;Сообщение возврата&quot;) В качестве альтернативы щелкните значок 'Последние сообщения' ( <img alt="значок &apos;Последние сообщения&apos;" src="../../../images_www/articles/74/ide/clearcase/recent-msgs.png"> ), расположенный в правом верхнем углу, чтобы просмотреть и выбрать необходимое из ранее использованного списка сообщений.</li>
<li>После указания действий для отдельных файлов нажмите кнопку Checkin. Среда IDE выполнит возврат после изменения. При выполнении действия возврата отобразится строка состояния среды IDE, расположенная в нижнем правом углу интерфейса. После успешного возврата значки контроля версий исчезнут в окнах Projects (&quot;Проекты&quot;), Files (&quot;Файлы&quot;) и Favorites (&quot;Избранное&quot;), и цвет возвращенных файлов вновь станет черным.</li>
</ol>
<div class="feedback-box">
<a href="/about/contact_form.html?to=3&amp;subject=Feedback:%20Using%20ClearCase%20Support%20in%20NetBeans%20IDE">Отправить отзыв по этому учебному курсу</a></div>
<br style="clear:both;">
<a name="seeAlso"></a>
<h2>Дополнительные сведения</h2>
<p>На этом завершается обзор возможностей ClearCase для IDE NetBeans. В данном документе показано, как решать основные задачи контроля версий в среде IDE, путем демонстрации стандартной рабочей последовательности действий при использования поддержки ClearCase в среде IDE.</p>
<p>Материалы на связанные темы:</p>
<ul>
<li><a href="http://wiki.netbeans.org/NetBeansUserFAQ#ClearCase">Часто задаваемые вопросы по поддержке ClearCase для IDE NetBeans</a></li>
<li><a href="git.html">Использование поддержки Git в IDE NetBeans</a></li>
<li><a href="mercurial.html">Использование поддержки Mercurial в IDE NetBeans</a></li>
<li><a href="subversion.html">Использование поддержки Subversion в IDE NetBeans</a></li>
<li><a href="cvs.html">Использование поддержки CVS в IDE NetBeans</a></li>
<li><a href="mercurial-queues.html">Использование поддержки Mercurial Queues в IDE NetBeans</a></li>
<li><a href="http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG234">Управление версиями приложений с помощью системы контроля версий</a> в документе <i>Разработка приложений в IDE NetBeans</i></li></a>
</ul>
</body>
</html>