• Netbeans
• Mercurial

Открытие проекта Mercurial в IDE

Если у вас уже есть проект Mercurial, с которым вы работали вне IDE, вы можете открыть его в IDE, и вам автоматически станут доступны функции управления версиями. Среда IDE сканирует открытые проекты, состояние файлов и контекстно-зависимую поддержку, которая автоматически становится активной для проектов с версиями Mercurial.

Извлечение файлов из репозитория

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

1. В IDE NetBeans выберите Группа > Mercurial >Клонировать другой (Team > Mercurial > Clone other) из главного меню. Откроется мастер клонирования.

Раскрывающиеся меню IDE зависят от контекста, то есть доступные опции зависят от выбранного в данный момент элемента. Следовательно, если вы уже работаете в проекте Mercurial, вы можете выбрать Группа > Удалённый >Клонировать другой (Team > Remote > Clone Other) из главного меню.

1. В поле URL репозитория введите путь к репозиторию (например, http://hg.netbeans.org/main ).

2. В полях Пользователь (User) и Пароль (Password), которые отобразит мастер клонирования, введите свои данные netbeans.org имя пользователя и пароль.

1. Если вы используете прокси-сервер, обязательно нажмите кнопку Настройки прокси-сервера (Proxy Configuration) и введите любую необходимую информацию в диалоговом окне Параметров. Когда вы убедитесь, что ваши настройки подключения к репозиторию верны, нажмите кнопку Далее.

2. На втором шаге нажмите Изменить (Change) справа от поля пути отправки по умолчанию. Откроется диалоговое окно Изменить путь отправки (Change Push Path).

1. Измените push-запись по умолчанию, добавив свое имя пользователя и пароль NetBeans и изменив протокол на https .

2. Нажмите Задать путь (Set Path). Диалоговое окно Изменить путь нажатия (Change Push Path) закроется.

3. Нажмите кнопку Далее (Next), чтобы перейти к третьему шагу мастера.

4. В поле Родительский каталог (Parent Directory) введите местоположение на вашем компьютере, в которое вы хотите извлечь файлы репозитория (в качестве альтернативы вы можете воспользоваться кнопкой Обзор (Browse)).

Если вы используете Windows, будьте осторожны с длиной пути, которую вы указываете; т.е., C:\Documents and Settings\myName\My Documents\NetBeans\etc\etc может привести к неудачному клонированию из-за очень длинных путей к файлам. Попробуйте использовать C:\ вместо этого.

1. Оставьте выбранным параметр Сканировать проекты NetBeans после проверки (Scan for NetBeans Projects), затем нажмите Готово (Finish), чтобы начать операцию проверки. IDE проверяет указанные источники, а строка состояния IDE показывает ход загрузки файлов из репозитория в ваш локальный рабочий каталог. Вы также можете просматривать файлы по мере их извлечения из окна вывода (Ctrl-4 в Windows / Command-4 в OS X).

Если извлеченные исходные тексты содержат проекты NetBeans, появится диалоговое окно с предложением открыть их в IDE. Если исходные тексты не содержат проекта, появится диалоговое окно с предложением создать новый проект из исходных текстов, а затем открыть их в IDE. Если вы создаете новый проект для таких источников, выберите соответствующую категорию проекта (в мастере создания проекта), а затем используйте опцию С существующими источниками в этой категории.

Импорт файлов в репозиторий

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

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

Как импортировать проект в репозиторий:

1. В окне Проекты (Projects) (Ctrl-1 в Windows / Command-1 в OS X) выберите неверсированный проект и выберите Группа > Mercurial > Инициализировать репозиторий(Team > Mercurial > Initialize Repository) из контекстного меню узла. Откроется диалоговое окно "Путь к корневому каталогу репозитория".

1. Укажите папку репозитория, в которую вы хотите поместить проект в репозитории. По умолчанию в текстовом поле Корневой путь (Root Path) вам предлагается папка, содержащая название вашего проекта.

2. Нажмите ОК, чтобы инициализировать действие Mercurial. После нажатия "ОК" IDE загружает файлы проекта в репозиторий. Выберите Окно > Вывод (Window > Output), чтобы открыть окно Вывод и просмотреть ход выполнения.

После того, как файлы проекта помещаются под контроль версий Mercurial, они регистрируются в репозитории как Locally New . Новые файлы и их состояние можно просмотреть, нажав на Mercurial > Показывать изменения (Mercurial > Show changes) в контекстном меню.

1. Выбирите Mercurial > Фиксация (Mercurial > Commit) щелкните правой кнопкой мыши в меню проекта, чтобы зафиксировать эти файлы проекта в репозитории Mercurial. Откроется диалоговое окно Фиксация - [Имя проекта] (Commit - [ProjectName]).

1. Введите свое сообщение в текстовой области Сообщения о фиксации (Commit Message) и нажмите кнопку Зафиксировать (Commit).

Зафиксированные файлы помещаются вместе с .hg каталог в каталоге репозитория Mercurial. Сведения о фиксации доступны в окне вывода IDE (Ctrl-4 в Windows / Command-4 в OS X).

Редактирование источников

Как только у вас будет открыт версионный проект Mercurial в IDE, вы можете начать вносить изменения в исходные тексты. Как и в случае с любым проектом, открытым в NetBeans IDE, вы можете открывать файлы в редакторе исходных текстов, дважды щелкнув по их узлам, которые отображаются в окнах IDE (например, Проекты (Ctrl-1 в Windows / Command-1 в OS X), Файлы (Ctrl-2 в Windows / Command-2 в OS X), Избранное (Ctrl-3 в Windows / Command-3 в OS X) windows).

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

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

• Просмотр информации О состоянии файла

• Сравнение ревизий файлов

• Объединение ревизий файлов

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

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

Зеленый ( )	Указывает строки, которые были добавлены со времени предыдущей редакции.
Красный ( )	Указывает строки, которые были удалены со времени предыдущей редакции.
Синий ( )	Указывает строки, которые были изменены со времени предыдущей редакции.

На левом поле редактора исходного кода показаны изменения, происходящие построчно. Когда вы изменяете данную строку, изменения немедленно отображаются на левом поле.

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

Правое поле редактора исходного кода предоставляет вам обзор изменений, внесенных в ваш файл в целом, сверху донизу. Цветовая кодировка генерируется немедленно, когда вы вносите изменения в свой файл.

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

Левое поле	Правое поле

Просмотр информации О состоянии файла

При работе с Проектами (Projects) (Ctrl-1 в Windows / Command-1 в OS X), Файлами (Files) (Ctrl-2 в Windows / Command-2 в OS X), Избранным (Favorites) (Ctrl-3 в Windows / Command-3 в OS X) или окнами управления версиями IDE предоставляет несколько визуальных функций, которые помогают просматривать информацию о состоянии ваших файлов. В приведенном ниже примере обратите внимание, как значок (например ), цвет имени файла и смежная метка состояния совпадают друг с другом, чтобы предоставить вам простой, но эффективный способ отслеживать информацию о версиях ваших файлов.:

Метки состояния - это текстовая индикация состояния файла в окнах Управления версиями, проектами и файлами. Чтобы отобразить метки состояния, выберите Вид > Показать метки управления версиями (View > Show Versioning Labels) на главной панели инструментов.

Значки, цветовое кодирование, метки состояния файлов и, возможно, самое главное, окно управления версиями - все это способствует эффективному просмотру информации о версиях в IDE и управлению ею.

• Значки и цветовая маркировка

• Метки состояния файла

• Окно управления версиями

Значки и цветовая маркировка

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

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

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

Цветовое кодирование применяется к именам файлов, чтобы указать их текущее состояние в репозитории:

Цвет	Пример	Описание
Синий		Указывает, что файл был изменен локально.
Зеленый		Указывает, что файл был добавлен локально.
Красный		Указывает, что файл содержит конфликты между вашей локальной рабочей копией и версией репозитория.
Серый		Указывает, что файл игнорируется Mercurial и не будет включен в команды управления версиями (например, Update и Commit). Игнорировать файлы можно только в том случае, если у них еще нет версии.
Зачеркнутый		Указывает, что файл исключен из операций фиксации. Зачеркнутый текст появляется только в определенных местах, таких как окно управления версиями или диалоговое окно фиксации, когда вы решаете исключить отдельные файлы из действия фиксации. На такие файлы по-прежнему влияют другие команды Mercurial, такие как Update.

Метки состояния файла

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

1. Выберите  Сервис > Параметры (Tools > Options) ( NetBeans > Preferences в OS X) из главного меню. Откроется окно Параметров.

2. Выберите кнопку Группа (Team) в верхней части окна, затем перейдите на вкладку Управления версиями под ней. Убедитесь, что Mercurial выбран в разделе Системы управления версиями на левой панели.

3. Чтобы переформатировать метки состояния таким образом, чтобы справа от файлов отображались только статус и папка, измените содержимое текстового поля Формат метки состояния на следующее:

[{status}; {folder}]

Нажмите "ОК". В метках состояния теперь отображается состояние файла и папки (где применимо).:

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

Окно управления версиями

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

Чтобы открыть окно управления версиями, выберите файл или папку с измененной версией (например, в окне Проекты (Projects), Файлы (Files) или Избранное (Favorites)) и либо выберите Mercurial > Show Changes щелкните в меню правой кнопкой мыши или выберите Группа > Mercurial > Показывать изменения (Team > Mercurial > Show Changes) из главного меню. В нижней части IDE появится следующее окно.:

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

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

Значок	Имя	Функция
	Состояние обновления	Обновляет состояние выбранных файлов и папок. Файлы, отображаемые в окне управления версиями, можно обновить, чтобы отразить любые изменения, которые могли быть внесены извне.
	Различать Все	Открывает программу просмотра различий, предоставляющую вам параллельное сравнение ваших локальных копий и версий, поддерживаемых в репозитории.
	Обновить Все	Обновляет все выбранные файлы из репозитория.
	Фиксировать Все	Позволяет вам фиксировать локальные изменения в репозитории.

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

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

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

* Отменить изменения : Открывает диалоговое окно Отмены изменений, которое вы можете использовать для указания параметров возврата любых локальных изменений к версиям, сохраняемым в репозитории.

[.особенность] —   —

Сравнение ревизий файлов

Сравнение ревизий файлов - обычная задача при работе с версионными проектами. IDE позволяет сравнивать ревизии с помощью команды Различия (Diff), которая доступна из контекстного меню выбранного элемента ( Mercurial > Различия > Отличия от базовой версии (Mercurial > Diff > Diff To Base) или Mercurial > Различия > Отличия от версии (Mercurial > Diff > Diff To Revision) ), а также из окна управления версиями. В окне управления версиями вы можете выполнить различия, либо дважды щелкнув файл в списке, либо щелкнув значок Изменить все ( ) расположен на панели инструментов вверху.

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

Средство просмотра различий использует ту же цветовую кодировку , которая используется в других местах для отображения изменений в системе управления версиями. На снимке экрана, показанном выше, зеленый блок указывает на содержимое, которое было добавлено в более актуальную версию. Красный блок указывает, что содержимое из более ранней версии было удалено из более поздней. Синий цвет указывает на то, что в пределах выделенной строки (строк) произошли изменения.

Кроме того, при выполнении diff для группы файлов, например для проекта, пакета или папки, или при нажатии кнопки Diff All ( ), вы можете переключаться между различиями, щелкнув файлы, перечисленные в верхней области средства просмотра различий.

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

• Внесите изменения в свою Локальную Рабочую копию

• Ориентируйтесь Среди Различий

Внесите изменения в свою Локальную Рабочую копию

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

Заменить ( ):	Вставляет выделенный текст из предыдущей редакции в текущую редакцию
Переместить все ( ):	Возвращает текущую редакцию файла к состоянию выбранной предыдущей редакции
Удалить ( ):	Удаляет выделенный текст из текущей редакции, чтобы он отражал предыдущую редакцию

Навигация по различиям между сравниваемыми файлами

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

Предыдущий ( ):	Переходит к предыдущей разнице, отображаемой в diff
Следующий ( ):	Переходит к следующему различию, отображаемому в diff

Объединение ревизий файлов

Среда IDE NetBeans позволяет объединять изменения между ревизиями репозитория и вашей локальной рабочей копией. В частности, это объединяет два отдельных набора изменений в репозитории в новый набор изменений, который описывает, как они объединяются.

1. В окне Проекты, Файлы или Избранное щелкните правой кнопкой мыши файлы или папки, для которых вы хотите выполнить операцию объединения, и выберите Mercurial > Ветвь/Тег > Объеденить изменения (Mercurial > Branch/Tag > Merge Changes) . Откроется диалоговое окно "Объеденить изменения".

2. В раскрывающемся списке "Выбрать из редакций" выберите редакцию. Вы переносите все изменения, внесенные в файл локальной рабочей копии с момента его создания.

3. Убедитесь, что данные описания, автора и даты указаны верно.

1. Нажмите Объединить. IDE включает все различия, обнаруженные между версиями репозитория и вашей локальной копией файла. Если возникают конфликты слияния, статус файла обновляется до Конфликт слияния , чтобы указать на это.

После объединения ревизий с вашей локальной рабочей копией вы все равно должны зафиксировать изменения с помощью команды Commit, чтобы они были добавлены в репозиторий.