Сборка BE4 и BE-SQL — различия между версиями

Материал из DevelopmenOnTheEdge
Перейти к: навигация, поиск
(Новая страница: «== Сборка BE-SQL == BE-SQL — полноценный Maven-проект. Смотрите настройку доступа в Maven [https://sites.google…»)
 
Строка 16: Строка 16:
  
 
== Структура BE4 ==
 
== Структура BE4 ==
 +
 +
Проект BE4 состоит из двух частей. Исходный код по историческим причинам лежит вместе, но разделён по проектам:
 +
 +
* BE4 Core: ядро BE4, необходимое для работы через [[Использование ant|Ant]]. Состоит из пакетов (включая подпакеты):
 +
** com.beanexplorer.enterprise.be4core
 +
** com.beanexplorer.enterprise.metadata
 +
* BE Eclipse IDE: плагины для Eclipse, реализующие пользовательский интерфейс. Включает в себя все остальные пакеты и зависит от BE4 Core.
 +
 +
BE4 Core содержит меньше зависимостей и является полноценным Maven-проектом (все зависимости есть в Maven). Pom-файл расположен в be4/pom/pom.xml.
 +
 +
BE Eclipse IDE собирается через Eclipse с помощью Ivy. При этом некоторые зависимости присутствуют явно в виде jar (каталоги be4/lib и be4/plugins — кое-что из BioUML), но большая часть зависимостей выкачивается автоматом через Ivy. Конфигурация ivy в be4/src/ivy.xml. Проект в Eclipse настроен так, что зависимости скачиваются в каталог be4/dep и потом оттуда используются. По факту с точки зрения сборки BE Eclipse IDE включает в себя BE4 Core.
 +
 +
== Добавление/обновление зависимости в BE4 ==
 +
 +
Рассмотрим как обновить версию зависимости BE4 на примере BE-SQL. Предположим, требуется обновить версию BE-SQL с 0.0.24 на 0.0.25.
 +
 +
1. Обновите версию в be4/pom/pom.xml (этот шаг не нужен для зависимостей, которые требуются):
 +
 +
  <dependency>
 +
  <groupId>com.developmentontheedge</groupId>
 +
  <artifactId>sql</artifactId>
 +
  <version>0.0.24</version> --> 0.0.25
 +
  </dependency>
 +
 +
2. Обновите версию в be4/src/ivy.xml
 +
 +
  <dependency org="com.developmentontheedge" name="sql" rev="0.0.24" />
 +
  -->
 +
  <dependency org="com.developmentontheedge" name="sql" rev="0.0.25" />
 +
 +
3. Обновите версию в be4/META-INF/MANIFEST.MF в разделе Bundle-ClassPath:
 +
 +
dep/sql-0.0.24.jar, -->  dep/sql-0.0.25.jar,
 +
 +
Следует делать все изменения одновременно. Даже если вы не используете Eclipse-версию, пользователи Eclipse могут пострадать, если ограничиться первым пунктом.

Версия 14:50, 16 августа 2016

Сборка BE-SQL

BE-SQL — полноценный Maven-проект. Смотрите настройку доступа в Maven во внутренней вики. Все этапы сборки выполняются с помощью maven, включая компиляцию javacc-грамматики. Для сборки новой версии:

  • Выкачать проект dote/dote_modules
  • Зайти в dote_modules/sql
  • Изменить номер версии в pom.xml:
<version>0.0.24</version>
  • Запустить mvn deploy.

Деплоить одну и ту же версию дважды не выйдет. Если что-то пошло не так, увеличивайте номер версии снова и деплойте заново.

Чтобы воспользоваться новой версией BE-SQL в BE4, вам придётся выпустить также новую версию BE4 с обновлёнными зависимостями (см. ниже).

Структура BE4

Проект BE4 состоит из двух частей. Исходный код по историческим причинам лежит вместе, но разделён по проектам:

  • BE4 Core: ядро BE4, необходимое для работы через Ant. Состоит из пакетов (включая подпакеты):
    • com.beanexplorer.enterprise.be4core
    • com.beanexplorer.enterprise.metadata
  • BE Eclipse IDE: плагины для Eclipse, реализующие пользовательский интерфейс. Включает в себя все остальные пакеты и зависит от BE4 Core.

BE4 Core содержит меньше зависимостей и является полноценным Maven-проектом (все зависимости есть в Maven). Pom-файл расположен в be4/pom/pom.xml.

BE Eclipse IDE собирается через Eclipse с помощью Ivy. При этом некоторые зависимости присутствуют явно в виде jar (каталоги be4/lib и be4/plugins — кое-что из BioUML), но большая часть зависимостей выкачивается автоматом через Ivy. Конфигурация ivy в be4/src/ivy.xml. Проект в Eclipse настроен так, что зависимости скачиваются в каталог be4/dep и потом оттуда используются. По факту с точки зрения сборки BE Eclipse IDE включает в себя BE4 Core.

Добавление/обновление зависимости в BE4

Рассмотрим как обновить версию зависимости BE4 на примере BE-SQL. Предположим, требуется обновить версию BE-SQL с 0.0.24 на 0.0.25.

1. Обновите версию в be4/pom/pom.xml (этот шаг не нужен для зависимостей, которые требуются):

 <dependency>
  <groupId>com.developmentontheedge</groupId>
  <artifactId>sql</artifactId>
  <version>0.0.24</version> --> 0.0.25
 </dependency>

2. Обновите версию в be4/src/ivy.xml

 <dependency org="com.developmentontheedge" name="sql" rev="0.0.24" />
 -->
 <dependency org="com.developmentontheedge" name="sql" rev="0.0.25" />

3. Обновите версию в be4/META-INF/MANIFEST.MF в разделе Bundle-ClassPath:

dep/sql-0.0.24.jar, -->  dep/sql-0.0.25.jar,

Следует делать все изменения одновременно. Даже если вы не используете Eclipse-версию, пользователи Eclipse могут пострадать, если ограничиться первым пунктом.