Компиляция и запуск BeanExplorer4 — различия между версиями

Материал из DevelopmenOnTheEdge
Перейти к: навигация, поиск
(→‎Простой запуск)
 
(не показано 15 промежуточных версии 2 участников)
Строка 1: Строка 1:
 
=== Простой запуск ===
 
=== Простой запуск ===
−
Самый простой запуск:
+
Простой запуск:
−
# убедиться, что установлена Java 7 (JRE достаточно);
+
# убедиться, что установлена Java 8 (JRE достаточно);
−
# поместить исходники be4 в любую папку;
+
# поместить исходники be4 в C:\projects\java\be4;
−
# сделать одно из следующих действий:
+
# взять Eclipse IDE for Java EE Developers, Eclipse Luna SR2 из этой папки: \\logrus.dote.ru\pub2\be4;
−
#* скачать готовый Eclipse для Windows x64 с LACHESIS (обычно это архив eclipse.zip в папке Product-<ДАТА-ПУБЛИКАЦИИ> внутри \\LACHESIS\pub2\_be4\Installation) и разархивировать в любую папку;
+
# отсюда же устанавливаем наши плагины, для этого заходим в Help -> Install New Software..., Add... копируем file:////logrus.dote.ru/pub2/be4/com.beanexplorer.be4.site/ в Location, OK, снимаем галочку Group items by category (если список фич пуст), ставим галочку на BeanExplorer4, Next и т.д.
−
#* скачать Eclipse для своей ОС и установить на него содержимое архива repository.zip (обычно он находится в папке Product-<ДАТА-ПУБЛИКАЦИИ> внутри \\LACHESIS\pub2\_be4\Installation).
+
  
−
При запуске eclipse.exe спросит, откуда взять исходники be4, если не догадается об их местоположении.
+
После перезагрузки Eclipse для работы с BE4 нужно будет выбрать перспективу BeanExplorer. При этом (или же при запуске Eclipse) Eclipse спросит, откуда взять исходники be4, если не догадается об их местоположении. В случае, если be4 находится в C:\projects\java\be4, то всё должно происходить само. Эти исходники нужны только для загрузки модулей.
 +
 
 +
Известный баг: если be4 помещён не в C:\projects\java\be4, то Eclipse каждый раз при запуске будет спрашивать местонахождение be4.
  
 
=== Запуск из-под Eclipse ===
 
=== Запуск из-под Eclipse ===
−
Для компиляции необходима Java 7, Eclipse Standard (Kepler/4.3.2) и несколько плагинов для него:
+
Для компиляции необходимы
−
# '''Eclipse Web Tools Platform (WTP, including. JSDT)''' - входит по умолчанию в Eclipse for Java EE
+
# '''Java 8''' [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html отсюда],
−
# '''Eclipse Data Tools Platform (DTP)'''. Они есть в официальном репозитории Kepler. (Help->Install New Software, выбираем Work with <nowiki>http://download.eclipse.org/releases/kepler</nowiki>, затем в появившемся дереве плагинов ставим галочки у Database Development, Eclipse Web Developer Tools и JavaScript Development Tools.)
+
# '''Eclipse IDE for Java EE Developers''', Eclipse '''Luna SR2''' [http://www.eclipse.org/downloads/packages/release/luna/sr2 отсюда],
−
# '''Наша версия Freemarker IDE'''. Варианты установки:
+
# '''Наша версия Freemarker IDE''' - обычно мы импортируем проекты org.freemarker.core и org.jboss.ide.eclipse.freemarker из публичного репозитория https://github.com/amaembo/jbosstools-freemarker.git (см. ниже),
 +
# '''IvyDE''' - устанавливается из Eclipse MarketPlace,
 +
# '''YEdit''' - устанавливается из Eclipse MarketPlace,
 +
# Наш проект '''common''' - его необходимо импортировать в workspace.
 +
# Наш проект '''beclipse''' - его необходимо также импортировать в workspace. Живёт в <каталог с проектами>/be4.
 +
Необходимо создать API baseline. Для этого заходим в Window -> Preferences, Plug-in Development -> API Baselines, там вводим любое Name, нажимаем Reset, Finish, Apply, OK.
 +
 
 +
Необходимо создать конфигурацию запуска. Заходим в "Debug Configurations..." (можно нажать Ctrl+3 и начать печатать "Debug Configurations"), там кликаем два раза на Eclipse Application, открываем вкладку Plug-ins, выбираем "Launch with: all workspace and enabled target plug-ins", нажимаем Apply, Debug (потом при запуске просто будем нажимать F11 вместо входа сюда). Помимо этого см. настройки запуска ниже.
 +
 
 +
Для проверки того, что всё установлено и будет корректно работать, нужно зайти на вкладку Plug-ins конфигурации запуска и там нажать "Validate Plug-ins" чтобы убедиться, что все необходимые плагины имеются.
 +
----
 +
 
 +
=== Варианты установки Freemarker IDE ===
 
==== Вариант 1 (запуск без исходного кода Freemarker IDE). ====
 
==== Вариант 1 (запуск без исходного кода Freemarker IDE). ====
−
Установить содержимое \\LACHESIS\pub2\_be4\Installation\freemarker.feature.zip
+
Установить содержимое \\files.dote.ru\pub2\_be4\Installation\freemarker.feature.zip
 
# Заходим в... Help->Install New Software. Add...->Archive... выбрать архив, OK.
 
# Заходим в... Help->Install New Software. Add...->Archive... выбрать архив, OK.
 
# Снять галочку "Group items by category", если не видно пунктов для установки.
 
# Снять галочку "Group items by category", если не видно пунктов для установки.
Строка 25: Строка 38:
 
#*- org.jboss.ide.eclipse.freemarker. Остальные проекты можно не импортировать или просто закрыть.
 
#*- org.jboss.ide.eclipse.freemarker. Остальные проекты можно не импортировать или просто закрыть.
 
# Windows -> Preferences; Plug-In Development -> API Baselines; ввести произвольное имя, Reset, Finish, Apply, OK.
 
# Windows -> Preferences; Plug-In Development -> API Baselines; ввести произвольное имя, Reset, Finish, Apply, OK.
−
 
−
Если есть ошибки в MANIFEST.MF (они могут быть, если версия Eclipse - 4.3.1), то можно временно стереть указания версий в подчёркнутых
 
−
строчках (стирается что-то типа <code>;bundle-version="3.9.2"</code>).
 
  
 
=== Настройки запуска: ===
 
=== Настройки запуска: ===
 
# Run->Debug Configurations..., выбрать Eclipse Application, нажать New launch configuration.
 
# Run->Debug Configurations..., выбрать Eclipse Application, нажать New launch configuration.
 
# Выбрать каталог в Workspace data (лучше создать новый пустой, например, c:\projects\be4-workspace).
 
# Выбрать каталог в Workspace data (лучше создать новый пустой, например, c:\projects\be4-workspace).
−
# Execution environment -> Java 1.7.
+
# Execution environment -> Java 1.8.
−
# Вкладка Arguments Скопировать это значение в поле VM Arguments: '''-Dosgi.requiredJavaVersion=1.6 -Xms256m -Xmx512m -XX:PermSize=256m -XX:MaxPermSize=384m -ea''' (Без них Eclipse будет периодически вылетать с OutOfMemoryError: PermGen space.)
+
# Вкладка Arguments Скопировать это значение в поле VM Arguments: '''-Dosgi.requiredJavaVersion=1.8 -Xms256m -Xmx768m -ea'''
 
# Apply, Debug.
 
# Apply, Debug.

Текущая версия на 13:49, 21 августа 2018

Простой запуск

Простой запуск:

  1. убедиться, что установлена Java 8 (JRE достаточно);
  2. поместить исходники be4 в C:\projects\java\be4;
  3. взять Eclipse IDE for Java EE Developers, Eclipse Luna SR2 из этой папки: \\logrus.dote.ru\pub2\be4;
  4. отсюда же устанавливаем наши плагины, для этого заходим в Help -> Install New Software..., Add... копируем file:////logrus.dote.ru/pub2/be4/com.beanexplorer.be4.site/ в Location, OK, снимаем галочку Group items by category (если список фич пуст), ставим галочку на BeanExplorer4, Next и т.д.

После перезагрузки Eclipse для работы с BE4 нужно будет выбрать перспективу BeanExplorer. При этом (или же при запуске Eclipse) Eclipse спросит, откуда взять исходники be4, если не догадается об их местоположении. В случае, если be4 находится в C:\projects\java\be4, то всё должно происходить само. Эти исходники нужны только для загрузки модулей.

Известный баг: если be4 помещён не в C:\projects\java\be4, то Eclipse каждый раз при запуске будет спрашивать местонахождение be4.

Запуск из-под Eclipse

Для компиляции необходимы

  1. Java 8 отсюда,
  2. Eclipse IDE for Java EE Developers, Eclipse Luna SR2 отсюда,
  3. Наша версия Freemarker IDE - обычно мы импортируем проекты org.freemarker.core и org.jboss.ide.eclipse.freemarker из публичного репозитория https://github.com/amaembo/jbosstools-freemarker.git (см. ниже),
  4. IvyDE - устанавливается из Eclipse MarketPlace,
  5. YEdit - устанавливается из Eclipse MarketPlace,
  6. Наш проект common - его необходимо импортировать в workspace.
  7. Наш проект beclipse - его необходимо также импортировать в workspace. Живёт в <каталог с проектами>/be4.

Необходимо создать API baseline. Для этого заходим в Window -> Preferences, Plug-in Development -> API Baselines, там вводим любое Name, нажимаем Reset, Finish, Apply, OK.

Необходимо создать конфигурацию запуска. Заходим в "Debug Configurations..." (можно нажать Ctrl+3 и начать печатать "Debug Configurations"), там кликаем два раза на Eclipse Application, открываем вкладку Plug-ins, выбираем "Launch with: all workspace and enabled target plug-ins", нажимаем Apply, Debug (потом при запуске просто будем нажимать F11 вместо входа сюда). Помимо этого см. настройки запуска ниже.

Для проверки того, что всё установлено и будет корректно работать, нужно зайти на вкладку Plug-ins конфигурации запуска и там нажать "Validate Plug-ins" чтобы убедиться, что все необходимые плагины имеются.

Варианты установки Freemarker IDE

Вариант 1 (запуск без исходного кода Freemarker IDE).

Установить содержимое \\files.dote.ru\pub2\_be4\Installation\freemarker.feature.zip

  1. Заходим в... Help->Install New Software. Add...->Archive... выбрать архив, OK.
  2. Снять галочку "Group items by category", если не видно пунктов для установки.

Вариант 2 (для разработчиков Freemarker IDE).

  1. Необходим репозиторий https://github.com/amaembo/jbosstools-freemarker.git
  2. После скачивания репозитория нужно импортировать два проекта:
    • - org.freemarker.core
    • - org.jboss.ide.eclipse.freemarker. Остальные проекты можно не импортировать или просто закрыть.
  3. Windows -> Preferences; Plug-In Development -> API Baselines; ввести произвольное имя, Reset, Finish, Apply, OK.

Настройки запуска:

  1. Run->Debug Configurations..., выбрать Eclipse Application, нажать New launch configuration.
  2. Выбрать каталог в Workspace data (лучше создать новый пустой, например, c:\projects\be4-workspace).
  3. Execution environment -> Java 1.8.
  4. Вкладка Arguments Скопировать это значение в поле VM Arguments: -Dosgi.requiredJavaVersion=1.8 -Xms256m -Xmx768m -ea
  5. Apply, Debug.
Источник — «http://wiki.dote.ru/index.php?title=Компиляция_и_запуск_BeanExplorer4&oldid=470»