Handhabung von FastReport Avalonia auf .NET 8 in Visual Studio Code for Linux

Wir setzen die Reihe von Artikeln über die Arbeit mit FastReport Avalonia in Visual Studio Code auf verschiedenen Betriebssystemen fort. In diesem Artikel erfahren Sie, wie Sie Avalonia FastReport auf einem Linux-Betriebssystem mit der Visual Studio Code-IDE ausführen.

Avalonia UI ist ein .NET-basiertes Framework, das aktiv zur Entwicklung plattformübergreifender Benutzeroberflächen eingesetzt wird. Mit seiner universellen API zur Erstellung von Anwendungen unterstützt Avalonia alle wichtigen Plattformen und Ablaufumgebungen und verfügt über eine eigene, einzigartige Schnittstelle. So sehen Ihre Geschäftslösungen auf jedem Betriebssystem identisch aus.

FastReport Avalonia enthält eine leistungsstarke Datenverarbeitungs-Engine, einen vertrauten Berichtsdesigner und einen Viewer für vorgefertigte Berichte. Das neue Produkt bietet auch alle Exportformate für generierte Berichte: PDF, Excel, MS Word und viele andere.

Die Bibliothek ist vollständig mit FastReport WPF, FastReport .NET, FastReport Mono abwärtskompatibel und unterstützt Avalonia UI, .NET 7 und .NET 8.

Vorbereitende Phase 

Als erstes müssen Sie Visual Studio Code installieren. Dazu gehen Sie auf die offizielle Website und laden Sie die neueste Version von Visual Studio Code herunter. 

Der nächste Schritt ist die Installation von .NET 8 selbst. Dazu können Sie auf die offizielle Microsoft-Website gehen und das Installationsprogramm für Linux herunterladen.

Für die weitere Arbeit müssen Sie die Avalonia-Vorlagen installieren. Dazu öffnen Sie die Konsole und geben Sie den folgenden Befehl ein:

dotnet new install Avalonia.Templates

Öffnen Sie anschließend Visual Studio Code und konfigurieren Sie es. Gehen Sie auf die Registerkarte „Extentions”. Sie müssen .NET Install Toll, Avalonia for Visual Studio Code und C# installieren.

Nachdem Sie die erforderlichen Erweiterungen installiert haben, müssen Sie einen privaten NuGet-Server verbinden, um die erforderlichen FastReport-Pakete zu installieren. Wie Sie den privaten NuGet-Server nutzen können, erfahren Sie unter diesem Link.

Wenn Sie diese Schritte abgeschlossen haben, können Sie mit der Projekterstellung beginnen.

Projekterstellung 

Öffnen Sie Visual Studio Code und erstellen Sie ein Avalonia-Projekt. Da wir die notwendigen Vorlagen und Erweiterungen heruntergeladen haben, verfügen wir über die Schaltfläche “Create Avalonia Project”. Klicken Sie darauf. Als nächstes wählen Sie Avalonia App und geben Sie dem Projekt einen Namen. Nennen Sie es FastReportAvalonia. Wählen Sie das Verzeichnis, in dem das Projekt gespeichert werden soll.

Nach dem Erstellen des Projekts tritt möglicherweise ein Fehler bei der Installation von .NET 8 im Projekt auf. Der Fehler kann wie folgt behoben werden:
1) Klicken Sie im Fehlerfenster auf “Configure Manager”;
2) Geben Sie explizit den Pfad zu .NET 8 an, zum Beispiel: /usr/share/dotnet/dotnet.

Verschiedene Distributionen können unterschiedliche Speicherpfade für .NET 8 haben, berücksichtigen Sie dies in Ihrem Projekt.

Danach müssen Sie die FastReport-Pakete verbinden. Gehen Sie dazu zur .csproj-Datei und fügen Sie folgendes hinzu:

<PackageReference Include=”FastReport.Avalonia” Version=”2024.1.9” />
<PackageReference Include=”FastReport.Forms.Avalonia” Version=”2024.1.9” />

Ihre Datei sollte etwa so aussehen:

Gehen Sie dann zur MainWindow.axaml-Datei und fügen Sie die Schaltfläche hinzu.

<Button Click =”ButtonClicked”> Start </Button>

Der Code in der Datei sollte etwa so aussehen:

Der nächste Schritt besteht darin, die Logik für die Schaltfläche zu schreiben. Gehen Sie dazu in die MainWindow.axaml.cs-Datei und erstellen Sie das Ereignis.

using FastReport;
…..
public void ButtonClicked(object source, RoutedEventArgs args)
{
 Report report = new Report();
 report.Load(“Отчет.frx”);
 report.Design();
}

Jetzt können Sie Ihre Anwendung ausführen. Zum Debuggen sollte .NET 5+ verwendet werden. Nach dem Starten erscheint ein Fenster mit der Start-Schaltfläche. Klicken Sie darauf und der Designer wird gestartet.

Wir können auch die Vorschau aktivieren und uns den Bericht in der Vorschau ansehen.

So haben wir es geschafft, FastReport Avalonia unter Linux mit Visual Studio Code auszuführen. Wie Sie sehen können, ist es absolut nicht kompliziert zu starten und zu konfigurieren. Installieren Sie einfach die SDK-Pakete, konfigurieren Sie die privaten NuGet-Pakete und schon können Sie FastReport Avalonia nutzen. Wenn Sie Fragen haben, kontaktieren Sie bitte unseren technischen Support unter support@fast-report.com. Viel Spaß bei der Nutzung!