Requality

h1. Системные требования

* Операционная система Windows или Linux. Поддерживаются x86 и x64 архитектуры. При использовании x86 архитектуры все нижеперечисленные программы также должны быть x86. При использовании x64 все используемые программы могут быть либо все x86, либо все x64. В настоящее время под Windows x64 нет поддерживаемого браузерного движка, интегрирующегося с Eclipse, поэтому с Windows x64 следует использовать x86 версии.

* "Sun Java SE":http://java.sun.com/javase/downloads/index.jsp (рекомендуется версия 7.0, поддерживается 6.0 и выше)

* "Eclipse Platform":http://www.eclipse.org/downloads/packages/release/indigo/sr2 (рекомендуется 3.7) Можно использовать минимальную сборку Platform Runtime Binary (около 50MB) или любой из пакетов на её основе.

Для установки Eclipse достаточно распаковать архив в удобное место. При этом будет создан подкаталог ''eclipse''.

* XULRunner 1.9.2.19. XULRunner Eclipse plugin: http://forge.ispras.ru/repo/xulrunner-eclipse/site/. Для Linux наряду с XULRunner поддерживается "WebKit":http://www.webkit.org/

* Для командной работы с проектом также требуется установка "Subversive":http://www.eclipse.org/subversive/, "EGit":http://www.eclipse.org/egit/ или другой Eclipse Team Provider, в зависимости от используемой системы контроля версий. Рекомендуется EGit.

|_. Зависимость |_. Минимальная версия |_. Рекомендуемая версия |_. Windows x86, x86-64 |_. Linux x86 |_. Linux x86-64 |

| "Sun/Oracle Java SE":https://www.java.com/en/download/ | 6.0 | 7.0 | x86 | x86 | x86 или x86-64 |

| "Eclipse Platform":http://eclipse.org/ | 3.7.2 | 4.3.2 | x86 | x86 | x86 или x86-64 |

| "XULRunner":https://developer.mozilla.org/en-US/docs/Mozilla/Projects/XULRunner | 1.9.2.19 | 1.9.2.19 | x86 | x86 | x86 или x86-64 |

h1. Подготовка к установке Requality

h2. Установка Eclipse

Для установки Eclipse достаточно распаковать архив в удобное место, при этом будет создан подкаталог eclipse.

При использовании Java 7 для включения режима обратной совместимости в конец файла eclipse.ini необходимо добавить строку:

-Djava.util.Arrays.useLegacyMergeSort=true

Дальнейшие действия требуют знакомства с "установкой плагинов Eclipse с использованием сайта обновления":http://help.eclipse.org/indigo/index.jsp?topic=%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-124.htm.

h2. Интеграция браузера в Eclipse

Requality требует интеграции браузерного движка с Eclipse. Поддерживаются XULRunner от Mozilla Foundation и WebKit. В зависимости от операционной системы рекомендуется использовать разные браузерные движки.

ВНИМАНИЕ! После установки Requality вы сможете проверить, успешно был установлен браузерный движок. Как это сделать читайте ниже в разделе "После установки".

h3. Windows

Для Windows рекомендуется использовать Mozilla XULRunner.

ВНИМАНИЕ! На Windows x86_64 для использования XULRunner нужно дополнительно установить "Visual C++ 2010 runtime":http://www.microsoft.com/en-us/download/details.aspx?id=13523

Для этого нужно установить Eclipse плагин, который содержит XULRunner, с использованием сайта обновления, указанного в разделе Системные требования.

Если этот способ по каким-то причинам не подходит, возможен альтернативный способ установки XULRunner:

Скачать соответствующий архив XULRunner с сайта, указанного в разделе Системные требования.

Распаковать архив в удобное место.

При использовании ОС Windows после распаковки XULRunner необходимо зарегистрировать в системе командой:

_xulrunner.exe --register-global_

В Windows 7 эта команда должна выполняться с правами администратора системы.

При уже установленном браузере Mozilla Firefox можно не устанавливать отдельную копию XULRunner. Можно скопировать в папку с Firefox только файл xulrunner.exe и выполнить вышеуказанную команду.

Также можно просто добавить в реестр следующую информацию (контролируйте правильность путей и номеров версий!):

_Windows Registry Editor Version 5.00_

_[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org]_

_[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org\GRE]_

_[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org\GRE\1.9.2.19]_

_"Version"="1.9.2.19"_

_"GreHome"="C:\\Program Files\\Mozilla Firefox"_

_"xulrunner"="true"_

_"abi"="x86-msvc"_

_"javaxpcom"="1"_

_[HKEY_LOCAL_MACHINE\SOFTWARE\mozilla.org\Mozilla]_

_"CurrentVersion"="1.9.2.19"_

* Для *Eclipse 4.4* и старше рекомендуется скачать XULRunner "с сайта":http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/10.0.4esr/runtimes/, распаковать скачанный архив в удобное место на диске и дописать в eclipse.ini строчку:

_-Dorg.eclipse.swt.browser.XULRunnerPath=<path to XULRunner>_

Если после распаковки скачанного архива ваш XULRunner лежит в папке C:\xulrunner, эта строка должна будет выглядеть так:

_-Dorg.eclipse.swt.browser.XULRunnerPath=C:\xulrunner_

h3. Linux

Для *Linux* рекомендуется использовать _WebKit_. Также можно использовать _XULRunner_.

* Для установки WebKit нужно выполнить в командной строке команду:

_sudo apt-get install libwebkitgtk-1.0-0_

* Для использования XULRunner нужно скачать архив с сайта, распаковать скачанный архив в удобное место на диске и дописать в eclipse.ini строчку:

_-Dorg.eclipse.swt.browser.XULRunnerPath=<path to XULRunner>_

Если после распаковки скачанного архива ваш XULRunner лежит в папке C:\xulrunner, эта строка должна будет выглядеть так:

_-Dorg.eclipse.swt.browser.XULRunnerPath=C:\xulrunner_

h2. Установка плагина для взаимодействия с системой контроля версий

Совместная работа над требованиями обеспечивается системой контроля версий. Следует убедиться, что в используемой среде Eclipse установлены плагины для взаимодействия с выбранной системой контроля версий: CVS, Subversion, git и т.п. При необходимости соответствующий плагин может быть установлен из репозитория Eclipse. Для работы с Subversion рекомендуется использовать плагин Subversive (плагин Subclipse не рекомендуется).

h1. Установка Requality

Возможны два варианта установки инструмента: в каталог eclipse/dropins или через Eclipse Update Manager. Первый способ позволяет использовать инструмент как из Eclipse, так и в консольном режиме. Второй способ упрощает процесс обновления версии инструмента, но ограничивает использование только средой Eclipse.

h3. 1. Вариант установки через Eclipse Update Manager (update site)

* Установка

Для установки Requality с помощью Eclipse Update Manager в оконном меню выберите пункт ''Install New Software...''

!InstallNewSoftware.png! 

В открывшемся окне введите информацию о сайте обновления Requality.

!AddUpdateSiteRequality.png!

Name: Requality

Location: http://forge.ispras.ru/repo/requality/site/

Далее выберите плагин Requality в списке доступных плагинов и продолжайте установку согласно указаниям мастера установки плагинов.

!InstallRequality.png!

В процессе установки появится предупреждение о неподписанном содержании. Нажмите ''OK''.

!SecurityWarning.png!

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

* Удаление

Для удаления плагина в оконном меню выберите пункт Help -> About Eclipse. В открывшемся окне ''About Eclipse'' нажмите кнопку ''Installation Details''. В открывшемся окне ''Eclipse Installation Details'' выберите нужный плагин - Requality, нажмите кнопку ''Uninstall'' и продолжите удаление плагина согласно указаниям мастера удаления плагинов.

После окончания удаления Eclipse должен быть перезагружен.

* Обновление

Для обновления Requality, установленного с помощью Eclipse Update Manager, в оконном меню выберите пункт Help -> Check for Updates. Дождитесь окончания процесса поиска обновлений. В открывшемся окне ''Available Updates'' проверьте наличие обновления для плагина Requality. Если этот плагин есть в списке, отметьте его галочкой и продолжите установку обновления согласно указаниям мастера обновления плагинов.

!RequalityUpdate.png!

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

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

h3. 2. Вариант установки в dropins

* Установка

Для установки Requality распакуйте архив в каталог eclipse/dropins.

* Удаление

Запустите Eclipse, в которую установлен Requality. Установите любую перспективу, отличную от Requality. Закройте Eclipse.

Удалите каталог с Requality из eclipse/dropins.

Запустите Eclipse для обновления информации об установленных плагинах. Закройте Eclipse.

* Обновление 

Удалите предыдущую версию Requality, а затем установите новую версию, как описано в пунктах ''Установка'' и ''Удаление''.

h1. После установки

После установки Requality нужно проверить, что браузер был успешно интегрирован с Eclipse.

Для этого нужно в главном меню Eclipse выбрать ''Window -> Preferences''. В ''Preferences'' выбрать пункт ''Requality''. Справа вы увидите, какие браузеры интегрированы с ''Eclipse'' и какой из них на данный момент активен (используется).

!CheckEngine.png!

Чтобы изменить активный браузер, нужно кликнуть на поле ''Browser Engine'' и в выпадающем списке выбрать желаемый. Далее следует сохранить изменения, нажав кнопку ''Apply''. При этом Eclipse должен быть перезапущен, чтобы изменения вступили в силу.

Если нужный браузер в выпадающем списке имеет статус ''not available'', значит либо вы его не установили, либо установка прошла некорректно. Активирован может быть только тот браузер, который имеет статус ''available''.