Установка FastReport в Lazarus

17.03.2021

Эта статья устарела. Обновлённая информация доступна по следующей ссылке.

В рамках образовательной программы Академик, мы решили выпустить несколько вспомогательных статей для студентов.

Если вы делаете программы делового назначения для бизнеса или государственных нужд, которые должны быть кросс-платформенными или же просто работать под Linux-системами или отечественными операционными системами (которые тоже Linux), то в конце концов вам потребуется создавать и выводить электронные документы, квитанции на печать или же в какой-то формат (PDF, офис, HTML и т.д.). И мы с продуктом FastReport VCL с этим всем будем рады вам помочь!

Установка FastReport в Lazarus

Начнём с установки, собственно, Lazarus.

В самом начале нам нужно поставить ПО под свою операционную систему.

Установка Lazarus для Windows

Первым делом скачиваем установочный пакет Lazarus с официального сайта и выбираем разрядность своей системы.

Установка Lazarus для Windows

Для Windows установщик Lazarus-а укладывается всего в один .exe файл и с ним не должно возникнуть проблем.

Далее мы скачиваем с официального сайта нужную версию архива.

Установка Lazarus для Windows

Из скаченного архива копируем содержимое в C:\Windows\System32 и C:\Lazarus, после чего перезагружаем Windows. После запускаем Lazarus, он нам сразу предлагает настроить его. Просто нажимаем «ок», согласившись с настройками по умолчанию.

Установка Lazarus для Linux

Как и в Windows в первую очередь скачиваем установочный пакет Lazarus с официального сайта

Установка Lazarus для Linux

Каждый пункт в данном списке состоит из 4 файлов (3 пакета-установщика и текстовый файл).

- Установочный пакет Lazarus(project);
- Установочный пакет fpc-src;
- Установочный пакет fpc(laz);
- Файл README.txt.

Важно установить их в правильном порядке. Сначала fpc(laz), затем fpc-src и в последнюю очередь Lazarus(project).

Заранее устраним проблему со шрифтами. Во всех операционных системах есть шрифты, которые установлены по умолчанию. Так, например, шрифт Arial по умолчанию есть и в Windows и скажем в Ubuntu. Но по факту Arial установленный по умолчанию в Ubuntu это не тот-же самый Arial установленный в Windows, потому текстовые отчеты, созданные в Windows Lazarus будут ужасно выглядеть в Linux Lazarus (и наоборот).

Чтобы этого избежать сразу установим в Linux шрифты как в Windows.

Для Ubuntu это можно сделать командой:

sudo apt-get install msttcorefonts

Но для других Linux дистрибутивов команда может отличаться.

Далее для корректной работы SqLite требуется установить следующие пакеты: sqlite3, libsqlite3-dev

Подробнее можно почитать тут. 

Для Ubuntu это можно сделать командой:

sudo apt-get install sqlite3 libsqlite3-dev

Запускаем Lazarus, где он сразу предложит вам настроить его. Нажимаем «Ок», согласившись с настройками по умолчанию.

Установка пакетов FastReport в Lazarus для Linux / Windows

Итак, Lazarus у нас уже установлен, теперь перейдём к установке пакетов генератора отчётов FastReport VCL в Lazarus. Для этого мы должны предварительно скачать с официального сайта и распаковать лицензионную версию продукта. В отличие от Embarcadero Delphi, RAD Studio и C++ Builder, в которых достаточно “просто установить скомпилированные пакеты компонентов”, в Lazarus их надо компилировать.  Для установки пакетов нажимаем Пакет (Package) -> Открыть файл пакета *.lpk (Open Package File .lpk), выберете пакет в файловом менеджере и у вас появится следующее окно:

Установка пакетов FastReport в Lazarus для Linux / Windows

В нем нажмите компилировать(Compile), дождитесь окончания компиляции и нажмите использовать(Use). После установки каждого пакета Lazarus будет перезагружаться.

Переходим к порядку установки пакетов FR:

1. fast-script\Source\fs_lazarus.lpk - библиотека для выполнения скриптов;

2. fast-report-N\Source\frN_lazarus.lpk (где n актуальная версия FR) – пакет со всеми основными компонентами;

3. В любом порядке:

- fast-report-N\Source\ExportPack\frxeN_lazarus.lpk - пакет с экспортами;
- fast-report-N\Source\lazchart\frxchartlazarus.lpk – пакет для chart-ов(диаграмм);
- fast-report-N\Source\lazdbf\frxlazdbf.lpk – пакет для работы с БД формата BDF;
- fast-report-N\Source\sqlite\frxlazsqlite.lpk – пакет для работы с СУБД SqLite.

До версии 2.0.0 очень часто встречалась ошибка компиляции и(или) установки, в момент написания этого документа последней версией является 2.0.6 и эту ошибку в Lazarus до сих пор полностью не убрали, но значительно сократили её вероятность.

Если у вас 1 из пакетов не будет компилироваться / устанавливаться вам придется опуститься вниз и перекомпилировать / переустановить зависимости пакета.

Установка пакетов FastReport в Lazarus для Linux / Windows

Для этого нажмите на ним двойным кликом и перекомпилируйте, а после переустановите.

После удачной установки всех пакетов нажмите Проект(Project) -> Открыть проект (Open Project) и откройте проект fast-report-N\LDemo\FRDemo.lpi и попробуйте его запустить, после чего нажмите кнопку Design.

Если у вас выдаст вот такую ошибку отрицательной высоты в Linux:

Установка пакетов FastReport в Lazarus для Linux / Windows

То не волнуйтесь. Дело в том, что мы поддерживаем как GTK, так и QT интерфейсы (но следует учитывать, что разработка в основном ведется на GTK). Так вот, в некоторых (довольно редких) GTK интерфейсах можно встретить этот баг. Просто запускайте приложение без отладки или-же поставьте галочку напротив «Игнорировать этот тип исключений».

*Или смените графическую оболочку. Например, в нашей команде многие работают под GTK оболочкой KDE Plasma, где этой ошибки нет.

Последний нюанс, который вам важно знать, при создании своих проектов, что наш дизайнер использует многопоточность, которая в Linux Lazarus по умолчанию отключена. Для того чтобы её включить, откройте в инспекторе проекта (Проект -> Инспектор проекта) файл с расширением «.lpr» и допишите в первым пунктом в uses юнит cthreads.

20 ноября 2024

Локализация и смена языков в FastReport VCL

FastReport VCL поддерживает 40 языков для локализации интерфейса и позволяет изменять язык на лету через меню или код, без перекомпиляции.
28 октября 2024

Как настроить WSL 2 для работы с FastReport и FastCube

В этой статье попробуем вместе разобраться, как настроить WSL 2 для работы с компонентами FastReport и FastCube в Lazarus для Linux.
9 апреля 2024

Как работать с FastReport Avalonia на .NET 8 в Visual Studio Code for Linux

В этой статье мы разберем, как запустить FastReport Avalonia на .NET 8 в операционной системе Linux с использованием Visual Studio.