2.2 Подготовка среды разработки (Перевод Book of Vaadin)

Оригинал 2.2. Setting up the Development Environment
В этом разделе описана пошаговая инструкция по подготовке среды разработки. Vaadin поддерживает различные виды инструментов, поэтому Вы можете использовать
любую IDE для редактирования кода, большинство веб браузеров для просмотра результата,
любую операционную систему и процессор, которые поддерживают Java 1.5 и практически любой веб сервер для развертывания приложения. В нашем примере мы будем использовать следующий набор инструментов:

 - Windows XP, Linux, or Mac OS X
 - Java 2 Standard Edition 6.0 (Java 1.5 or newer is required)
 - Eclipse IDE for Java EE Developers
 - Apache Tomcat 6.0 (Core) or newer
 - Firefox 3.0.7 or newer
 - Firebug 1.3.3 or newer (optional)
 - Vaadin 6.x.x

Это хороший набор инструментов, но Вы можете использовать любой удобный для Вас.

Рис. 2.2 Набор инструментов и процесс разработки

На рис. 2.2 "Набор инструментов и процесс разработки" продемонстрированы среда и процесс разработки. Вы создаете свое приложение как Eclipse проект. Проект помимо вашего кода должен включать в себя библиотеку Vaadin. Вы также можете включить в проект ваши темы.
Вы должны скомпилировать и развернуть проект в веб контейнер прежде чем сможете использовать его. Развернуть можно через Web Tools Platform для Eclipse, который поддерживает автоматическое развертывание приложений из Eclipse. Вы также можете развернуть приложение вручную через интерфейс веб контейнера, предварительно создав web application archive (WAR).

2.2.1 Установка Java SDK
Установка Java SDK является обязательной для использования Vaadin и Eclipse IDE. Vaadin совместим с Java 1.5 и юолее поздними версиями.

Windows
1. Скачайте Java 2 Standard Edition 6.0 http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. Установите Java SDK, запустив установщик приложения. Можно использовать значения по умолчанию.

Linux/UNIX
1. Скачайте Java 2 Standard Edition 6.0 http://www.oracle.com/technetwork/java/javase/downloads/index.html
2. Распакуйте архив в какую-нибудь легкодоступную директорию, например, /opt. Введите следующие команды (в Linux используйте sudo):
# cd /opt
# sh (path-to-installation-package)/jdk-6u1-linux-i586.bin
и следуйте инструкциям.

2.2.2 Установка Eclipse IDE

Windows
1. Скачайте Eclipse IDE for Java EE Developers(Ganymede version) http://www.eclipse.org/downloads/
2. Распакуйте архив в легкодоступную директорию. Вы можете выбрать любую директорию и любой архиватор. В нашем примере мы использовали стандартный архиватор Windows и распаковали архив в папку C:\dev. Eclipse теперь установлен в папку C:\dev\eclipse и может быть запущен двойным щелчком по eclipse.exe.

Linux / UNIX
Имеется два основных способа установки  Eclipse на Linux и UNIX: можно установить при помощи менджера пакетов Вашей операционной системы или вручную, скачав соответствующий архив. Мы рекомендуем устанавливать Eclipse вручную, так как последние версии пакета в репозитории могут быть несовместимыми с необходимыми плагинами.
1. Скачайте Eclipse IDE for Java EE Developers(Ganymede version) http://www.eclipse.org/downloads/
2. Распакуйте архив в легкодоступную директорию. Важно чтобы в этой папке не была установлена предыдущая версия Eclipse. Установка новой версии поверх старой может привести к неработоспособности Eclipse.
3. Eclipse должен быть установлен под обычным пользователем, это облегчит установку плагинов. Также eclipse хранит некоторые пользовательские данные в папке, выбранной при установке. Для того, чтобы установить пакет введите:
$ tar zxf (path-to-installation-package)/eclipse-jee-ganymede-SR2-linux-gtk.tar.gz
Эта команда распакует архив в подпапку eclipse.

Альтернативным способом установки является использование менеджера приложений Вашей операционной системы. Например, в Ubunyu Linux, в репозиторий которой включены Java SDK и Eclipse, Вы можете установить их следующей командой:
$ sudo apt-get install sun-java6-jdk eclipse.

Тем не менее этот способ не рекомендуем, так как пакет Eclipse может не включать небходимых плагинов, таких как Java EE tools, Web Standard Tools. Это может привести к несовместимости некоторых компонентов.

2.2.3 Установка Apache Tomcat
Apache Tomcat(википедия) -  программа-контейнер сервлетов, написанная на языке Java, подходящий как для разработки, так и для production. Существует множество способов его установить, но здесь мы просто распакуем установочный архив.
Apache Tomcat должен быть установлен с правами пользователя.
1. Скачайте Apache Tomcat 6.0 (Core Binary Distribution) с http://tomcat.apache.org/
2. Разархивируйте Apache Tomcat в удобную директорию, например, C:\dev (Windows) или /opt (Linux or Mac OS X).
Домашней директорией для Apache Tomcat будет C:\dev\apache-tomcat-6.0.x или /opt/apache-tomcat-6.0.x, соответственно.

2.2.4 Firefox и Firebug
Vaadin поддерживает многие браузеры и вы можете использовать любые из них для разработки. Но если Вы планируете создавать собственные темы или новые компоненты пользовательского интерфейса, мы рекомендуем Вам использовать Firefox с установленным Firebug'ом для отладки. У Vaadin есть спецальная поддержка для Firebug, и вы можете получать некоторую информацию из консоли Firebug.

Если у Вас еще не установлен Firefox, скачайте установочник www.getfirefox.com и запустите его.

Дополнительно. После установки Firefox используйте его, чтобы открыть http://www.getfirebug.com/.
Следуйте инструкциям на сайте, чтобы установить последнюю стабильную версию Firebug для Вашего браузера. Возможно вам придется разрешить установку, щелкнув по предупреждающей строке в верхней части окна браузера.

Когда Firebug установлен, он может быть включен в любое время щелчком по правому нижнему углу окна Firefox'а.

Рис. 2.3 "Firebug Debugger for Firefox"

На рис. 2.3 "Firebug Debugger for Firefox" показано как выглядит Firebug в действии.

Мы установили всю среду разработки и можем приступить к к созданию нашего первого приложения.

2.2.5 Vaadin Plugin для Eclipse
Если Вы используете Eclipse IDE, Вам здорово поможет Vaadin plugin. Плагин включает в себя:
 - Wizard'ы для создания Vaadin-проекта, тем и виджетов.
 - Визуальный редактор для редактирования компонентов пользовательского интерфейса в стиле WYSIWYG(http://ru.wikipedia.org/wiki/WYSIWYG). С полной поддержкой "туда-обратно" из исходного кода в визуальную модель и обратно, редактор интегрируется с процессом разработки.
 - Версию Book of Vaadin, которую можно просматривать в окне Eclipse Help.

Установить плагин вы можете следующим образом:
1. Запустите Eclipse.
2. Выберите Help - Software Updates....
3. Выберите вкладку Available Software.
4. Добавьте сайт для Vaadin plugin. Для этого щелкните Add Site....

В появившемся окне введите URL для Vaadin Update Site: http://vaadin.com/eclipse и нажмите OK.
Сайт Vaadin теперь должен быть доступен в окне Software Updates.
5. Выделите все дерево плагина Vaadin.

Нажмите Install.

Обновление плагина для Vaadin
Если вы разрешили автоматическое обновление для Eclipse(см. Window - Preferences - Install/Update - Automatic Updates), Vaadin будет автоматически обновлятся вместе с другими плагинами. В противном случае Вы можете обновить его следующим образом:
1. Выберите Help - Software Updates..., откроется окно Software Updates and Add-ons
2. Выберите закладку Installed Software.
3. Если вы хотите обновить только плагины Vaadin, выделите их при помощи мышки и клавиши Ctrl.

4. Нажмите Update.
Обратите внимание, что обновление плагина не повлияет на саму библиотеку Vaadin, которая специфична для каждого отдельного проекта.
Ниже даны инструкции по обновлению библиотеки.

Обновление библиотеки Vaadin.
Обновление плагина Vaadin не обновит библиотеку. Библиотека специфична для каждого отдельно проекта и для разных проектов
могут использоваться различные версии библиотеки, поэтому Вы должны обновлять библиотеку отдельно для каждого проекта.
Для изменения версии библиотеки необходимо сделать следующее:
1. Выберите проект в окне Project Explorer, выберите Project - Preferences из контекстного меню или нажмите комбинацию Alt-Enter.
2. В открывшемся окне свойств проекта выберите  Vaadin - Vaadin Version.
3. Если необходимая версия отсутствует в выпадающем списке, нажмите Download, ятобы открыть окно скачивания.

Если Вы хотите использовать версию для разработчиков, выделите Show pre-release versions and nightly builds.
Выберите необходимую версию и нажмите ОК.
4. Выберите нужную версию из выпадающего списка и нажмите Apply.
Вы можете посмотреть и убедиться, что в папке WebContent/WEB-INF/lib появилась новая библиотека.