corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

Импорт проектов Eclipse в среду IDE NetBeans

Содержание

Содержимое данной страницы применимо к среде IDE NetBeans 6.9 и более поздним версиям

Для работы с этим учебным курсом требуется следующее программное обеспечение и материалы.

Программное обеспечение или материал Требуемая версия
Среда IDE NetBeans Версия 6.9 или более поздняя
Комплект для разработчика на языке Java (JDK) Версия 6 или 7

Мастер импорта проектов Eclipse

В среде IDE NetBeans доступна расширенная поддержка проектов Eclipse. Мастер импорта проектов Eclipse позволяет использовать NetBeans для работы над проектами настольных и веб-приложений Java, которые были созданы в Eclipse и MyEclipse.

После создания проекта NetBeans на основе проекта Eclipse можно продолжить работу следующим образом:

  • Использовать среду NetBeans при работе с групповым проектом, в то время как другие разработчики используют среду Eclipse.
  • Использовать NetBeans и Eclipse при работе с проектом как взаимозаменяемые среды.
  • Протестировать работу в среде NetBeans на существующем проекте, настройка которого была выполнена в среде Eclipse.

В начало

Принципы работы мастера импорта

При импорте проекта в среде IDE выполняется анализ метаданных проекта Eclipse. Далее на основе этих метаданных создается проект NetBeans. При импорте структура проекта Eclipse не изменяется. Таким образом, это не влияет на работу проекта в среде Eclipse.

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

В начало

Импорт и настройка проектов

Импорт проекта Eclipse в среду NetBeans:

  1. Убедитесь, что создана копия проекта, который требуется импортировать в систему.

    Как правило, этот проект уже находится в рабочей области Eclipse.

  2. Выберите "File > Import Project > Eclipse Project".
  3. На странице "Workspace Location" мастера импорта установите кнопку-переключатель "Workspace" в положение "Import Projects", а затем укажите местоположение рабочей области. На рисунке показана страница "Workspace Location" мастера импорта проектов Eclipse с установленной кнопкой-переключателем "Workspace" в положение "Import Projects" и указанным местоположением рабочей области Eclipse.
  4. На странице "Projects to Import" выберите проекты для импорта. Затем выберите один из двух вариантов сохранения файлов проекта NetBeans:
    • Сохранение данных проекта NetBeans в папках проекта Eclipse. В среде NetBeans папки и файлы добавляются в папку верхнего уровня исходного проекта.
    • Создание импортированных проектов NetBeans в отдельном местоположении. В среде NetBeans используются исходные файлы и библиотеки из исходной папки проекта Eclipse, но при этом создается отдельная папка для сохранения метаданных проекта NetBeans и выходных файлов сборки.

    Рекомендуется сохранять данные проекта NetBeans в папках проекта Eclipse. В большинстве случаев это означает, что метаданные проекта NetBeans ссылаются на исходные файлы и библиотеки, пути к которым соответствуют путям к метаданным Eclipse. Поэтому результатом взятия проекта для изменения из системы контроля версий на различных компьютерах должно являться аналогичное поведение проекта как в среде NetBeans, так и в среде Eclipse.

    Список файлов и папок, создаваемых NetBeans, приводится в разделе Файлы проекта NetBeans.

  5. На странице "Servers" зарегистрируйте все серверы, необходимые для работы с проектами в среде IDE NetBeans. (Эта страница отображается только при импорте веб-приложений.)

После завершения работы мастера могут появиться следующие диалоговые окна:

  • Диалоговое окно "Import Issues". В этом диалоговом окне содержится информация о расхождениях между структурой проекта в среде Eclipse и в среде NetBeans с указанием действий, которые могут потребоваться для устранения этих расхождений.

    Информацию из этого диалогового окна можно скопировать и сохранить для использования в будущем.

    В большинстве случаев для разрешения подобных проблем используется диалоговое окно "Project Properties". Указания по разрешению наиболее распространенных проблем представлены в разделе Разрешение проблем при импорте.

  • Диалоговое окно "Resolve Reference Problems". В этом диалоговом окне содержится предупреждение об определенной проблеме со ссылками в одной из библиотек проекта. Перейти к разрешению этой проблемы можно после закрытия этого диалогового окна. Щелкните правой кнопкой мыши узел проекта, а затем выберите "Resolve Reference Problems".
  • Диалоговое окно "Resolve Missing Server". В этом диалоговом окне содержится предупреждение о том, что для проекта не удается найти требуемый сервер. Перейти к разрешению этой проблемы можно после закрытия этого диалогового окна. Щелкните правой кнопкой мыши узел проекта, а затем выберите "Resolve Missing Server".
На рисунке показано диалоговое окно "Import Issues".

После завершения работы мастера и закрытия всех указных выше информационных диалоговых окон в окне "Projects" появятся узлы проектов.

На рисунке показано окно "Projects" после импорта проекта, которое включает узел проекта и подузлы веб-страниц, ресурсы сервера, файлы настройки, файлы с расширением .src и библиотеки.

Если в метаданных проекта содержатся ссылки на серверы или другие ресурсы, которые среда NetBeans не может разрешить, то узел проекта выделяется красным цветом. Для незамедлительного разрешения этих ссылок щелкните правой кнопкой мыши узел проекта и выберите "Resolve Reference Problems" или "Resolve Missing Server".

На рисунке показано диалоговое окно "Resolve References" после импорта проекта.

Для других вариантов разрешения настроек проекта используется диалоговое окно "Project Properties". Для вызова диалогового окна "Project Properties" щелкните правой кнопкой мыши узел проекта и выберите "Properties".

Для получения дополнительных сведений о настройке проектов см. раздел Настройка пути к классам и других параметров проекта в руководстве "Создание, импорт и настройка проектов Java".

В начало

Сборка и запуск проекта

После импорта проекта в среду NetBeans можно выполнить его сборку и запуск. Все результаты предыдущей сборки проекта с помощью команд сборки и выполнения NetBeans сохраняются в папках build и dist. В среде NetBeans выходной файл, созданный на основе действий сборки в среде Eclipse, не перезаписывается. Если проект Eclipse уже имеет папки build и dist, проект NetBeans создает папки с именами nbbuild и nbdist и использует их для выходных файлов сборки.

Далее приводятся некоторые команды сборки и выполнения, доступные в меню "Run":

  • Команда "Run Project" используется для запуска приложения в среде IDE в тестовом режиме.
  • Команда "Clean and Build Project" используется для удаления содержимого папок build (или nbbuild) и dist (или nbdist) с повторной сборкой всех выходных файлов проекта. Данная команда использует сценарий сборки NetBeans. Ее действие аналогично команде "Clean" в среде Eclipse.
  • Команда "Clean" используется для удаления содержимого папок nbbuild и nbdist.
  • Команда "Build" используется для повторной сборки выходных файлов проекта. Если включена функция "Compile on Save", команда "Build" не используется. См. раздел Компиляция при сохранении в руководстве "Создание, импорт и настройка проектов Java".

Для получения дополнительных сведений о сборке и выполнении приложения, а также о настройке процесса сборки см. руководство Создание, импорт и настройка проектов Java.

В начало

Файлы проекта NetBeans

После импорта проекта в системе появятся следующие папки и файлы:

  • build.xml файл или файл nb-build.xml. Основной сценарий сборки NetBeans для проекта. Этот сценарий можно настроить в соответствии с требованиями к проекту. По умолчанию этот файл называется build.xml. Если такой файл уже существует в папке проекта, соответствующему сценарию будет дано имя nb-build.xml.
  • Папка nbproject. Содержит большую часть метаданных проекта NetBeans, включая ресурсы, вызываемые основным сценарием сборки NetBeans. После регистрации этой папки и файла build.xml или nb-build.xml в системе контроля версий другие пользователи смогут открыть проект в среде NetBeans. Эта папка также содержит папку private с данными, специфичными для используемой системы. Регистрация этой папки в системе контроля версий не требуется, поскольку ее содержимое может быть различным в зависимости от пользователя. См. раздел Рекомендации по контролю версий ниже.
  • Папка nbbuild. При сборке или выполнении проекта в среде NetBeans исходные файлы проекта компилируются в эту папку.
  • Папка nbdist. При сборке проекта в среде NetBeans создаются распространяемые (дистрибутивные) выходные файлы, которые помещаются в эту папку. Такие выходные файлы могут иметь расширения .JAR и .WAR.

В начало

Рекомендации по управлению версиями

Если проверка проекта выполняется вне системы контроля версий, папки build (или nbbuild), dist (или nbdist) и nbproject/private проверять в системе контроля версий не требуется.

Если управление проектом осуществляется в системах контроля версий CVS, Subversion или Mercurial, при импорте проекта создаются или обновляются соответствующие файлы "ignore" для этих каталогов.

Несмотря на то, что папка nbproject/private игнорируется, требуется регистрация nbproject в системе контроля версий. Папка nbproject содержит метаданные проекта, что позволяет другим пользователям открывать проект в среде NetBeans без необходимости его предварительного импорта.

В начало

Повторная синхронизация проекта

Мастер импорта проектов предоставляет возможности их повторной синхронизации. При изменении пути к классам в среде Eclipse после импорта с помощью функции "Resynchronize Eclipse Projects" можно обновить путь к классам в соответствующем проекте NetBeans.

Повторная синхронизация проекта выполняется в одностороннем порядке от проектов Eclipse к проектам NetBeans. Функция повторной синхронизации не позволяет активировать для проекта Eclipse изменения структуры проекта, внесенные в среде NetBeans. Если планируется сохранить оба проекта, Eclipse и NetBeans, используйте проект Eclipse в качестве "ведущего" проекта.

В среде IDE возможна автоматическая повторная синхронизация проектов в том случае, если изменения настройки Eclipse являются однозначными и не требуют ввода данных. Автоматическая повторная синхронизация выполняется вскоре после открытия проекта. Если для повторной синхронизации требуется ввод данных, необходимо выполнить эту операцию вручную.

Повторная синхронизация проектов NetBeans с проектами Eclipse вручную:

  • Выберите "File > Import Project > Resynchronize Eclipse Projects".

Примечание: Повторная синхронизация выполняется для всех проектов, импортированных из рабочей области.

В начало

Разрешение проблем при импорте

При импорте проекта в среду NetBeans могут возникнуть проблемы, которые невозможно разрешить автоматически в среде IDE NetBeans. Для разрешения некоторых из этих проблем в контекстном меню проекта можно выбрать соответствующий пункт меню, например, "Resolve Missing Server Problem". Другие проблемы можно разрешить с помощью диалогового окна "Project Properties" для импортированного проекта в среде IDE NetBeans.

Далее приводится список распространенных проблем при импорте с соответствующими решениями.

Сообщение о проблеме Решение
Resolve Missing Server Problem (проблема отсутствия сервера) Щелкните правой кнопкой мыши узел проекта и выберите "Resolve Missing Server Problem". Затем перейдите к файлу или папке, содержащей данные сервера.
Resolve Reference Problem (проблема ссылок) Щелкните правой кнопкой мыши узел проекта и выберите "Resolve Reference Problem". Затем перейдите к файлу или папке, содержащей ресурс, на который имеется ссылка в проекте.
Eclipse platform for project ИмяПроекта cannot be used. It is a JRE and the NetBeans project requires a JDK. NetBeans will use the default platform. (Невозможно использовать платформу Eclipse для проекта. Это платформа JRE, а для проекта NetBeans требуется платформа JDK. В среде NetBeans будет использоваться платформа по умолчанию.) Если требуется изменить платформу, используемую в NetBeans для проекта, выберите "Tools > Platforms" и укажите другую платформу.
Eclipse project ИмяПроекта claims to use JDK from the "{1}" directory. But this directory does not exist. NetBeans will use the default platform. (Для проекта Eclipse необходимо использовать JDK из каталога "{1}". Однако этот каталог не существует. В среде NetBeans будет использоваться платформа по умолчанию.) Если требуется изменить платформу, используемую в NetBeans для проекта, выберите "Tools > Platforms" и укажите другую платформу.
NetBeans does not support source includes/excludes per source root as Eclipse does. They were merged and it is recommended that you double check them in project's properties in Source panel. (В отличие от Eclipse, в среде NetBeans не поддерживается включение/исключение исходных файлов для корня исходных файлов. Поскольку они были объединены, рекомендуется дважды проверить их в свойствах проекта на панели режима просмотра исходного кода.) В среде NetBeans включения и исключения должны быть объявлены в одном месте для всего проекта. Для проверки включений и исключений в проекте NetBeans щелкните правой кнопкой мыши узел проекта в окне "Projects" и выберите "Properties". В диалоговом окне "Project Properties" выберите закладку "Sources", а затем нажмите кнопку "Includes/Excludes".
Import failed due to .... More details can be found in IDE's log file. (Ошибка импорта в результате (...). Для получения более подробной информации см. файл регистрации IDE.) Для открытия файла журнала среды IDE выберите "View > IDE Log".
Unknown project type – it cannot be imported. (Неизвестный тип проекта – импорт невозможен). Можно импортировать только следующие типы проектов Eclipse: Java Project, Java Project from Existing Ant File, Static Web, Dynamic Web и JPA Project.

В начало


Дополнительная информация

В начало