Быстрый старт

Ligral разработан на основе .NET core 3.1 и идеально адаптирован к .NET 5. Может работать в системах Windows и Linux (Windows 10 и Ubuntu 20, Debian 10 протестированы, система Mac ещё не протестирована).

Загрузка и установка

Исполняемая программа

Система Windows

В настоящее время выпуск Ligral v0.2.1 доступен для скачивания на Gitee и GitHub. После загрузки вы можете запустить ligral-v0.2.0-beta-win10-x64.exe.

Рекомендуется создать символическую ссылку или переименовать исполняемый файл в ligral.exe, а также добавить папку с ligral в переменную среды. Для этого выполните следующие действия:

• Нажмите «Пуск», введите «Панель управления»;
• В панели управления в правом верхнем углу найдите «Система и безопасность»;
• Откройте «Система», в верхней части окна найдите раздел «Дополнительные параметры системы»;
• Щёлкните по кнопке «Переменные среды»;
• Найдите переменную Path в верхнем списке и дважды щёлкните по ней;
• Добавьте путь к папке с ligral в новую строку.

Эта операция применима к системе Windows 10. Если ваша операционная система — Windows 7 или более ранняя версия, процесс может немного отличаться.

После успешной установки вы можете открыть командную строку (рекомендуется использовать Windows Terminal) в любом каталоге и ввести команду ligral. Вы должны увидеть следующий вывод:

Copyright (c) Ligral Tech. All rights reserved.
                    __    _                  __
                   / /   (_)___ __________ _/ /
                  / /   / / __ `/ ___/ __ `/ /
                 / /___/ / /_/ / /  / /_/ / /
                /_____/_/\__, /_/   \__,_/__/
                        /____/
----------------------------------------------------------------
Hi, Ligral is a textual language for simulation.

Usage:
    ligral main.lig         to parse and simulate main.lig project.
    ligral doc Node         to view the document of Node model.
    ligral doc              to view documents of all the models.

Learn more:
    Visit https://junruoyu-zheng.gitee.io/ligral
    also available at https://JRY-Zheng.github.io/ligral

Здесь перечислены некоторые распространённые способы использования, дополнительные команды можно просмотреть с помощью команды ligral --help. Обратите внимание, что если вы напрямую запустите исполняемую программу двойным щелчком мыши, окно программы быстро закроется.

Система Linux

Версия Ligral для Linux также доступна на Gitee и GitHub. Как и в случае с системой Windows, вам нужно только загрузить ligral-v0.2.0-beta-linux-x64 для использования. Также рекомендуется создать мягкую ссылку на ligral и скопировать её в каталог /usr/local/bin.

Установка исходного кода

Независимо от того, используете ли вы систему Windows или Linux, способ установки исходного кода одинаков. Сначала вам необходимо загрузить и установить инструменты разработки .NET Core SDK. Однако вы также можете использовать .NET 5, который имеет лучшую производительность, но не является долгосрочной поддерживаемой версией (LTS). Если ваша машина работает под управлением системы Windows, вы можете перейти на веб-сайт .NET для загрузки. Установка на Linux немного сложнее, но Microsoft подготовила руководство по установке здесь.

Если на вашем компьютере уже установлен git, вы можете открыть терминал и выполнить следующую команду в каталоге, где вы хотите сохранить файлы ligral (выберите один из двух вариантов):

git clone https://gitee.com/junruoyu-zheng/ligral.git
git clone https://github.com/jry-zheng/ligral.git

Затем переключитесь на стабильную ветку master. Конечно, если вы хотите попробовать версию разработки, вы также можете использовать ветку dev. Чтобы переключиться на ветку master, выполните следующую команду:

git checkout master

Если у вас нет установленного git, вы можете посетить веб-сайты Gitee или GitHub, чтобы загрузить ligral. Возьмём Gitee в качестве примера:

Откройте папку ligral после загрузки и выполните следующую команду в командной строке:

cd ligral
dotnet build

Если вы видите следующее сообщение, это означает, что компиляция прошла успешно:

Microsoft (R) Build Engine version 16.8.0-preview-20475-05+aed5e7ed0 for .NET
Copyright (C) Microsoft Corporation. All rights reserved.

  Determining projects to restore...
  All projects are up-to-date for restore.
  You are using a preview version of .NET. See: https://aka.ms/dotnet-core-preview
  ligral -> C:\Users\zheng\Documents\ligral\bin\Debug\netcoreapp3.1\ligral.dll

Build succeeded.
    0 Warning(s)
    0 Error(s)

Time Elapsed 00:00:02.30

Первая компиляция может потребовать восстановления (все эти операции выполняются автоматически), и это может занять некоторое время в зависимости от скорости вашего интернет-соединения. После успешной компиляции рекомендуется добавить каталог, указанный в сообщении «Build succeeded» выше, в переменную окружения. Следуйте инструкциям из предыдущего раздела.

Другие настройки

Python для создания графиков

Поскольку модуль построения графиков в ligral зависит от matplotlib в python3, при необходимости использования графиков также требуется установить numpy, matplotlib и pandas. В настоящее время неясно, какие минимальные требования предъявляются к этим трём пакетам, но более новые версии должны быть доступны.

Для системы Windows вы можете загрузить его с веб-сайта Python, выбрав опцию «Добавить в переменные среды» во время установки. Linux обычно поставляется с предустановленным Python, и вы также можете установить его через командную строку в зависимости от вашей операционной системы:

sudo apt-get install python
sudo yum install python

После установки Python убедитесь, что Python и pip доступны для вызова, выполнив следующие команды:

pip install numpy
pip install matplotlib
pip install pandas