Installation von FastReport- und FastCube-Komponenten in Lazarus

Installation von FastReport

In der neuen Version 2023.3 für Delphi wurden Änderungen an der internen Infrastruktur der Produkte vorgenommen. In diesem Artikel wird die Installation der FastReport-Komponenten in Lazarus beschrieben.

Inhalt des Artikels:

1. Was gibt's Neues?
2. Vergleich von Editionen und Produkten;
3. Installation der Produkte in Lazarus;
3.1 Lazarus Installation unter Windows;
3.2 Lazarus Installation unter Linux;
3.3 Installation der Pakete unter Windows;
3.4 Installation der Pakete unter Linux.

Was gibt's Neues?

Das FastReport Produkt für die Berichterstellung besteht aus mehreren Komponenten, insbesondere einer Skript-Engine, einem Berichtsgenerierungskern und Lokalisierungspaketen. Diese Komponenten werden sowohl in Rad Studio als auch in Lazarus eingesetzt.

Lazarus verfügt nun über neue Pakete. Früher erforderte ein Sprachenwechsel eine umfangreiche Neukompilierung, aber jetzt haben wir das frLocalizationLibrary.lpk Paket, das den Sprachwechsel steuert. Jede Sprache stellt ein separates Paket dar, zum Beispiel frLanguageGermanPkg.lpk, frLanguageJapanesePkg.lpk, …

Englisch ist nach wie vor standardmäßig ausgewählt, daher gibt es kein separates Sprachpaket für Englisch.

Um die Sprache zu ändern, müssen Sie nicht mehr die Anwendung neu zu starten. Die Sprache kann direkt im laufenden Betrieb geändert werden.

Um die Sprache zu ändern, müssen Sie:
1. die TfrLocalizationController Komponente dem Formular hinzufügen (aus dem frLocalizationLibrary.lpk Paket);
2. in ihrer Language Eigenschaft die gewünschte Sprache auswählen (zum Beispiel, Italian), die Liste der Sprachen hängt von den in der IDE installierten Paketen ab;
3. ein Sprachpaket dem Projektinspektor hinzufügen (zum Beispiel, frLanguageItalianPkg);
4. im Code der Haupteinheit im Abschnitt „uses“ den Paketnamen ohne die Pkg- Endung hinzufügen (zum Beispiel, frLanguageItalian).

Außerdem wurden die frCoreLibrary.lpk und frGraphicsLibrary.lpk Pakete zugewiesen, die keine neuen Komponenten hinzufügen, sondern einen gemeinsamen Code für verschiedene Produkte speichern.

Der Einfachheit halber werden alle Pakete mit der .lpk-Erweiterung in einem Verzeichnis gesammelt. Jetzt müssen die Benutzer Ordner nicht mehr manuell nach bestimmten Paketen durchsuchen.

Die restlichen Dateien werden wie bisher in Verzeichnisse verteilt, da dies für Lazarus selbst notwendig ist.

Darüber hinaus wurde das FastCube-Produkt für die Lazarus-Plattform angepasst. Weitere Informationen zum FastCube-Produkt finden Sie unter diesem Link. Versuchen Sie, FastCube mithilfe von Testkomponenten in Ihr Projekt zu integrieren.

Vergleich von Editionen und Produkten 

Betrachten wir die Produkte mit den darin enthaltenen Paketen, um den Vergleich zu erleichtern.

Paket

Paketbeschreibung

FastScript

FastReport

FastCube

fs_lazarus.lpk

Skriptbibliothek

+

+

+

frCoreLibrary.lpk

Hilfspaket mit der Ausführung gemeinsamer Grundfunktionen

+

+

+

frLocalizationLibrary.lpk

Paket zur Sprachverwaltung 

+

+

+

frLanguage*Pkg.lpk

40 Sprachpakete

+

+

+

frGraphicsLibrary.lpk

Hilfspaket mit der Ausführung allgemeiner grafischer Funktionen

-

+

-

fr_lazarus.lpk

Paket mit allen wichtigen Produktkomponenten

-

+

-

frxchartlazarus.lpk

Chart-Paket (Diagramme)

-

+

-

frxe_lazarus.lpk

Paket mit Exporten

-

+

-

frxlazdbf.lpk

Paket für die Arbeit mit Datenbanken im BDF-Format

-

+

-

frxlazsqlite.lpk

Paket für die Arbeit mit SqLite- Datenbankverwaltungssystemen

-

+

-

frxPDFlazarus.lpk

Paket zur Anzeige von PDF-Dokumenten (nur Windows)

-

+

-

frxrichlazarus.lpk

Paket zur Anzeige von Rich -Dokumenten (aufgrund der Einschränkungen des Basispakets ur für Windows empfohlen)

-

+

-

frCS_lazarus.lpk

Paket mit Client-Server-Komponenten, mit denen Sie sich hier vertraut machen können 

-

+*

-

fcxLazarus.lpk

Paket mit allen Hauptproduktkomponenten

-

-

+

fcxprint.lpk

Paket zur FastReport-Integration

-

-

+

fcxprintTee.lpk

Paket zur FastReport Chart-Integration

-

-

+

fcxScript.lpk

Paket zur FastScript-Integration

-

-

+

fcxexport.lpk

Paket mit FastCube-Exporten

-

-

+

fcxCharting.lpk

Paket für Charts in FastCube

-

-

+

*Client-Server-Komponenten sind in FastReport nur in der Enterprise-Lizenz enthalten.

Nachstehend betrachten wir zusätzlich die Trial- und Academ-Lizenzen der jeweiligen Produkte.

Um ein Produkt vor dem Kauf zu testen, ist eine Trial-Lizenz erforderlich, die Academ-Lizenz wird für Bildungszwecke und nicht für kommerzielle Projekte verwendet.

Beide Lizenzen enthalten vorkompilierte Versionen von reduzierten Paketen.

Die FastScript Trial-Lizenz hat eine Einschränkung: Das Ausführen von Skripten ist nicht möglich.

Die Einschränkungen der FastReport Trial-Lizenz sind:
- Nur Englisch;
- Das Drucken und Exportieren ist auf 5 Seiten beschränkt, mit einem Hinweis in der Ecke, dass es sich um eine Testversion handelt;
- kein Rich View.
Die Einschränkungen der FastReport Academ-Lizenz sind:
- Druckausgabe und Export sind mit dem Wasserzeichen der Redaktion versehen;
- Rich View, 2D-Barcodes, die meisten Exporte fehlen.

FastCube Trial hat eine Einschränkung: Der Text „TrialString“ wird in zufälligen Zellen anstelle von Daten angezeigt.


FastReport Installation in Lazarus

Beginnen Sie mit der Installation von Lazarus selbst. Ganz am Anfang müssen Sie die Software für Ihr Betriebssystem installieren.

Lazarus Installation unter Windows 

Laden Sie zunächst das Lazarus-Installationspaket von der offiziellen Website (https://www.lazarus-ide.org/) herunter und wählen Sie die Bit-Anzahl Ihres Systems.

Lazarus Installation unter Windows

Für Windows passt der Lazarus-Installer in nur eine .exe-Datei und es sollte damit keine Probleme geben.

Als Nächstes laden Sie die erforderliche Version des Archivs von der offiziellen Website (https://www.sqlite.org/download.html) herunter.

Lazarus Installation unter Windows

Kopieren Sie den Inhalt des heruntergeladenen Archivs nach C:Windows\System32 und C:\Lazarus, dann starten Sie Windows neu. Anschließend starten Sie Lazarus und konfigurieren Sie es. Klicken Sie einfach auf "ok" und akzeptieren Sie die Standardeinstellungen.

Lazarus Installation unter Linux

Es gibt zwei Möglichkeiten, Lazarus unter Linux zu installieren.

Die erste Möglichkeit ist die Installation mit dem Paketmanager. Geben Sie dazu einen der folgenden Befehle in das Terminal ein:

// DEB Users -
sudo apt-get install lazarus
// RPM Users -
sudo yum install lazarus
// or
sudo dnf install lazarus

Dies ist sehr schnell und einfach, aber dieser Befehl wird eine "stabile" Version von Lazarus installieren (d.h. die letzte getestete Version ihrer Distribution, und dies wird von Distribution zu Distribution variieren). Die stabile Version kann hinter der aktuellen (neuesten) Version zurückbleiben.

Im Gegensatz zu Delphi und Rad Studio unterstützen unsere Komponenten keine älteren Versionen von Lazarus. Daher ist es möglich, dass unsere Produkte unter einer stabilen Version nicht funktionieren. Und was Lazarus betrifft, werden unsere Komponenten nur auf der aktuellen Version von Lazarus entwickelt.

Dies gilt insbesondere für größere (Release) Updates von Lazarus. Wenn sich die stabile Version geringfügig von der aktuellen unterscheidet, besteht eine hohe Wahrscheinlichkeit, dass unsere Komponenten korrekt funktionieren. Unser Unternehmen übernimmt keine Verantwortung für die korrekte Funktion dieser Version. Sie als Benutzer tun dies "auf eigene Gefahr". Im schlimmsten Fall verlieren Sie ein bisshen Zeit, um Lazarus auf die aktuelle Version zu aktualisieren.

Dies ist jedoch noch wichtiger in Bezug auf vorkompilierte Komponenten (Trial- und Academ-Editionen). Das wichtigste Merkmal vorkompilierter Pakete in Lazarus ist, dass sie nur auf der Version von Lazarus laufen, auf der sie kompiliert wurden (also der aktuellen Version).

Daher empfehlen wir Ihnen die zweite Möglichkeit, nämlich die manuelle Installation der Pakete.

Wie unter Windows laden Sie zunächst das Lazarus-Installationspaket von der offiziellen Website (https://www.lazarus-ide.org/) herunter.

Lazarus Installation unter Linux

Jedes Element in dieser Liste besteht aus 4 Dateien (3 Installationspakete und eine Textdatei).
- Lazarus(project) Installationspaket;
- fpc-src Installationspaket;
- fpc(laz) Installationspaket;
- README.txt-datei.

Es ist wichtig, sie in der richtigen Reihenfolge zu installieren. Zuerst fpc(laz), dann fpc-src und zuletzt Lazarus(project).

Betrachten wir den Installationsprozess selbst ein wenig genauer. Es geht darum, dass das letzte Lazarus(project) Paket in den meisten Distributionen etwa 100 fehlende Abhängigkeiten aufweisen wird.

Es ist daher am einfachsten, Pakete über eine grafische Hilfsanwendung (wie QApt oder GDebi) zu installieren, die die erforderlichen Hilfspakete selbstständig herunterlädt.

Wenn Sie jedoch einfachere Dienstprogramme verwenden, die Abhängigkeiten nicht automatisch herunterladen (wie dpkg), müssen Sie diese nach der Installation selbst installieren. Dies geschieht oft sehr einfach. In unserem Beispiel müssen Sie nach der Installation eines Pakets mit einer Fehlermeldung über nicht aufgelöste Abhängigkeiten nur den folgenden Befehl eingeben:

sudo apt-get -f install

Damit ist die Installation von Lazarus unter Linux abgeschlossen.

Im Vorfeld müssen wir das Problem mit den Schriftarten beheben. Alle Betriebssysteme verfügen über Schriftarten, die standardmäßig installiert sind. So ist beispielsweise die Schriftart Arial sowohl unter Windows als auch unter Ubuntu die Standardschrift. Aber tatsächlich ist die unter Ubuntu installierte Standard-Arial nicht die gleiche Arial, die unter Windows installiert ist, so dass Textberichte, die in Windows Lazarus erstellt werden, in Linux Lazarus schlecht aussehen (und umgekehrt).

Um dies zu vermeiden, installieren Sie unter Linux die gleichen Schriftarten wie unter Windows. Unter Ubuntu kann dies mit dem Befehl erfolgen:

sudo apt-get install msttcorefonts

Bei anderen Linux-Distributionen kann der Befehl jedoch anders lauten. Für die korrekte Funktion von SqLite müssen Sie außerdem die folgenden Pakete installieren: sqlite3, libsqlite3-dev. Mehr können Sie hier lesen. (https://wiki.freepascal.org/SQLite).

Unter Ubuntu kann dies mit dem Befehl erfolgen:

sudo apt-get install sqlite3 libsqlite3-dev

Starten Sie Lazarus und konfigurieren Sie es. Klicken Sie auf "ok" und akzeptieren Sie die Standardeinstellungen.

Installation der Pakete unter Windows

Unser neues Windows-Installationsprogramm wird alle Pakete für Sie installieren. Führen Sie ihn einfach aus und folgen Sie den Anweisungen.

Willkommensfenster des Installationsprogramms

Auswählen der IDE und der zu installierenden Version

Es ist erwähnenswert, dass Sie nicht überall auf ihrem Computer nach Lazarus Verzeichnissen suchen müssen, sondern einfach die Konfigurationsdateien benutzen, die bei der Installation von Lazarus erzeugt werden. Also wird unser Installationsprogramm nicht in der Lage sein, ihre 2 oder 3 Lazarus zu finden, die sie von Hand kopiert haben.

Wenn Sie mehrere Lazarus auf ihrem Gerät haben möchten und jedes über Fastreport oder ein anderes unserer Produkte verfügen sollte, führen Sie zum Installieren einer zweiten Kopie von Lazarus das Lazarus-Installationsprogramm aus und aktivieren Sie das Kontrollkästchen „Mehrfachinstallation“.

“Mehrfachinstallation” im Lazarus- Installationsprogramm

Installation der Pakete unter Linux

Für Linux müssen Sie das entsprechende .deb- oder .rpm-Paket von der offiziellen Website herunterladen und installieren. Im Moment werden sie einfach in den entsprechenden Ordner im Verzeichnis „/usr/share/...“ entpackt. Das Verzeichnis ist in der Beschreibung des Pakets selbst angegeben.

Unter Linux ist die automatische Installation der Pakete analog wie unter Windows noch nicht geplant.

Wenn Sie Linux-Neulinge sind, empfehlen wir Ihnen, das entpackte Produkt in Ihr Home-Verzeichnis (“/home/username/”) zu kopieren, um sich nicht mit Zugriffsrechten herumschlagen zu müssen.

Wie bereits oben erwähnt, werden alle .lpk-Dateien im Ordner "Lpks" gesammelt. Um Pakete zu installieren, klicken Sie auf Paket (Package) -> Paketdatei *.lpk öffnen (Open Package File .lpk), wählen Sie das Paket im Dateimanager aus und es erscheint das folgende Fenster:

Installationsfenster

Klicken Sie darin für Professional und höher auf Kompilieren (Compile), warten Sie, bis die Kompilierung abgeschlossen ist, und klicken Sie auf Verwenden(Use).

Für Academic und Trial klicken Sie sofort auf Verwenden(Use). Lazarus wird nach der Installation jedes Pakets neu starten.

Zuvor haben wir eine strenge Reihenfolge für die Installation von Paketen festgelegt. Aus verschiedenen Gründen (zunehmende Anzahl von Paketen, komplexere Beziehungen zwischen den Paketen und die Tatsache, dass sie sich alle im selben Ordner befinden) ist dieser Ansatz jedoch irrelevant geworden. Sie können das Paket, das in den Abhängigkeiten des Pakets angezeigt wird, das Sie installieren möchten, leicht finden.

Sie können jedoch alle Pakete auf einmal installieren, und Lazarus wird die Kompilierreihenfolge selbst verwalten. Dazu müssen Sie:

1. in Lazarus “Paket” -> “ Paketdatei (.lpk) öffnen” auswählen;
2. alle gewünschten Pakete markieren und auf “Öffnen” klicken;
3. “Paket” -> “Pakete installieren/löschen” auswählen;
4. In der Spalte "Zur Installation verfügbar“(rechts) die gewünschten Pakete auswählen;
5. Auf “ Speichern und IDE neu starten” klicken.

Vor Version 2.0.0 traten sehr häufig Kompilierungs- und (oder) Installationsfehler auf. Zum Zeitpunkt der Erstellung dieses Dokuments ist die neueste Version 2.2.6 erschienen und wir haben diese Fehler in Lazarus noch nicht vollständig behoben, aber ihre Wahrscheinlichkeit stark reduziert.

Wenn eines Ihrer Pakete nicht kompiliert oder installiert werden kann, müssen Sie nach unten gehen und die Abhängigkeiten des Pakets neu kompilieren oder neu installieren.

Installationsfenster

Doppelklicken Sie dazu auf das gewünschte Paket, kompilieren Sie es neu und installieren Sie es anschließend erneut.

Klicken Sie nach der erfolgreichen Installation aller Pakete auf Projekt (Project) -> Projekt öffnen (Open Project) und öffnen Sie das fast-report\LDemo\FRDemo.lpi-Projekt und versuchen Sie es auszuführen, dann klicken Sie auf Design.

Wenn unter Linux ein negativeк Höhenfehler wie unten dargestellt auftritt, machen Sie sich keine Sorgen:

Negativer Höhenfehler

In einigen seltenen GTK-Schnittstellen kann dieser Bug auftreten. Führen Sie die Anwendung einfach ohne Debugging aus oder aktivieren Sie das Kontrollkästchen „Diesen Ausnahmentyp ignorieren“.

*Oder wechseln Sie die grafische Shell. In der GTK-Shell von KDE Plasma tritt dieser Fehler zum Beispiel nicht auf.

Eine letzte Kleinigkeit, die Sie bei der Erstellung Ihrer Projekte wissen sollten, ist, dass unser Designer Multithreading verwendet, welches standardmäßig in Linux Lazarus deaktiviert ist. Um es zu aktivieren, öffnen Sie die Datei mit der .lpr-Erweiterung im Projektinspektor (Projekt -> Projektinspektor) und fügen sie die cthreads Einheit zum ersten Punkt in uses hinzu.