Компиляция исходного кода

Используя приведённые ниже инструкции, все пользователи могут произвести сборку исходного кода LUWRAIN на своих системах. В процессе разработки LUWRAIN компилируется на GNU/Linux, поэтому подготовленные для этого скрипты предназначены для запуска именно в этой системе.

Режимы сборки

Существует два режима сборки исходных текстов LUWRAIN:

Используя исходный код из репозиториев Git.
Используя исходный код nightly-релизов.

Исходный код в репозиториях Git может находиться в состояниях, непригодных для компиляции по причине незаконченных обновлений, включая ситуацию, когда разные репозитории содержат несогласованные между собой изменения. Для использования этого метода в системе должна присутствовать утилита git.

Использование nightly-релизов позволяет получить исходный код, очевидно, гарантированно пригодный для компиляции. Самый свежий nightly-релиз доступен здесь. При этом с нашего сайта потребуется вручную скачать и установить архив с подготовленными виртуальными машинами Java, который доступен по этой ссылкеhttp://download.luwrain.org/compilation/binary.tar.gz.

Получение исходного кода из репозиториев Git

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

git clone https://github.com/luwrain/base/
cd base/scripts
./lwr-checkout

Получение исходного кода из nightly-релиза

Для получения исходного кода из nightly-релиза необходимо выполнить следующие команды, в которых подстроку <ДАТА> требуется заменить на дату текущего файла::

wget -q http://download.luwrain.org/nightly/latest/luwrain-nightly-<ДАТА>.tar.gz
tar xf luwrain-nightly-<ДАТА>.tar.gz
cd luwrain-nightly-<ДАТА>
wget -q http://download.luwrain.org/compilation/binary.tar.gz
tar xf binary.tar.gz
cd base/scripts

Требования к системе

Для компиляции в системе должны присутствовать следующие компоненты:

JDK (мы используем OpenJDK 14)
JavaFX (мы используем версию 14)
Ant

Компиляция

Для выполнения компиляции необходимо вызвать команду:

./lwr-build

Обратите внимание, что происходит сборка только Java-кода. Все JNI-компоненты находятся в архиве binary.tar.gz. Их компиляцию мы не описываем, потому что она требует загрузки слишком большого количества стороннего кода и установки большого количества сторонних компонентов. Аналогично эта ккоманда не производит сборку используемых библиотек, поскольку они также загружаются внутри упомянутого выше архива.

Получение дистрибутива

Если компиляция прошла успешно, то можно вызвать одну из двух команд:

./lwr-distr-linux <ЦЕЛЕВОЙ_КАТАЛОГ>

или

./lwr-distr-win  <ЦЕЛЕВОЙ_КАТАЛОГ>

Эти команды соберут в указанном каталоге все файлы, формирующие дистрибутив, который можно запустить в соответствующей операционной системе.