Определение пути к исполняемой программе cleartool

Среда IDE NetBeans предпринимает попытку определить расположение исполняемого файла cleartool с помощью системной переменной $PATH. Однако в зависимости от платформы или в случае установки клиента ClearCase в другом каталоге может потребоваться явно указать путь к исполняемому файлу. Для настройки пути к исполняемому файлу ClearCase в среде IDE выполните следующие действия:

1. В главном меню выберите "Tools > Options". Откроется диалоговое окно "Options".
2. Выберите значок "Miscellaneous" в верхней части диалогового окна, а затем откройте вкладку "Versioning". На левой панели в "Versioning Systems" выберите "ClearCase". В главном окне диалога появятся определяемые пользователем параметры для ClearCase:
   
   
3. В текстовом поле "Specify the cleartool Executable Path" введите путь к исполняемому файлу или нажмите кнопку "Browse" для перехода к этому файлу в системе.
4. Нажмите кнопку "OK", а затем перезапустите среду IDE для вступления изменений в силу.

Примечание: Для получения дополнительных сведений см. Настройка интеграции ClearCase в среде NetBeans и заметки о выпуске.

Открытие существующего проекта в среде IDE

Если в системе уже имеется проект ClearCase с несколькими версиями, с которым выполнялись определенные действия, то при открытии этого проекта в среде IDE функции управления версиями становятся доступны автоматически. В среде IDE выполняется сканирование открытых проектов, и если они расположены в каталоге представления ClearCase, автоматически активируется информация о статусе файла и контекстно-зависимая поддержка.

Открытие проекта ClearCase с версиями:

1. В главном меню выберите "File > Open Project" и выполните требуемые действия с мастером открытия проекта. При определении адреса проекта перейдите к расположению в каталоге представления ClearCase. После завершения работы мастера проект отображается в окне "Projects" (Ctrl-1), и активируется поддержка управления версиями.

Примечание: Открыть проект или каталог можно также в окне "Favorites". Это необходимо в том случае, если каталог ClearCase не является проектом NetBeans. Для этого щелкните правой кнопкой мыши в окне "Favorites" (Ctrl-3) и выберите "Add to Favorites". В появившемся диалоговом окне "Add to Favorites" перейдите к каталогу представления ClearCase верхнего уровня и нажмите кнопку "Add". В окне "Favorites" добавляется представление дерева для этого каталога.

Создание нового проекта и его размещение в "Source Control"

Также можно создать новый проект и разместить его в элементе управления ClearCase, а затем продолжить работу с этим проектом в среде IDE. При создании нового проекта необходимо указать его расположение в представлении ClearCase. Это позволит сообщить среде IDE о необходимости поддержки управления версиями. При создании проекта все файлы первоначально имеют закрытое представление. Далее проект можно добавить на сервер ClearCase с помощью команды "Add to Source Control" среды IDE.

Создание нового проекта:

1. В главном меню выберите "File > New Project" и выполните требуемые действия с помощью мастера создания проекта. В действии 2 ("Name and Location") выберите каталог в представлении ClearCase. При нажатии "Finish" создается проект, и представление дерева соответствующего каталога добавляется в окне "Projects" (Ctrl-1). После создания проекта среда IDE автоматически распознает, что проект находится в представлении. При этом становятся доступными все соответствующие действия ClearCase и информация о статусе файла.

При открытии проекта с версиями в среде IDE имена всех файлов и папок выделяются зеленым цветом. Это указывает на то, что они имеют статус "new". (Все файлы, выделенные серым цветом, имеют статус "ignored". Для получения дополнительных сведений см. Расшифровка значков и цветов ниже.) В среде IDE для каждого файла проекта с версиями автоматически определяется, требуется ли управление версиями или нет (исходные файлы в пакетах обычно подлежат управлению версиями, а закрытые файла проекта, как правило, игнорируются).

Способ обработки представлений закрытых файлов в среде IDE можно изменить с помощью следующих параметров:

• Параметр "Schedule View Private Files For checkin" в диалоговом окне ClearCase Options
• Для указания игнорируемых файлов выберите "Tools > Options > Advanced Options > IDE Configuration > System > System Settings > Ignored Files".

После создания проекта его можно синхронизировать с сервером ClearCase с помощью команды "Add to Source Control" в среде IDE:

1. Щелкните правой кнопкой мыши узел проекта в окне "Projects" и выберите "Add to source control". Появится диалоговое окно "Add" со списком всех новых закрытых файлов, которые не игнорируются в среде IDE автоматически:
   
2. Введите сообщение в текстовой области "Describing Message". Либо щелкните значок "Recent Messages" (), расположенный в верхнем правом углу, для просмотра и выбора из списка ранее использованных сообщений.
3. После определения действий для отдельных файлов нажмите кнопку "Add". При выполнении действия "Add" отображается строка состояния среды IDE в правой нижней части интерфейса. После успешного выполнения действия "Add" значки управления версиями исчезают из окон "Projects", "Files" и "Favorites", а зарегистрированные файлы выделяются черным цветом.

Примечание: В диалоговом окне "Add" можно исключить отдельные файлы из действия "Add". Для этого щелкните столбец "Action" выбранного файла и выберите "Do not Add" из раскрывающегося списка.

Просмотр изменений в редакторе исходного кода

При открытии файла с версиями в редакторе исходного кода в среде IDE можно просмотреть изменения файла в режиме реального времени относительно ранее выписанной версии из хранилища. При выполнении операций в среде IDE в полях редактора исходного кода используются цветовые обозначения:

Левое поле в редакторе исходного кода содержит построчные изменения. При изменении данной строки результаты незамедлительно отображаются в левом поле.

Для отмены новых изменений щелкните набор цветов в поле. Например, на левом нижнем снимке экрана показаны элементы оформления окон, для доступа к которым необходимо щелкнуть красный значок, который указывает, что строки из выписанного файла были удалены.

В правом поле редактора исходного кода предоставляется обзор изменений, внесенных во весь файл сверху вниз. Цветовые обозначения появляются сразу же после внесения изменений в файл.

Обратите внимание на то, что при щелчке определенной точки в поле встроенный курсор немедленно перемещается в соответствующее место в файле. Для просмотра количества затронутых строк наведите курсор мыши на цветные значки в правом поле:

Левое поле

Правое поле

Просмотр информации о статусе файла

Для работы в окнах "Projects" (Ctrl-1), "Files" (Ctrl-2), "Favorites" (Ctrl-3) или "Versioning" в среде IDE предусмотрены визуальные средства, которые упрощают просмотр информации о статусе файлов. В приведенном ниже примере обратите внимание на то, как значок (например, ), цвет имени файла и смежная метка статуса соотносятся друг с другом и обеспечивают простой, но эффективный способ отслеживания информации управления версиями:

Значки, цветовые обозначения, метки статуса файлов и (что, возможно, наиболее важно) окно "Versioning" обеспечивают возможность эффективного просмотра и управления информацией управления версиями в среде IDE.

• Расшифровка значков и цветов
• Метки статуса файла
• Окно "Versioning"

Расшифровка значков и цветов

Значки применяются на уровне проекта, папки и узла пакета. Они несут информацию о статусе файлов, содержащихся в данном узле:

В следующей таблице представлена система цветов, используемая для значков:

Элемент пользовательского интерфейса	Описание
Синий значок ()	Указывает на наличие файлов или папок, которые были выписаны, захвачены или добавлены. Для пакетов этот значок применим только к самому пакету непосредственно, но не к его подпакетам. Для проектов или папок этот значок указывает на наличие изменений в данном элементе или в любой из содержащихся в нем подпапок.

Для указания текущего состояния файлов в их именах применяются следующие цветовые обозначения:

Цвет	Пример	Описание
Синий		Указывает, что файл был выписан.
Зеленый		Указывает, что файл является новым и не был добавлен к элементу управления исходного файла.
Серый		Указывает, что файл игнорируется ClearCase и не будет включен в команды управления версиями (например, "Add to Source Control" или "Checkin"). Файлы могут игнорироваться только в том случае, если к ним еще не было применено управление версиями.
Зачеркивание		Указывает, что файл исключен из процесса регистрации или операций добавления к управлению исходными файлами. Зачеркнутый текст отображается только в определенных местах, например, в окне "Versioning", диалоговом окне "Checkin" или "Add to Source Control" при исключении отдельных файлов из действия. К таким файлам по-прежнему могут применяться другие команды ClearCase, например, "Update".

Метки статуса файла

Метки статуса файла обеспечивают текстовую индикацию статуса файлов с версиями в окнах среды IDE. По умолчанию в среде IDE информация о статусе ("new", "reserved", "unreserved", "ignored" и т.д.) отображается в виде серого текста справа от файлов при выводе их списка в окнах. Однако этот формат можно изменить в соответствии с собственными требованиями. Например, если к меткам статуса требуется добавить выбор версии, выполните следующие действия:

1. В главном меню выберите "Tools > Options". Откроется окно "Options".
2. Нажмите кнопку "Miscellaneous" в верхней части окна, а затем выберите вкладку "Versioning", расположенную ниже. Проверьте, что на левой панели под "Versioning Systems" выбран вариант ClearCase. (Для получения информации см. пример экрана выше.)
3. Нажмите кнопку "Add Variable" справа от текстового поля "Status Label Format". В появившемся диалоговом окне "Add Variable" выберите переменную {version}, а затем нажмите кнопку "OK". Переменная версии добавляется к текстовому полю "Status Label Format".
4. Для переформатирования меток статуса для отображения справа от файлов только выбора версии и статуса измените значение в текстовом поле "Status Label Format" следующим образом:

   [{status}; {version}]

   Нажмите кнопку "OK". Метки статуса теперь содержат статус файлов и выбор версии (если применимо):
   

Метки статуса файла можно включать или отключать путем выбора "View > Show Versioning Labels" в главном меню.

Окно "Versioning"

В окне "ClearCase Versioning" содержится список всех изменений файлов в выбранной папке локальной рабочей копии в режиме реального времени. Это окно открывается по умолчанию на нижней панели в среде IDE и содержит новые, выписанные или захваченные файлы.

Для открытия окна "Versioning" выберите файл или папку с версиями (например, из окна "Projects", "Files" или "Favorites"), щелкните правой кнопкой мыши и из появившегося меню выберите "ClearCase > Show Changes", либо выберите "Versioning > Show Changes" в главном меню. В нижней части интерфейса среды IDE появится следующее окно:

По умолчанию в окне "Versioning" отображается список всех файлов с определенным статусом в рамках выбранного пакета или папки (т. е. "new", "reserved", "unreserved" и т.д.). Для упорядочивания файлов по имени, статусу, расположению или правилу щелкните заголовки столбцов над отображаемыми файлами.

Панель инструментов окна "Versioning" также включает кнопки, которые позволяют вызывать наиболее распространенные задачи ClearCase для всех файлов в списке. В следующей таблице представлен список команд ClearCase, доступных на панели инструментов окна "Versioning":

Значок	Имя	Функция
	Refresh Status	Обновляет статус выбранных файлов и папок. Файлы, отображаемые в окне "Versioning", можно обновить для отражения всех внешних изменений.
	Diff All	Открывает Diff Viewer для сравнения локальных изменений с версиями из хранилища.
	Update All	Обновляет все выбранные файлы. (Применимо только к представлениям снимка.)
	checkin All	Позволяет зарегистрировать локальные изменения.

Доступ к другим командам ClearCase можно получить в окне "Versioning" путем выбора строки таблицы, соответствующей файлу, и команды в меню (для его появления щелкните правой кнопкой мыши):

Например, с файлом можно выполнить следующие действия:

Show Annotations: Отображает информацию об авторе и номере версии в левом поле файлов, открытых в редакторе исходного кода.
Exclude from Checkin: Позволяет отметить файл, который будет исключен из процесса регистрации.

Изменение выписанного файла

При выполнении команды diff для выписанных файлов можно вносить в них изменения непосредственно в Diff Viewer. Для этого поместите курсор внутри правой панели Diff Viewer и измените файл соответственно, либо используйте встроенные значки, отображаемые рядом с каждым выделенным изменением:

Replace ():	Вставляет выделенный текст из предыдущих версий в выписанную версию.
Move All ():	Возвращает выписанную версию файла в состояние выбранной предыдущей версии.
Remove ():	Удаляет выделенный текст из выписанной версия для обеспечения зеркального соответствия предыдущей версии.

Переход для просмотра отличий между сравниваемыми файлами

Если при выполнении команды diff отображается несколько отличий, между ними можно переходить с помощью значков в виде стрелки на панели инструментов. Эти значки в виде стрелки позволяют просматривать отличия файлов, отображаемые сверху вниз:

Previous ():	Используется для перехода к предыдущему отличию, отображаемому в команде diff
Next ():	Используется для перехода к следующему отличию, отображаемому в команде diff