// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= Использование поддержки Mercurial Queues в IDE NetBeans
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Использование поддержки Mercurial Queues в IDE NetBeans - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Использование поддержки Mercurial Queues в IDE NetBeans

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

== Требования

*Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.*

|===
|Программное обеспечение или материал |Требуемая версия 

|link:https://netbeans.org/downloads/index.html[+IDE NetBeans+] |Версия 7.4 или 8.0 

|link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+Комплект для разработки приложений на языке Java+] (JDK) |Версия 7 или 8 

|link:http://mercurial.selenic.com/downloads/[+Клиентское программное обеспечение Mercurial+] |1.04 или более поздняя версия 
|===

NOTE:  См. link:mercurial.html#settingUp[+Использование поддержки Mercurial в NetBeans IDE+] для получения сведений об установке клиентского ПО Mercurial в системе.


== Включение поддержки Mercurial Queues

Поскольку Mercurial Queues является расширением, необходимо явно включить его до начала его использования.
Для начала выполнения Mercurial Queues в репозитории Mercurial необходимо выполнить следующие шаги:

1. В системе перейдите к файлу  ``.hgrc`` . По умолчанию для файла  ``.hgrc``  в OS X и Linux задается местоположение  ``$HOME/.hgrc`` , а в Windows -  ``%USERPROFILE%\Mercurial.ini`` .
2. Добавьте строки ниже к файлу  ``.hgrc`` .

[source,ini]
----
     [extensions]
     hgext.mq =
----
[start=3]
. Сохраните файл.




== Создание исправления

Чтобы создать исправление, выполните следующие шаги:

1. В окне 'Проекты' выберите проект, который находится под управлением системы контроля версий, затем выберите  ``Группа``  >  ``Queues``  >  ``Создать исправление``  (также можно щелкнуть правой кнопкой мыши узел проекта и выбрать  ``Mercurial``  >  ``Queues``  >  ``Создать исправление``  в раскрывающемся меню).
Откроется диалоговое окно 'Создать исправление'

[.feature]
--
image::images/create-patch-small.png[role="left", link="images/create-patch.png"]
--

[start=2]
. Укажите имя исправления в текстовом поле 'Имя исправления'.
. Укажите описание исправления в поле 'Сообщение исправления'.
В качестве альтернативы выберите один из следующих вариантов и нажмите ОК:
* нажмите кнопку 'Последние сообщения' (image::images/recent.png[]), чтобы выбрать сообщение из списка последних сообщений фиксации
* нажмите кнопку 'Загрузить шаблон' (image::images/load.png[]), чтобы выбрать шаблон сообщения для сообщения фиксации

NOTE:  Предоставленное описание исправления будет использовано как сообщение фиксации при <<finish,преобразовании исправление в повтоянный набор изменений>>.

[start=4]
. Выберите файлы для включения в исправления в таблице 'Файлы для включения в исправление'.
. (Необязательно) Укажите данные, связанные с ошибкой созданного исправления с помощью полей области 'Ошибка обновления'.
. Нажмите кнопку "Создать исправление".
Создается новое исправление и добавляется к каталогу  ``.hg/patches`` .




== Обновление исправления с учетом локальных изменений

Чтобы сохранить ход выполнения в создаваемом исправлении необходимо выполнить следующие шаги.

1. Выберите  ``Группа``  >  ``Queues``  >  ``Обновить исправление``  в главном меню (также можно щелкнуть правой кнопкой мыши имя проекта и выбрать  ``Mercurial``  >  ``Queues``  >  ``Обновить исправление``  в раскрывающемся меню).
Откроется диалоговое окно 'Обновить исправление'.

[.feature]
--
image::images/refresh-patch-small.png[role="left", link="images/refresh-patch.png"]
--

[start=2]
. Укажите описание исправления в поле 'Сообщение исправления'.
В качестве альтернативы выберите один из следующих вариантов и нажмите ОК:
* нажмите кнопку 'Последние сообщения' (image::images/recent.png[]), чтобы выбрать сообщение из списка последних сообщений фиксации
* нажмите кнопку 'Загрузить шаблон' (image::images/load.png[]), чтобы выбрать шаблон сообщения для сообщения фиксации

NOTE:  Предоставленное описание исправления будет использовано как сообщение фиксации при <<finish,преобразовании исправление в повтоянный набор изменений>>.

[start=3]
. Выберите файлы для включения в исправления в таблице 'Файлы для включения в исправление'.
. (Необязательно) В области 'Ошибка обновления' укажите данные, связанные с ошибкой фиксации изменений.
. Щелкните 'Обновить исправление'.
Исправление, над которым ведется работа, обновляется.




== Сравнение версий исправлений

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

1. Выберите  ``Группа``  >  ``Queues``  >  ``Различие``  в главном меню (также можно щелкнуть правой кнопкой мыши имя проекта и выбрать  ``Mercurial``  >  ``Queues``  >  ``Различие``  в раскрывающемся меню).
В 'Средстве просмотра различий' отображаются различия, выявленные в текущем исправлении и все не зафиксированные и не обновленные локальные изменения на панелях, расположенных параллельно:

[.feature]
--
image::images/qdiff-small.png[role="left", link="images/qdiff.png"]
--

[start=2]
. Просмотрите и откорректируйте различия, найденные в сравненных файлах с помощью графического или текстового средства просмотра различий.

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

|===
|*Синий* (       ) |Строки, измененные по сравнению с предыдущей версией. 

|*Зеленый* (       ) |Обозначает строки, добавленные к более раннему исправлению. 

|*Красный* (       ) |Строки, удаленные из предыдущего исправления. 
|===

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

|===
|Значок |Имя |Функция 

|image:images/replace.png[] |*Заменить* |Вставка выделенного текста из предыдущеuj исправления в текущее исправление. 

|image:images/replace-all.png[] |*Заменить все* |Восстанавливает для текущей версии исправления состояние выбранной предыдущей версии. 

|image:images/remove.png[] |*Удалить * |Удаляет выделенный текст из текущей версии исправления, чтобы она отражала предыдущую версию исправления. 
|===


== Переключение между исправлениями

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

NOTE:  Для переключения между изменениями _требуется_ _отсутствие_ локальных изменений в рабочей копии. В противном случае переключение завершится ошибкой.

1. Выберите  ``Группа``  >  ``Queues``  >  ``Перейти к исправлению``  в главном меню (также можно щелкнуть правой кнопкой мыши имя проекта и выбрать  ``Mercurial``  >  ``Queues``  >  ``Перейти к исправлению``  в раскрывающемся меню).
В диалоговом окне 'Перейти к исправлению' отображается сисок всех исправлений. доступных в стеке.

image::images/go-patch.png[]

*Примечания*

* Имена отображенных примененных исправлений, выделенных полужирным.
* Выберите  ``Группа``  >  ``Queues``  >  ``Откат всех исправлений`` , чтобы удалить примененные исправления из верхней части стека, обновить рабочий каталог и отменить изменения, внесенные установленными исправлениями.
[start=2]
. Выберите необходимое исправление и щелкните 'Перейти'.
В IDE применяются изменения, содержащиеся в выбранном исправлении выбранного проекта, файла или папки.




== Завершение примененных исправлений

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

NOTE:  Для применения всех сохраненных исправлений в репозитории выберите  ``Группа``  >  ``Queues``  >  ``Принудительно применить все исправления``  в главном меню.

1. Выберите  ``Группа``  >  ``Queues``  >  ``Завершить исправления``  в главном меню (также можно щелкнуть правой кнопкой мыши имя проекта и выбрать  ``Mercurial``  >  ``Queues``  >  ``Завершить исправления``  в раскрывающемся меню).
Откроется диалоговое окно 'Завершить исправления'

image::images/finish-patches.png[]

[start=2]
. Выберите имя исправления, которое будет завершено в поле исправлений.

NOTE:  Все исправления в серии до выбранного исправления также будет завершены.

[start=3]
. Щелкните 'Завершить исправления'.
IDE преобразует все примененные изменения вплоть до выбранного исправления в стандартные наборы изменений.




== Заключение

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



link:/about/contact_form.html?to=3&subject=Feedback:%20Using%20Suport%20For%20Mercurial%20Queues%20in%20NetBeans%20IDE[+Отправить отзыв по этому учебному курсу+]



== Дополнительные сведения

Связанные материалы можно найти в следующих документах:

* link:mercurial.html[+Использование поддержки Mercurial в IDE NetBeans+]
* link:http://wiki.netbeans.org/HgNetBeansSources[+Использование Mercurial для работы с исходными файлами NetBeans в среде IDE+]
* link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG234[+Управление версиями приложений в системах контроля версий+] в документе _Разработка приложений в IDE NetBeans_



