| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> |
| <html> |
| <!-- Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. --> |
| <!-- Use is subject to license terms.--> |
| <head> |
| <title>Импорт проектов Eclipse в IDE NetBeans - учебное руководство</title> |
| <meta name="KEYWORDS" content="NETBEANS, TUTORIAL, GUIDE, USER, DOCUMENTATION"> |
| <meta name="description" |
| content="Overview of Eclipse Import features in NetBeans IDE"> |
| <link rel="stylesheet" href="../../../netbeans.css"> |
| |
| <meta HTTP-EQUIV="Content-Type" Content="text/html; charset=UTF-8"></head> |
| <body> |
| <a name="top"></a> |
| <h1>Импорт проектов Eclipse в IDE NetBeans</h1> |
| |
| <p><b>Содержание</b></p> |
| <img alt="Содержимое на этой странице применимо к IDE NetBeans 6.9, 7.0, 7.1, 7.2, 7.3 и 7.4" class="stamp" src="../../../images_www/articles/72/netbeans-stamp-74-73-72.png" title="Содержимое на этой странице применимо к IDE NetBeans 6.9, 7.0, 7.1, 7.2, 7.3 и 7.4"> |
| <ul class="toc"> |
| <li><a href="#intro" title="Мастер импорта проектов Eclipse">Мастер импорта проектов Eclipse</a></li> |
| <li><a href="#how-it-works" title="Принципы работы мастера импорта">Принципы работы мастера импорта</a></li> |
| <li><a href="#import" title="Импорт и настройка проектов">Импорт и настройка проектов</a></li> |
| <li><a href="#build" title="Сборка и запуск проекта">Сборка и запуск проекта</a></li> |
| <li><a href="#metadata" title="Файлы проекта NetBeans">Файлы проекта NetBeans</a></li> |
| <li><a href="#versioning" title="Рекомендации по управлению версиями">Рекомендации по управлению версиями</a></li> |
| <li><a href="#resynch" title="Повторная синхронизация проекта">Повторная синхронизация проекта</a></li> |
| <li><a href="#problems" title="Разрешение проблем при импорте">Разрешение проблем при импорте</a></li> |
| <li><a href="#nextsteps" title="См. также">См. также</a></li> |
| </ul> |
| <p><b>Для работы с этим учебным курсом требуются программное обеспечение и ресурсы, перечисленные ниже.</b></p> |
| |
| <table> |
| <tbody> |
| <tr> |
| <th class="tblheader" scope="col">Программное обеспечение или материал</th> |
| <th class="tblheader" scope="col">Требуемая версия</th> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.netbeans.org/downloads/index.html">IDE NetBeans</a></td> |
| <td class="tbltd1">версия 6.9, 7.0, 7.1, 7.2, 7.3 или 7.4 </td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Комплект для разработчика на языке Java (JDK)</a></td> |
| <td class="tbltd1">версия 6 или 7</td> |
| </tr> |
| </tbody> |
| </table> |
| <a name="intro"></a><h2>Мастер импорта проектов Eclipse</h2> |
| <p>В IDE NetBeans доступна усовершенствованная поддержка импорта проектов Eclipse. Мастер импорта проектов Eclipse позволяет использовать NetBeans для работы над проектами настольных и веб-приложений Java, которые были созданы в Eclipse и MyEclipse.</p> |
| |
| <p>После создания проекта NetBeans на основе проекта Eclipse можно продолжить работу следующим образом:</p> |
| <ul> |
| <li>Использовать среду NetBeans при работе с групповым проектом, в то время как другие разработчики используют среду Eclipse. |
| </li> |
| <li>Использовать NetBeans и Eclipse при работе с проектом как взаимозаменяемые среды. |
| </li> |
| <li>Протестировать работу в среде NetBeans на существующем проекте, настройка которого была выполнена в среде Eclipse. </li> |
| </ul> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| <a name="how-it-works"></a><h2>Принципы работы мастера импорта</h2> |
| <p>При импорте проекта в среде IDE выполняется анализ метаданных проекта Eclipse. Далее на основе этих метаданных создается проект NetBeans. При импорте структура проекта Eclipse не изменяется. Таким образом, это не влияет на работу проекта в среде Eclipse.</p> |
| <p>После импорта проекта для его изменения, сборки, выполнения, отладки и профилирования можно использовать среду NetBeans и/или Eclipse. При внесении изменений в настройку проекта Eclipse можно повторно синхронизировать проект NetBeans. Это позволяет работать с проектами в среде NetBeans даже в том случае, если все остальные члены группы работают в среде Eclipse. Путь для сборки, настроенный в Eclipse, используется как основной путь для сборки в данном проекте.</p> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| <h2><a name="import"></a>Импорт и настройка проектов</h2> |
| |
| <p><b>Импорт проекта Eclipse в IDE:</b></p> |
| <ol> |
| <li>Убедитесь, что создана копия проекта, который требуется импортировать в систему. |
| <p>Как правило, этот проект уже находится в рабочей области Eclipse.</p></li> |
| <li>Выберите "File > Import Project > Eclipse Project".</li> |
| <li>На странице 'Местоположение рабочей области' выберите параметр 'Импорт проектов из рабочей области' и укажите местоположение рабочей области. Нажмите 'Далее'. |
| |
| <p class="align-center"><a href="../../../images_www/articles/71/java/import-eclipse/eclipse-import-workspace-location.png" rel="lytebox" title="Страница 'Местоположение рабочей области' мастера импорта проектов Eclipse - Нажмите, чтобы увеличить"> <img alt="Страница 'Местоположение рабочей области' мастера импорта проектов Eclipse " border="1" src="../../../images_www/articles/71/java/import-eclipse/eclipse-import-workspace-location-small.png"></a></p></li> |
| |
| <li>На странице "Projects to Import" выберите проекты для импорта. </li> |
| <li> Выберите один из двух вариантов сохранения файлов проекта NetBeans: |
| <ul> |
| <li><b>Рекомендуется сохранять данные проекта NetBeans в папках проекта Eclipse. </b> NetBeans добавляет папки и файлы в папку верхнего уровня первоначального проекта.</li> |
| <li><b>Создайте импортированные проекты NetBeans в отдельном месте.</b> NetBeans использует исходные файлы и библиотеки в исходной папке проекта Eclipse, но создает отдельную папку для хранения метаданных проекта NetBeans и создания выходных данных.</li> |
| </ul> |
| <p class="notes"><b>Примечание.</b> Как правило, рекомендуется сохранять данные проекта NetBeans в папках проекта Eclipse. В большинстве случаев это означает, что метаданные проекта NetBeans ссылаются на исходные файлы и библиотеки, пути к которым соответствуют путям к метаданным Eclipse. Поэтому результатом взятия проекта для изменения из системы контроля версий на различных компьютерах должно являться аналогичное поведение проекта как в среде NetBeans, так и в среде Eclipse.<br>Список файлов и папок, создаваемых IDE NetBeans, см. в разделе <a href="#metadata">Файлы проекта NetBeans</a>.</p> |
| </li> |
| <li>(Применимо только при импорте веб-приложений.) Нажмите 'Далее'. На странице 'Серверы' зарегистрируйте все серверы, которые требуются для работы с проектами в IDE NetBeans.</li> |
| <li>Нажмите 'Готово'.</li> |
| </ol> |
| |
| <p>После завершения работы мастера могут появиться следующие диалоговые окна:</p> |
| <ul> |
| <li><b>Проблемы с импортом.</b> Это диалоговое окно содержит информацию о несоответствиях между структурой проекта в Eclipse и NetBeans, и указывает действия, которые, возможно, потребуется выполнить для устранения несоответствий. <br>Информацию из этого диалогового окна можно скопировать и сохранить для использования в будущем. <br>В большинстве случаев для разрешения подобных проблем используется диалоговое окно "Project Properties". Указания по разрешению наиболее распространенных проблем представлены в разделе <a href="#problems">Разрешение проблем при импорте</a>. |
| <p class="align-center"><a href="../../../images_www/articles/71/java/import-eclipse/eclipse-import-issues.png" rel="lytebox" title="Диалоговое окно 'Проблемы импорта' - Нажмите, чтобы увеличить"> <img alt="Диалоговое окно 'Проблемы импорта'" border="1" src="../../../images_www/articles/71/java/import-eclipse/eclipse-import-issues-small.png"></a></p> |
| |
| </li> |
| <li><b>Разрешение проблемы ссылок.</b> Это диалоговое окно содержит предупреждение о конкретной проблеме с ссылкой в одной из библиотек проекта. Для решения этой проблемы после закрытия диалогового окна щелкните правой кнопкой мыши узел проекта и выберите 'Разрешить проблемы с ссылками'.</li> |
| <li><b>Разрешение проблемы отсутствующих серверов.</b> Это диалоговое окно содержит предупреждение о том, что в конкретном проекте не удается найти необхдимый сервер. Для решения этой проблемы после закрытия диалогового окна щелкните правой кнопкой мыши узел проекта и выберите 'Разрешить проблемы отсутствия серверов'.</li> |
| </ul> |
| <p>После завершения работы мастера и закрытия всех указных выше информационных диалоговых окон в окне "Projects" появятся узлы проектов. |
| </p> |
| |
| <p class="align-center"><img alt="Окно 'Проекты' после импорта проекта." class="margin-around" src="../../../images_www/articles/71/java/import-eclipse/eclipse-import-projects-window.png"></p> |
| |
| <p>Если в метаданных проекта содержатся ссылки на серверы или другие ресурсы, которые среда NetBeans не может разрешить, то узел проекта выделяется красным цветом. Для мгновенного решения проблемы с ссылками щелкните правой кнопкой мыши узел проекта и выберите 'Разрешить проблему с ссылками' или 'Разрешить проблемы отсутствия серверов'.</p> |
| |
| <p>Для других вариантов разрешения настроек проекта используется диалоговое окно "Project Properties". Для открытия диалогового окна 'Свойства проекта' щелкните правой кнопкой мыши узел проекта и выберите 'Свойства'.</p> |
| <p>Для получения дополнительных сведений о настройке проектов см. раздел <a href="project-setup.html#projects-configuring">Настройка пути к классам и других параметров проекта</a> в руководстве "Создание, импорт и настройка проектов Java".</p> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| <h2><a name="build"></a>Сборка и запуск проекта</h2> |
| |
| <p>После импорта проекта в среду NetBeans можно выполнить его сборку и запуск. Все результаты предыдущей сборки проекта с помощью команд сборки и выполнения NetBeans сохраняются в папках <code>build</code> и <code>dist</code>. NetBeans не перезаписывает результат сборки Eclipse. Если проект Eclipse уже имеет папки <code>build</code> и <code>dist</code>, проект NetBeans создает папки с именами <code>nbbuild</code> и <code>nbdist</code> и использует их для выходных файлов сборки.</p> |
| <p>Далее приводятся некоторые команды сборки и выполнения, доступные в меню "Run":</p> |
| <ul> |
| <li><b>Выполнить проект.</b> Тест запускает приложение в IDE.</li> |
| <li><b>Очистка и сборка проекта.</b> Удаляет содержимое папок <code>build</code> (или <code>nbbuild</code>) и <code>dist</code> (или <code>nbdist</code>) и повторно создает все выходные данные проекта. Данная команда использует сценарий сборки NetBeans. Ее действие аналогично команде "Clean" в среде Eclipse.</li> |
| <li><b>Очистка.</b> Удаляет содержимое папок <code>nbbuild</code> и <code>nbdist</code>.</li> |
| <li><b>Сборка.</b> Повторно создаются выходные данные проектов. Если включена функция "Compile on Save", команда "Build" не используется. См. раздел <a href="project-setup.html#building-compile-on-save">Компиляция при сохранении</a> в руководстве "Создание, импорт и настройка проектов Java".</li> |
| </ul> |
| |
| <p>Для получения дополнительных сведений о сборке и выполнении приложения, а также о настройке процесса сборки см. руководство <a href="project-setup.html">Создание, импорт и настройка проектов Java</a>. |
| </p> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| <h2><a name="metadata"></a>Файлы проекта NetBeans</h2> |
| |
| <p>После импорта проекта в системе появятся следующие папки и файлы:</p> |
| <ul> |
| <li><code>build.xml</code> файл или файл <code>nb-build.xml</code>. Основной сценарий сборки NetBeans для проекта. Этот сценарий можно настроить в соответствии с требованиями к проекту. По умолчанию этот файл называется <code>build.xml</code>. Если такой файл уже существует в папке проекта, соответствующему сценарию будет дано имя <code>nb-build.xml</code>.</li> |
| <li>Папка <code>nbproject</code>. Содержит большую часть метаданных проекта NetBeans, включая ресурсы, вызываемые основным сценарием сборки NetBeans. После регистрации этой папки и файла <code>build.xml</code> или <code>nb-build.xml</code> в системе контроля версий другие пользователи смогут открыть проект в среде NetBeans. Эта папка также содержит папку <code>private</code> с данными, специфичными для используемой системы. Регистрация этой папки в системе контроля версий не требуется, поскольку ее содержимое может быть различным в зависимости от пользователя. См. раздел <a href="#versioning">Рекомендации по контролю версий</a> ниже.</li> |
| <li>Папка <code>nbbuild</code>. При сборке или выполнении проекта в среде NetBeans исходные файлы проекта компилируются в эту папку.</li> |
| <li>Папка <code>nbdist</code>. При сборке проекта в среде NetBeans создаются распространяемые (дистрибутивные) выходные файлы, которые помещаются в эту папку. Такие выходные файлы могут иметь расширения .JAR и .WAR.</li> |
| </ul> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| <a name="versioning"></a><h2>Рекомендации по управлению версиями</h2> |
| <p>Если проверка проекта выполняется вне системы контроля версий, папки <code>build</code> (или <code>nbbuild</code>), <code>dist</code> (или <code>nbdist</code>) и <code>nbproject/private</code> проверять в системе контроля версий не требуется. </p> |
| <p>Если управление проектом осуществляется в системах контроля версий CVS, Subversion или Mercurial, при импорте проекта создаются или обновляются соответствующие файлы "ignore" для этих каталогов.</p> |
| <p class="notes">Несмотря на то, что папка <code>nbproject/private</code> игнорируется, требуется регистрация <code>nbproject</code> в системе контроля версий. Папка <code>nbproject</code> содержит метаданные проекта, что позволяет другим пользователям открывать проект в среде NetBeans без необходимости его предварительного импорта.</p> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| |
| <h2><a name="resynch"></a>Повторная синхронизация проекта</h2> |
| |
| <p>Мастер импорта проектов предоставляет возможности их повторной синхронизации. При изменении пути к классам в среде Eclipse после импорта с помощью функции "Resynchronize Eclipse Projects" можно обновить путь к классам в соответствующем проекте NetBeans.</p> |
| <p>Повторная синхронизация проекта выполняется в одностороннем порядке от проектов Eclipse к проектам NetBeans. Функция повторной синхронизации не позволяет активировать для проекта Eclipse изменения структуры проекта, внесенные в среде NetBeans. Если планируется сохранить оба проекта, Eclipse и NetBeans, используйте проект Eclipse в качестве "ведущего" проекта.</p> |
| <p>В среде IDE возможна автоматическая повторная синхронизация проектов в том случае, если изменения настройки Eclipse являются однозначными и не требуют ввода данных. Автоматическая повторная синхронизация выполняется вскоре после открытия проекта. Если для повторной синхронизации требуется ввод данных, необходимо выполнить эту операцию вручную.</p> |
| |
| <!-- TODO add information on what gets synchronized--> |
| <p><b>Повторная синхронизация проектов NetBeans с проектами Eclipse вручную:</b></p> |
| <ul> |
| <li>Выберите "File > Import Project > Resynchronize Eclipse Projects".</li> |
| </ul> |
| <p class="notes"><b>Примечание:</b> Повторная синхронизация выполняется для всех проектов, импортированных из рабочей области.</p> |
| |
| <p class="align-center"><a href="#top">В начало</a></p> |
| <h2><a name="problems"></a>Разрешение проблем при импорте</h2> |
| |
| <p>При импорте проекта в NetBeans могут возникать проблемы, которые не могут быть автоматически разрешены в IDE NetBeans. Для разрешения некоторых из этих проблем в контекстном меню проекта можно выбрать соответствующий пункт меню, например, "Resolve Missing Server Problem". Другие проблемы могут быть разрешены в диалоговом окне 'Свойства проекта' импортированного проекта в IDE NetBeans. |
| </p> |
| <p>Далее приводится список распространенных проблем при импорте с соответствующими решениями.</p> |
| |
| <table> |
| <tr> |
| <th class="tblheader" scope="col">Сообщение о проблеме</th> |
| <th class="tblheader" scope="col">Решение</th> |
| </tr> |
| <tr> |
| <td class="tbltd1">Resolve Missing Server Problem (проблема отсутствия сервера)</td> |
| <td class="tbltd1">Щелкните правой кнопкой мыши узел проекта и выберите "Resolve Missing Server Problem". Затем перейдите к файлу или папке, содержащей данные сервера.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Resolve Reference Problem (проблема ссылок)</td> |
| <td class="tbltd1">Щелкните правой кнопкой мыши узел проекта и выберите "Resolve Reference Problem". Затем перейдите к файлу или папке, содержащей ресурс, на который имеется ссылка в проекте.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Платформу Eclipse для проекта <i>ProjectName</i> нельзя исопльзовать. Это JRE, а для проекта NetBeans требуется JDK. В NetBeans будет использоваться платформа по умолчанию. |
| </td> |
| <td class="tbltd1">Если требуется изменить платформу, используемую в NetBeans для проекта, выберите "Tools > Platforms" и укажите другую платформу.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Предполагается, что в проекте Eclipse <i>ProjectName</i> используется JDK из каталога "{1}". Но этот каталог не существует. В NetBeans будет использоваться платформа по умолчанию. |
| </td> |
| <td class="tbltd1">Если требуется изменить платформу, используемую в NetBeans для проекта, выберите "Tools > Platforms" и укажите другую платформу.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">NetBeans не поддерживает включения и исключения для каждого корневого источника, в отличие от платформы Eclipse. Они были объединены, и рекомендуется дважды проверить их в свойствах проекта на панели 'Источник'. |
| </td> |
| <td class="tbltd1">В среде NetBeans включения и исключения должны быть объявлены в одном месте для всего проекта. Для проверки включенных и исключенных элементов в проекте NetBeans щелкните правой кнопкой мыши узел проекта и окно 'Проекты' и выберите'Свойства'. В диалоговом окне "Project Properties" выберите закладку "Sources", а затем нажмите кнопку "Includes/Excludes".</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Import failed due to <i>...</i>. More details can be found in IDE's log file. (Ошибка импорта в результате (...). Для получения более подробной информации см. файл регистрации IDE.)</td> |
| <td class="tbltd1">Для открытия файла журнала среды IDE выберите "View > IDE Log".</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Unknown project type – it cannot be imported. (Неизвестный тип проекта – импорт невозможен).</td> |
| <td class="tbltd1">Можно импортировать только следующие типы проектов Eclipse: Java Project, Java Project from Existing Ant File, Static Web, Dynamic Web и JPA Project.</td> |
| </tr> |
| </table> |
| <!-- TODO link to a wiki with other troubleshooting info--> |
| |
| <!-- ======================================================================================= --> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| <div class="feedback-box" ><a href="/about/contact_form.html?to=3&subject=Feedback:%20Importing%20Eclipse%20Projects%20into%20NetBeans%20IDE">Отправить отзыв по этому учебному курсу</a></div> |
| <br style="clear:both;" > |
| <h2><a name="nextsteps"></a>Дополнительные сведения</h2> |
| <ul> |
| <li><a href="http://www.oracle.com/pls/topic/lookup?ctx=nb7400&id=NBDAG445">Импорт проекта Eclipse или JBuilder</a> в документе <i>Разработка приложений в IDE NetBeans</i></li> |
| <li><a href="http://wiki.netbeans.org/NetBeansForEclipseUsers">NetBeans для пользователей Eclipse</a></li> |
| <li><a href="project-setup.html">Создание, импорт и настройка проектов Java</a></li> |
| <li><a href="../../trails/java-se.html">Учебная карта по общим сведениям о разработке на Java</a></li> |
| <li><a href="../../trails/matisse.html">Учебная карта по приложениям с графическим интерфейсом Java </a></li> |
| <li><a href="../../trails/java-ee.html">Учебная карта по Java EE и Java Web</a></li> |
| </ul> |
| <p class="align-center"><a href="#top">В начало</a></p> |
| </body> |
| </html> |
