blob: f9fce50645207bfc485f8fe2eb1aabbfd8998d91 [file] [log] [blame]
//
// 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 =
----
. Сохраните файл.
== Создание исправления
Чтобы создать исправление, выполните следующие шаги:
1. В окне 'Проекты' выберите проект, который находится под управлением системы контроля версий, затем выберите ``Группа`` > ``Queues`` > ``Создать исправление`` (также можно щелкнуть правой кнопкой мыши узел проекта и выбрать ``Mercurial`` > ``Queues`` > ``Создать исправление`` в раскрывающемся меню).
Откроется диалоговое окно 'Создать исправление'
[.feature]
--
image::images/create-patch-small.png[role="left", link="images/create-patch.png"]
--
. Укажите имя исправления в текстовом поле 'Имя исправления'.
. Укажите описание исправления в поле 'Сообщение исправления'.
В качестве альтернативы выберите один из следующих вариантов и нажмите ОК:
* нажмите кнопку 'Последние сообщения' (image::images/recent.png[]), чтобы выбрать сообщение из списка последних сообщений фиксации
* нажмите кнопку 'Загрузить шаблон' (image::images/load.png[]), чтобы выбрать шаблон сообщения для сообщения фиксации
NOTE: Предоставленное описание исправления будет использовано как сообщение фиксации при <<finish,преобразовании исправление в повтоянный набор изменений>>.
. Выберите файлы для включения в исправления в таблице 'Файлы для включения в исправление'.
. (Необязательно) Укажите данные, связанные с ошибкой созданного исправления с помощью полей области 'Ошибка обновления'.
. Нажмите кнопку "Создать исправление".
Создается новое исправление и добавляется к каталогу ``.hg/patches`` .
== Обновление исправления с учетом локальных изменений
Чтобы сохранить ход выполнения в создаваемом исправлении необходимо выполнить следующие шаги.
1. Выберите ``Группа`` > ``Queues`` > ``Обновить исправление`` в главном меню (также можно щелкнуть правой кнопкой мыши имя проекта и выбрать ``Mercurial`` > ``Queues`` > ``Обновить исправление`` в раскрывающемся меню).
Откроется диалоговое окно 'Обновить исправление'.
[.feature]
--
image::images/refresh-patch-small.png[role="left", link="images/refresh-patch.png"]
--
. Укажите описание исправления в поле 'Сообщение исправления'.
В качестве альтернативы выберите один из следующих вариантов и нажмите ОК:
* нажмите кнопку 'Последние сообщения' (image::images/recent.png[]), чтобы выбрать сообщение из списка последних сообщений фиксации
* нажмите кнопку 'Загрузить шаблон' (image::images/load.png[]), чтобы выбрать шаблон сообщения для сообщения фиксации
NOTE: Предоставленное описание исправления будет использовано как сообщение фиксации при <<finish,преобразовании исправление в повтоянный набор изменений>>.
. Выберите файлы для включения в исправления в таблице 'Файлы для включения в исправление'.
. (Необязательно) В области 'Ошибка обновления' укажите данные, связанные с ошибкой фиксации изменений.
. Щелкните 'Обновить исправление'.
Исправление, над которым ведется работа, обновляется.
== Сравнение версий исправлений
Для создания исправления для просмотра и одновременного сравнения редакций необходимо выполнить следующие шаги:
1. Выберите ``Группа`` > ``Queues`` > ``Различие`` в главном меню (также можно щелкнуть правой кнопкой мыши имя проекта и выбрать ``Mercurial`` > ``Queues`` > ``Различие`` в раскрывающемся меню).
В 'Средстве просмотра различий' отображаются различия, выявленные в текущем исправлении и все не зафиксированные и не обновленные локальные изменения на панелях, расположенных параллельно:
[.feature]
--
image::images/qdiff-small.png[role="left", link="images/qdiff.png"]
--
. Просмотрите и откорректируйте различия, найденные в сравненных файлах с помощью графического или текстового средства просмотра различий.
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`` > ``Откат всех исправлений`` , чтобы удалить примененные исправления из верхней части стека, обновить рабочий каталог и отменить изменения, внесенные установленными исправлениями.
. Выберите необходимое исправление и щелкните 'Перейти'.
В IDE применяются изменения, содержащиеся в выбранном исправлении выбранного проекта, файла или папки.
== Завершение примененных исправлений
После завершения работы с исправлениями оно может быть преобразовано в постоянный набор изменений.
Для преобразования всех примененных исправлений в серии очередей исправлений в стандартные наборы изменений завершите следующие шаги:
NOTE: Для применения всех сохраненных исправлений в репозитории выберите ``Группа`` > ``Queues`` > ``Принудительно применить все исправления`` в главном меню.
1. Выберите ``Группа`` > ``Queues`` > ``Завершить исправления`` в главном меню (также можно щелкнуть правой кнопкой мыши имя проекта и выбрать ``Mercurial`` > ``Queues`` > ``Завершить исправления`` в раскрывающемся меню).
Откроется диалоговое окно 'Завершить исправления'
image::images/finish-patches.png[]
. Выберите имя исправления, которое будет завершено в поле исправлений.
NOTE: Все исправления в серии до выбранного исправления также будет завершены.
. Щелкните 'Завершить исправления'.
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_