• Официальный сайт SDK
  • Сайт с примерами кода

Настройка Eclipse под Windows для работы с Google App Engine

Эта статья была написана независимым разработчиком. Команда проекта Google App Engine благодарит Джоша Фет за его опыт и уделённое время.

Джош Фет
Июнь 2008

Введение

Так как я являюсь фанатом среды разработки Eclipse и новичком в разработке на языке Python, я посвятил некоторое время тому, чтобы найти нужное мне расширение для Eclipse и в итоге наткнулся на проект PyDev. Хотя я и знаю, что это не является сложным, мне потребовалось несколько минут, для того чтобы найти, каким образом возможно настроить совместное функционирование Google App Engine и работу автозавершения кода.

Теперь я готов поделиться небольшим руководством по прикручиванию App Engine к среде Eclipse с расширением PyDev.

Загрузка компонентов

До того, как вы начнете работу, необходимо правильно настроить окружение среды разработки. Для этого необходимо скачать и установить на ваш компьютер следующие компоненты:

  • Скачать Python и установить его.
  • Скачать Eclipse и распаковать его архив.
  • Скачать среду разработки Google App Engine SDK и установить ее.

Установка PyDev в Eclipse

Теперь когда вы имеете все необходимые компоненты, вы можете перейти к установке расширения PyDev для среды Eclipse, которое специально настроено для разработчиков Python.

  1. Откройте Eclipse и выберите в меню Help -> Software Updates -> Find and Install.
  2. Установка PyDev:
    • Выберите Search for new features to install и нажмите Next.
    • Щелкните по New remote site:
      • Введите имя "PyDev" в поле Name.
      • В поле URL скопируйте ссылку "http://pydev.sourceforge.net/updates/".
      • Нажмите OK.
    • Установите галочку на сайте PyDev, который вы только что добавили:
    • Далее нажмите Finish
    • После поиска системой сайта обновлений, выберите установку PyDev for Eclipse:
    • Нажмите Next.
    • Примите соглашение.
    • Нажмите Finish.
    • Нажмите Install All.
    • Выберите Yes для перезапуска Eclipse.
  3. После перезапуска Eclipse:
    • Выберите Windows -> Preferences для отображения диалога настроек.
    • Перейдите к разделу PyDev -> Interpreter - Python для настройки интерпретатора Python.
    • Нажмите правую верхнюю кнопку New для указания пути к интерпретатору:
    • Найдите файл "python.exe" (обычно расположен в каталоге C:Python25).
    • После задания пути к интерпретатору, расширение PyDev произведет поиск библиотек и выдаст следующий экран:
      • В общем случае PyDev правильно определит все используемые библиотеки, и можно будет нажать кнопку OK для установки пути поиска пакетов.
      • В окне Preferences нажмите кнопку OK для того, чтобы подтвердить эти изменения.

Начинаем первый проект

Теперь после установки расширения PyDev в Eclipse мы готовы начать разработку первого приложения!

  1. Давайте создадим первый проект:
    • Щелкните правой кнопкой на вкладке Package Explorer и выберите в меню New -> Other.
    • В появившемся окне выберите из раздела Pydev проект типа Pydev project.
    • Назовите новый проект "helloworld" и укажите версию интерпретатора Python 2.5 (это очень важно!):
    • После нажатия на кнопку Finish, Eclipse переключится на рабочий вид проекта.
    • Щелкните правой кнопкой по нашему новому проекту и выберите Properties.
    • В новом окне выберите раздел PyDev - PYTHONPATH для добавления в проект библиотек платформы App Engine (это требуется для нормального функционирования приложения).
    • Нажмите по кнопке Add source folder и добавьте следующие каталоги из папки с вашей инсталяцией среды разработки SDK:
    • Нажмите OK для подтверждения изменений.
  2. Теперь вы можете начать изучение платформы и перейти к Руководству для начинающих. Используйте каталог "src" в качестве корневого каталога вашего проекта:
  3. Последнее, что нам осталось сделать - определить сервер разработки в качестве загрузчика нашего проекта:
    • Выберите в меню Run -> Run.
    • Выберите раздел Python Run и добавьте новую конфигурацию (двойной щелчок или пункт New из выпадающего меню):
    • Задайте произвольное название вашей конфигурации.
    • В поле "Project" выберите свой проект.
    • В поле "Main Module" введите вручную полный путь к скрипту "dev_appserver.py".
    • Перейдите на вкладку "Arguments" и введите "${project_loc}/src" в качестве первого аргумента:

      После этого можно задать любой из доступных дополнительных параметров, которые описаны на странице документации web-сервера разработки. (Здесь мы, к примеру, изменили порт сервера, на котором он будет принимать запросы, на 9999.)
    • Нажмите на кнопку Apply для сохранения изменений.
    • Нажмите кнопку Run для запуска вашего проекта.

Теперь вы можете запускать приложение, выбрав нашу конфигурацию из пункта меню "Run" и проследовав по ссылке http://localhost:9999/. При возникновении ошибки вы увидите ее сообщения в консольном окне Eclipse и сможете одним щелчком мыши перейти к месту ее возникновения в исходных файлах:

Когда вы будете готовы разместить приложение на боевом сервере, просто передайте каталог src вашего приложения в качестве параметра программе appcfg.py.

Примечание: Возможно, вы захотите пойти еще дальше и установить в Eclipse расширение Aptana Studio, которое позволит использовать интегрированные редакторы кода HTML, CSS и JavaScript. Статья по его установке находится .