Добро пожаловать в NetBeans IDE Merak (версия 3.4.1) -
модульную, основанную на стандартах интегрированную среду разработки (IDE),
написанную на Java. NetBeans - это не просто среда. NetBeans - это:
IDE с открытыми
исходными текстами, написанная на языке программирования
JavaTM.
Платформа,
в которую при помощи дополнительных модулей
могут быть легко интегрированы другие инструментальные средства и
добавлена функциональность.
Ядро
приложений, которое можно использовать в качестве основы для написания
любого типа приложения.
Merak - это первая версия, созданная сообществом NetBeans.
Большое спасибо Максиму за предложение стать координатором выпуска.
Спасибо всем разработчикам NetBeans, работающим в фирме SUN, за работу в их
свободное время для выхода данной версии.
Версия Merak посвящена исключительно исправлению ошибок.
На уровне API не было сделано никаких изменений.
Какова же разница между версией 3.4 и Merak?
Merak по умолчанию поддерживает Ant версии 1.5.1. Если Вам нужно, то Вы
можете загрузить документацию с сервера обновления NetBeans.
Справка Merak содержит множество исправлений и
обновлений, внесённых согласно вашим замечаниям.
Было исправлено много ошибок в Ядре, API среды, CVS и
в других модулях...
Полный список исправленных ошибок находится в файле
CHANGES.html (на англ.)
3. Системные требования
В силу того, что NetBeans написано на чистом Java,
она должна работать на любой реализации JavaTM2 SDK, Standard Edition.
3.1. К аппаратному обеспечению
Требования к аппаратному обеспечению схожи для
всех платформ, но могут немного отличаться. Рекомендуемая конфигурация для
запуска NetBeans IDE:
Процессор: PII/300 (Windows или Linux),
UltraSPARC II/450 (Solaris), 500MHz Alpha (Open VMS) или эквивалентный
Примечание:Если объём оперативной памяти у Вас меньше
рекомендуемого, Вам необходимо уменьшить максимальный размер кучи в файле
bin/ide.cfg. Например, если у Вас 128 МБайт ОЗУ,
желательно изменить параметр -J-Xmx96m на -J-Xmx60m.
3.2. К операционной системе
Любая ОС, поддерживающая Java(TM) 2 SDK, Standard Edition.
Ниже приведён список таких платформ, о которых знаем мы. Если Вам известно о
любой другой, которой нет в этом списке, дайте нам знать.
Windows 95 или более новая
Solaris 8
Любой Linux
OS/2
Open VMS 7.2-1 или более новая
Mac OS X 10.1.1 или более новая
HP-UX
3.3. К программному обеспечению
NetBeans необходима Java 2-совместимый SDK (не
только JVM, но и JDK). Последняя версия подходящего JDK (версии 1.3 или более
новая) может быть получена со следующих сайтов:
Mac OS X 10.1.1.
Обновление Mac OS X 10.1 до 10.1.1 доступно с помощью механизма обновления ПО Apple.
См. также раздел Установка данного документа.
Дополнительная информация об использовании NetBeans на Mac OS X доступна на
сайте www.netbeans.org/kb/articles/mac.html
4. Установка
4.1. Для всех платформ
Вы можете скачать архив .zip,
.tar.gz или .tar.bz2 и распаковать его на диск.
Затем Вам необходимо будет настроить параметры запуска
таким образом, чтобы NetBeans могла найти SDK. Конкретней об этом читайте раздел
Загрузчик и начальные параметры запуска.
4.2. На Microsoft Windows
Вы можете скачать и выполнить .exe
инсталлятор, который выполнит необходимые шаги за Вас.
Учтите, что инсталлятор не определяет бета-версии SDK
или версии SDK новее, чем сама NetBeans. Вам, возможно, потребуется установить
параметр -is:javahome <путь\к\jdk>
сразу после Netbeans_IDE_3.4.1.exe.
См. также Загрузчик и начальные параметры запуска, если
Вы хотите запустить NetBeans на JDK, отличной от установленной по умолчанию.
4.3. На Unix-платформы
Доступно несколько ".bin"-инсталляторов для различных
UNIX-платформ. Перед запуском измените аттрибуты файла на исполнимый:
Инсталлятор произведёт поиск установленных JDK и спросит Вас, какую
именно должна использовать NetBeans. Установку можно ускорить, если указать путь
к JDK с командной строки:
Скачайте самораспаковывающийся OpenVMS архив NetBeans.
Рекомендуется поместить его в его собственный подкаталог, т.к. документация и
установочный пакет будут созданы там.
Измените директорий по умолчанию на тот, в котором находится
архив NetBeans.
Выполните команду: $ RUN NetBeans
Замените NetBeans полным именем скаченного архива.
Просмотрите распакованную документацию по установке и
следуйте указанным там шагам.
4.5. На Mac OS X
Untar и unzip для ихвлечения NetBeans. Примечание:
unzip является частью средств разработчика и не содержится в стандартной
установке. Не забудьте использовать gnutar вместе tar. Также НЕ используйте
StuffitExpander. См. также запись в БД ошибок
Bad expansion of .tar.gz on Mac OS X
5. Загрузчик и начальные параметры запуска
5.1. Загрузчик
Среда NetBeans запускается спкциальной программой-загрузчиком.
Загрузчики для различных платформ находятся в подпапке bin
папки установки.
5.1.1. Для Unix-платформ
Скрипт Bourne shell
runide.sh.
5.1.2. Для Microsoft Windows
Исполнимые файлы
runide.exe или runidew.exeexecutable.
runide.exe - это консольное приложение Microsoft Windows.
При запуске runide.exe на рабочем столе открывается консоль с потоками вывода
stderr и stdout NetBeans IDE.
Для получения дампа потоков необходимо нажать Ctrl-Break,
а нажатие Ctrl-C завершит работу программы.
runidew.exe - это загрузчик NetBeans IDE для запуска среды как
приложения Windows без консоли.
5.1.3. Для OS/2
Загрузчик - это файл runideos2.cmd
5.1.4. Для OpenVMS
Загрузчик - это файл runideopenvms.com
5.1.5. Для Mac OS/X
Для запуска NetBeans откройте терминал, перейдите в папку
netbeans/bin.
Запустите NetBeans со стандартным look and feel с
помощью команды: ./runide.sh -jdkhome /Library/Java/Home
Ключ -jdkhome можно опустить, если Вы установили переменную окружения JAVA_PATH
или JDK_HOME в /Library/Java/Home
NetBeans может быть запущена с Aqua look and feel с
помощью команды: ./runide.sh -jdkhome /Library/Java/Home -ui com.apple.mrj.swing.MacLookAndFeel -fontsize 10
Примечание: Некоторые
настройки среды несовместимы между Aqua look and feel и нормальным look and feel,
поэтому рекомендуется использовать две различные папки пользователя, если Вы
хотите попробовать оба Aqua и нормальный look and feel.
Для этого используйте ключ -userdir.
Загрузчик загружает JVM, создаёт путь к классам IDE, передаёт его вместе с
некоторыми другими параметрами JVM и JVM запускает среду как
нормальное приложение Java.
Он также перезапускает среду при использовании центра обновления.
5.2. Параметры запуска
Вы можете передать
параметры запуска загрузчику с помощью файла ${IDE_HOME}/bin/ide.cfg.
Загрузчик пытается прочесть этот файл перед обработкой параметров командной
строки. Параметры в данном файле можно разбивать на несколько строк.
Доступны следующие
параметры:
-h | -help
выводит справку о параметрах запуска.
-jdkhome путь_к_jdk
заставляет загрузчик использовать указанную Java(TM) 2 SDK
вместо SDK по умолчанию. На системах Windows загрузчик просматривает реестр
Windows и использует самую последнюю установленную SDK.
-classic
использует классическую JVM вместо Java HotSpot Client VM.
-cp:p дополнительный_путь_к_классам
добавляет указанный путь к классам перед путём к классам среды.
Использовать данный параметр не рекомендуется.
-cp | -cp:a дополнительный_путь_к_классам
добавляет указанный путь к классам после пути к классам среды.
Данный параметр рекомендуется исключительно для подключения дополнительных
реализаций look and feel, которые можно вместо этого добавить в папку
lib/ext/ установки NetBeans. См. справочную систему об информации
касательно добавления пользовательских библиотек.
-Jфлаг_jvm
передаёт указанный флаг напрямую JVM.
-uiимя_класса_UI
использует данный класс как look and feel среды.
-fontsizeразмер
использует данный размер шрифта (в пунктах) как базовый для
интерфейса среды.
-localeязык[:страна[:вариант]]
использует указанную локализацию вместо указанной в ОС.
-userdirпапка_пользователя
явно указывает папку пользователя, в которой хранятся все настройки
пользователя. Если данный параметр не задан, на UNIX она располагается
в каталоге ${HOME}/.netbeans/3.4.
На системах Microsoft Windows - это папка .netbeans\3.4
в папке Вашего профиля (например, C:\Documents and Settings\yourlogin).
-J-Dnetbeans.winsys.dnd=true
включает|выключает поддержку drag and drop средой.
По умолчанию данная возможность выключена из-за большого колличества ошибок JDK
разных версий, которые делают данное поведение медленным и непредсказуемым.
В JDK 1.4.1 и 1.4.1_01 эти ошибки исправлены, поэтому можете смело включать.
-J-Dnetbeans.popup.linuxhack=true
под некоторыми оконными менеджерами Linux данный переключатель
решает ошибку #12496,
суть которой в появлении контекстных меню всегда в левом верхнем углу экрана.
-J-Dnetbeans.tab.close.button.enabled=false
убирает кнопку закрытия вкладки из вкладок проводника, редактора
исходных файлов и других окон.
6. Совместимость и обновление
По сравнению с NetBeans 3.4 в плане обновления и
совместимости ничего не было изменено.
Во время первого запуска NetBeans IDE 3.4.1 Вы можете импортировать
настройки, которые Вы настроили в предыдущих версиях среды.
Это глобальные настройки и настройки проектов. Если Вы решите не импортировать
настройки из предыдущих версий, среда запустится с настройками по умолчанию.
Мастер импорта настроек (Import Wizard) позволяет Вам настроить параметры
импорта.
Вы можете импортировать настройки из NetBeans IDE версий
3.0, 3.1, 3.2, 3.3 и 3.4. Вы также можете импортировать настройки из
Sun ONE Studio (ранее Forte for Java) версий 2.0, 3.0 и 4.0.
В NetBeans IDE версии 3.2 или ранее и в Forte for Java 3.0 или ранее
пользовательский каталог находится в папке установки среды.
Выберите Help | About, а затем вкладку Detail.
Внимание: Импортирование настроек NetBeans IDE 3.4.1 в более раннюю
версию среды невозможно.
7. Известные проблемы
Далее следует список наиболее заметных нерешённых
проблем данной версии:
22152,
22789
Описание: Большие и сложные файлы XML открываются очень медленно в редакторе
дерева XML и могут вызвать ошибки OutOfMemory (недостаточно памяти).
Способ решения: Открывайте такие файлы с помощью команды Правка (Edit), для
редактирования их в текстовом редакторе вместо редактора дерева.
12496
Описание: При нажатии на узле правой кнопкой мыши контекстное меню появляется в
левом верхнем углу экрана. Данная ошибка относится только к некоторым оконным
менеджерам Linux.
Способ решения: Используйте другой оконнымй менеджер (KDE и GNOME не вызывают
данной ошибки) или укажите параметр
-J-Dnetbeans.popup.linuxhack=true
загрузчика. Данный параметр решает проблему не для всех оконных менеджеров.
11020
Описание: При наличии старого и несовместимого парсера XML в пути к классам
среды при запуске присутствуют ошибки.
Способ решения: Удалите паразитные парсеры XML из вашего пути к классам
(обычно следует удалить их из папки ${JDK_HOME}/jre/lib/ext).
17358
Описание: При наличии файла xerces.jar версии 1.4.3 или ранее
в папке ${JDK_HOME}/jre/lib/ext, среда не запускается.
Способ решения: Удалите эту старую копию xerces.jar из папки
${JDK_HOME}/jre/lib/ext.
21621
Описание: При импорте содержащего формы проекта из NetBeans 3.2.x Палитра
компонентов может остаться скрытой при открытии формы в первый раз.
Способ решения: Выберите Вид | Редактор форм для отображения палитры компонентов.
23029:
Формат хранения модели таблицы для компоненты JTable был изменён (из-за малой
производительности и наличия большого колличества ошибок в старом).
Предыдущие версии среды не смогут открыть формы с компонентом JTable,
созданные в NetBeans 3.4.
25753:
Описание: При запуске Ant из среды несколько раз может произойти ошибка нехватки
памяти (OutOfMemory). Данная ошибка специфична для JDK 1.3.1.
Способ решения: Запускайте среду на JDK 1.4.
21180
Описание: Ошибки компиляции могут печататься в неправильную вкладку
при выполнении скрипта Ant script. Это происходит при использовании
"классического" или "современного" компилятора на JDK 1.4.0.
Способ решения: Используйте другую JDK (например, JDK 1.4.1) или другой
компилятор, такой как внешний javac или Jikes.
25907,
23135
Описание: Если веб-модуль содержит страницы JSP, имеющие одинаковое имя, но
находящиеся в различных папках, тогда компиляция выдаёт ошибку при выполнении
команды "Построить всё". Данная проблема происходит из-за того, что компилятор
JSP сервера Tomcat создаёт два сервлета с одним и тем же именем.
Способ решения: Компилируйте страница JSP одну за одной или установите уровень
интеграции на минимальный. См. страницу справки плагина Tomcat озаглавленную
Adding a Tomcat 4.0 Installation за дальнейшими инструкциями по установке уровня
интеграции.
21326
Описание: Файл состава архива JAR может быть повреждён при переключении проектов
или перемещении файлов, на которые ссылается данный файл.
26420
Описание: При тестировании или отладке веб-приложения может быть показано
исключение org.apache.jasper.JasperException
или javax.servlet.ServletException: duplicate class definition).
Оно появится в логе сервера и/или окне веб-браузера.
Эта ошибка - следствие ошибки сервера Tomcat 6907.
Способ решения: Перезапустить сервер Tomcat.
25934
Описание: Команда объявления перехода (Alt-G) на некоторых системах работает
очень медленно.
11637
Описание: При использовании средства управления импортом для внутренних классов
имя внешнего класса убирается из ссылки на внутренний класс.
22856
Описание: Возможность Исправить и продолжить не работает при изменении кода в
методе main. Вам не будет дана возможность продолжить выполнение
модифицированного кода. Класс перекомпилируется, однако продолжение отладки
невозможно.
22481
Описание: После изменения шрифта и высоты строки, промежутки между строками
номерами строк не совпадают с промежутками между строками в окне различий.
22533
Описание: После установки опции Получать файлы доступными только для чтения в
расширенном диалоговом окне команды CVS в универсальной файловой системе VCS
новое значение по умолчанию не сохраняется между перезапусками среды.
25263,
25259,
23846,
25271
Описание: При импроте проектов с добавленными универсальными фаловыми системами
VCS из NetBeans 3.2, происходит несколько ошибок. Например, не работают команды
проводника редакций и не сохраняются некоторые настройки.
Способ решения: Удалите и добавьте заново данные файловые системы VCS.
26324
Описание: При запуске среды на JDK 1.4 и использовании Windows look and
feel поле поиска в справочной системе обрезает текст.
Способ решения: Используйте другую JDK или look and feel.
Используйте систему отслеживания ошибок
Issuezilla
для проверки существующих ошибок.
8. Документация
Документация среды
предоставляется для NetBeans IDE в форме справочной системы.
Для просмотра всей доступной справки выберите Спрвка | Содержимое.
9. Дополнительная информация
На сайте проекта NetBeans -
http://www.netbeans.org/ - находится
всесторонняя информация о среде.
На сайте есть FAQ и инструкции о подписке на списки рассылки, на которых Вы
можете задать различные вопросы, разместить свои комментарии или помочь
остальным.
В силу того, что NetBeans - проект с открытыми исходными
кодами, Вы можете получить доступ к исходному коду, БД ошибок, и даже больше на
http://www.netbeans.org/.