Poetica Project

Актуальная версия 0.94.7 от 26 декабря 2021 года.

Проект Poetica призван помочь оператору дежурной команды провести тур чемпионата по бескрылкам.

Информация о том, как скачать и запустить готовую программу, а также остальная пользовательская документация по проекту находятся по ссылке: https://github.com/cdefgah/poetica/wiki/Poetica

Сборка проекта

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

Java SE (Standard Edition) SDK версии не ниже 1.8;
Node.JS версия 12.18.4;
Angular, версия 11.0.5, если будете использовать более новые версии Angular, возможно потребуется мигрировать проект;
Apache Maven актуальной версии. Пропишите путь к папке bin в Apache Maven в системную переменную окружения PATH, чтобы команда mvn была доступна из любой папки.

Установка Node.JS и Angular делается следующим образом:

Скачиваете и устанавливаете Node.JS
Открываете терминал и даёте команду (Linux-пользователям надо добавить перед командой sudo ):

npm install -g typescript

Эта команда установит поддержку typescript.

Затем в этом-же терминале даёте команду (Linux-пользователям надо добавить перед командой sudo ):

npm install -g @angular/cli@11.0.5

После этого даёте команду в терминале:

ng --version

Должна отобразиться информация об установленном Angular и его компонентах. В информации о компонентах не должно быть никаких сообщений об ошибках. Если они есть, переустановите эти компоненты отдельно.

Если это первая сборка проекта, то перейдите в папку src/main/frontend, откройте терминал в этой папке и дайте команду:

npm install

Это установит все необходимые зависимости для сборки части проекта, построенной на Angular.

Затем, в корневой папке проекта (там, где находится файл pom.xml), в терминале дайте команду:

mvn clean package

После выполнения сборки, из папки target забирайте файл poetica-x.xx.x-distrib.zip, где x.xx.x - номер версии, например: poetica-0.94.6-distrib.zip.

Внутри этого zip-архива находится папка со всеми файлами приложения. Просто распакуйте этот архив и следуйте инструкциям пользовательской документации по запуску приложения.

В текущем архиве дистрибутива файл приложения имеет расширение .dat вместо .jar, это сделано специально, чтобы Windows-пользователи не запустили программу, случайно кликнув по файлу мышкой. Ибо в таком случае jar-файл будет запущен без открытия окна приложения и пользователь не будет видеть, запущено у него приложение или нет.

В текущей версии, часть проекта на Angular собирается вместе с отладочной информацией, чтобы облегчить выявление причин сбоев во время работы программы. За это отвечает вот этот участок pom.xml

    <configuration>
        <executable>ng</executable>
        <workingDirectory>src/main/frontend</workingDirectory>
        <arguments>
            <argument>build</argument>
        </arguments>
    </configuration>

Для того, чтобы исключить отладочную информацию из Angular-сборки, измените вышеописанный блок кода на такой:

    <configuration>
        <executable>ng</executable>
        <workingDirectory>src/main/frontend</workingDirectory>
        <arguments>
            <argument>build</argument>
            <argument>--prod</argument>
        </arguments>
    </configuration>