Командна розробка на GWT в Eclipse

Опубліковано Aндрій Скалюк - 20.10.2007, 15:38
Теги:  Eclipse  GWT  team 

Передмова

Коли команда розробників береться за створення проекту - вони вибирають інструментарій, середовище розробки, систему контролю версій коду (source control) та способ спілкування один з одним. Ми обрали Eclipse IDE для розробки та Subversion (SVN) для обміну кодом. Подібна комбінація доволі популярна, оскільки вона зручна для розробки на Java та зокрема на GWT.

Для успішної компіляції та відлагодження проект потребує наявності бібліотек GWT, але у різних розробників проект та сам GWT розміщені зазвичай за різними шляхами на диску. Ми пропонуємо рішення створення одного проектного простору для всіх розробників на основі змінних середовища в Eclipse. Тестування проводилося на Eclipse версій 3.2 и 3.3.

Рішення

Ідея полягає у тому, щоб в середовищі Eclipse створити змінну GWT_HOME, яка буде вказувати місце розташування GWT локально для кожного розробника. В такому випадку кожний отримає робоче середовище проекту, якщо у нього вірно встановлена вказана змінна. Нижче описано приклад налаштування проекту для Windows, а також зауваження Linux розробників.

Встановлення змінної GWT_HOME

Проводиться для кожного розробника одноразово:

1. В головному меню Eclipse знаходимо управління Classpath Variables. Для цього: Menu - Window - Preferences - Java - Build Path - Classpath Variables;
2. Створимо змінну GWT_HOME. Кнопка New:
   • вкажемо ім'я. Name: GWT_HOME;
   • вкажемо свій шлях до кореневої теки GWT, наприклад "c:\gwt".

Створення нового проекту на GWT, перший commit

1. Користуючись стандартними утилітами для створення проекту:
   • projectCreator -eclipse NewApplication -out d:\test\
   • applicationCreator -eclipse NewApplication -out d:\test\ net.pleso.client.NewApplication
2. Імпортуємо створений проект до Eclipse. Menu - File - Import - Existing Projects into Workspace. Вказуємо його місце розташування, наприклад "d:\test\"
3. Налаштовуємо бібліотеку gwt-user за допомогою GWT_HOME:
   • правий клік на project root - Properties - Java Build Path - Libraries.
   • delete gwt-user.jar
   • Add Variable - GWT_HOME - Extend - gwt_user.jar - Ok
4. Налаштовуємо бібліотеку gwt-dev-windows.jar за допомогою GWT_HOME:
   • Run - Java Application - NewApplication (your name) - Classpath
   • gwt-dev-windows.jar - Remove
   • Advanced - Add Classpath Variables - GWT_HOME - Extend - gwt-dev-windows.jar - Ok
5. Відпускаємо проект в SVN-репозиторій.
6. Необов'язково, але зручно додати до svn:ignore:
   • bin
   • tomcat
   • .gwt-cache

Інструкція експорту проекту із SVN

• checkout проекта. Menu - File - Import - Checkout from SVN - trunk;
• проект має отримати назву аналогічну його автору, Eclipse зазвичай автоматично це розпізнає та заповнює поле Project Name. В наведеному прикладі це NewApplication;
• після того, як проект був отриманий із SVN: Run - java application - NewApplication - Run (запуск) - запускається Host-mode вікно GWT;
• debug виконується аналогічно.

Примітки для розробників на Linux

• файли бібліотек (gwt-dev-windows.jar и т.д.) замінюються на відповідні для Linux;
• для Linux необхідно створити свій Run/Debug Config. Для цього: Run - java application - вибрати NewApplication - правою кнопкою Dublicate - назвати NewApplication-Linux;
• далі виконати аналогічні зміни, що описані в розділі "Створення нового проекту на GWT";
• маємо отримати дві конфігурації для Run/Debug;
• відпустити проект в SVN - для Windows та Linux отримуємо різні конфігурації.

Альтернативні рішення

Нам відоме наступне альтернативне рішення для командної розробки, що потребує встановлення додаткових розширень: Googlipse - An Eclipse plugin for Google Web Toolkit (GWT)