Избранное | Русский | Войти

Использование плагина Google для Eclipse

Можно просто использовать среду разработки Eclipse для разработки приложений App Engine Java, также как и для разработки других веб-приложений на основе сервлетов. Плагин Google для Eclipse еще больше упрощает разработку. Плагин позволяет создавать, тестировать и загружать приложения App Engine из Eclipse.

Плагин Google для Eclipse также упрощает разработку приложений с помощью Google Web Toolkit (GWT) для запуска в App Engine и других средах.

В данной статье описывается использование плагина Google для Eclipse, создание нового проекта App Engine и его отладка с помощью сервера разработки с запущенным Eclipse. В статье также описывается использование плагина для загрузки проекта в App Engine.

Дополнительную информацию о плагине, включая его использование с проектами Google Web Toolkit, см. в Документации плагина Google для Eclipse.


Получение Eclipse

Eclipse можно получить с веб-сайта Eclipse. "Eclipse IDE for Java EE Developers" включает все компоненты, необходимые для разработки веб-приложений.

Плагин Google для Eclipse доступен для Eclipse 3.3 (Europa) и Eclipse 3.4 (Ganymede).

Помимо плагина Google для Eclipse рекомендуется использовать плагины Web Tools Platform (WTP) для веб-разработки. См. веб-сайт Web Tools Platform. Помимо прочего, WTP предоставляет режимы редактирования для файлов JSP и HTML.

Установка плагина Google для Eclipse

Плагин Google для Eclipse можно установить с помощью функции обновления программного обеспечения Eclipse.

Для установки плагина с помощью Eclipse 3.4 (Ganymede) выполните следующее:

  1. Выберите меню Справка > Обновление программного обеспечения... Откроется окно "Обновления и надстройки программного обеспечения".
  2. Выберите вкладку Доступное программное обеспечение. Нажмите кнопку Добавить сайт.... Откроется окно "Добавление сайта". Для "Местоположение" введите местоположение установки для версии Eclipse 3.4 плагина:
    http://dl.google.com/eclipse/plugin/3.4
    Нажмите ОК. Закроется диалоговое окно; новое местоположение будет добавлено к списку доступного программного обеспечения.
  3. Щелкните треугольник рядом с новым местоположением установки, затем щелкните треугольник рядом с "Google", чтобы отобразить варианты установки. Установите флажки для "Плагин Google для Eclipse 3.4" и "SDK Java Google App Engine". Также можно выбрать "SDK Google Web Toolkit", если необходимо использовать Google Web Toolkit с приложениями. Нажмите кнопку Установить.... Следуйте указаниям, чтобы принять условия предоставления услуг и установить плагин.

    Примечание. Процесс установки плагина может занять несколько минут, поскольку Eclipse обновляет зависимости Дополнительную информацию можно найти в разделе Часто задаваемые вопросы.

  4. По завершении установки появится запрос на перезапуск. Нажмите кнопку Да. Eclipse перезапустится. Плагин установлен.

Процесс установки плагина для Eclipse 3.3 (Europa) аналогичен за исключением других указаний и местоположения установки. Местоположение плагина Google для Eclipse 3.3:

  • http://dl.google.com/eclipse/plugin/3.3

Дополнительную информацию о функции обновления программного обеспечения см. в документации Eclipse.

Создание проекта

Чтобы создать новый проект App Engine, выполните следующее:

  1. Выберите меню Файл > Создать > Проект веб-приложения. (Если этот пункт меню отсутствует, выберите меню Окно > Сброс представления..., нажмите ОК, затем снова откройте меню Файл.) Или нажмите кнопку "Новый проект веб-приложения" на панели инструментов: Кнопка
  2. Откроется мастер "Создание проекта веб-приложения". Для "Имя проекта" введите имя проекта, такое как Guestbook для проекта, описанного в Руководстве по началу работы. Для "Пакет" введите соответствующее имя пакета, такое как guestbook.
  3. Если Google Web Toolkit не используется, снимите флажок "Использовать Google Web Toolkit". Убедитесь, что флажок "Использовать Google App Engine" не установлен.
  4. Если SDK App Engine был установлен с помощью функции обновления программного обеспечения, плагин уже настроен на использование установленных SDK. Если необходимо использовать отдельную установку SDK App Engine, нажмите на Настроить SDK... и следуйте указаниям для добавления конфигурации к папке appengine-java-sdk/ SDK.
  5. Нажмите кнопку Готово, чтобы создать проект.

Мастер создает структуру каталогов для проекта, включая каталог src/ для исходных файлов Java и каталог war/ для скомпилированных классов и других файлов для приложения, библиотек, файлов конфигурации, статических файлов, таких как изображения и CSS, и других файлов данных. Мастер также создает исходный файл сервлета и два файла конфигурации. Полная структура каталогов выглядит следующим образом:

Guestbook/
  src/
    guestbook/
      server/
        GuestbookServlet.java
    META-INF/
      jdoconfig.xml
    log4j.properties
    logging.properties
  war/
    WEB-INF/
      lib/
        ...App Engine JARs...
      appengine-web.xml
      web.xml
    index.html

Каталог war/ использует стандартный макет WAR для пакетов веб-приложений. (Архивные файлы WAR пока не поддерживаются SDK.) Плагин Eclipse использует этот каталог для запуска сервера разработки и развертывания приложения в App Engine.

Когда Eclipse создает проект, он создает каталог classes/ в war/WEB-INF/ и размещает в него скомпилированные файлы класса. Eclipse также копирует неисходные из каталога src/ в war/WEB-INF/classes/, включая файлы META-INF/, log4j.properties и logging.properties. Итоговое содержимое каталога war/ образует приложение для тестирования и развертывания.

Дополнительную информацию о новом проекте, создаваемом плагином, см. в Руководстве по началу работы.

Запуск проекта

SDK App Engine включает веб-сервер для тестирования приложения в имитируемой среде. Плагин Google для Eclipse добавляет новые элементы к меню Выполнение для запуска этого сервера.

Для запуска приложения на веб-сервере в отладчике Eclipse выберите меню Выполнение, Отладить как > Веб-приложение. Eclipse создает проект, переключается на представление "Отладка", после чего запускается сервер. При успешном запуске сервера отображается несколько сообщений, включая следующее сообщение в консоли:

The server is running at http://localhost:8080/

При необходимости настройки способа запуска сервера можно создать новую конфигурацию "Выполнение/отладка" типа "Веб-приложение".

Для тестирования нового приложения, созданного плагином, запустите сервер, как указано выше, затем откройте следующий URL в браузере (используя путь URL для вашего приложения):

Eclipse позволяет оставить сервер работающим в отладчике при внесении изменений в исходный код, файлы JSP, статические файлы и appengine-web.xml. При сохранении изменений исходного кода Eclipse автоматически компилирует класс, затем пытается динамически вставить его в запущенный веб-сервер. В большинстве случаев для тестирования новой версии кода можно просто перезагрузить страницу в обозревателе. Изменения в файлах JSP, статических файлах и appengine-web.xml автоматически распознаются сервером разработки и вступают в силу без перезапуска сервера. При изменении web.xml или других файлов конфигурации необходимо остановить, затем снова запустить сервер, чтобы изменения вступили в силу.

Для остановки сервера убедитесь, что выбрана панель Отладка, затем нажмите кнопку "Завершить": Кнопка завершения Eclipse.

Загрузка в Google App Engine

Плагин Google для Eclipse добавляет несколько кнопок к панели инструментов Eclipse. Кнопка развертывания App Engine загружает приложения в App Engine: Кнопка развертывания App Engine.

Перед первой загрузкой приложения необходимо зарегистрировать идентификатор приложения с App Engine с помощью консоли администрирования. Зарегистрируйте идентификатор приложения, затем отредактируйте файл appengine-web.xml и измените элемент <application>...</application>, чтобы в нем содержался новый идентификатор.

При нажатии кнопки развертывания App Engine Eclipse запрашивает имя пользователя (адрес электронной почты) и пароль аккаунта администратора. Введите данные аккаунта и нажмите кнопку Добавление, чтобы выполнить добавление. Eclipse получает идентификатор приложения и сведения о версии из файла appengine-web.xml, а затем загружает содержимое каталога war/.

Протестируйте приложение в App Engine, посетив его URL:

  • http://<your application ID>.appspot.com/guestbook

Запуск средств командной строки

Некоторые функции средств SDK Java App Engine доступны только при запуске этих средств непосредственно из командной строки. Если SDK установлен с помощью Eclipse, можно запустить эти средства из каталога установки плагина Eclipse.

SDK расположен в каталоге установки Eclipse в подкаталоге plugins/com.google.appengine.eclipse.sdkbundle_VERSION/, где VERSION – это идентификатор версии для SDK. В этом каталоге находится подкаталог appengine-java-sdk/bin/, содержащий средства.

Примечание. При использовании Mac OS X или Linux перед запуском командных файлов им необходимо предоставить разрешения на выполнение. Например, чтобы предоставить appcfg.sh разрешение на выполнение, введите следующую команду в каталоге appengine-java-sdk/bin/: chmod u+x appcfg.sh

Дополнительную информацию о функциях, доступных только из командной строки, см. в статье Загрузка и управление.