Handhabung von FastReport Avalonia auf .NET 8 in Visual Studio für Mac

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.

In diesem Artikel wird detailliert beschrieben, wie FastReport Avalonia auf dem macOS Betriebssystem mit Visual Studio IDE ausgeführt wird.

Vorbereitende Phase 

Als erstes müssen Sie Visual Studio für Mac installieren. Für die weitere Arbeit mit den Avalonia-Vorlagen ist eine bestimmte Version von Visual Studio erforderlich, nämlich 17.6.10. Diese Version können Sie unter folgendem Link herunterladen. Sie können die Unterstützung von .NET 8 darin aktivieren, wir werden das weiter unten noch genauer betrachten.

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 MacOS herunterladen.

Nach der Installation von SDK 8.0 müssen Sie Visual Studio konfigurieren. Um mit .NET 8 arbeiten zu können, müssen Sie seine Verwendung in Visual Studio aktivieren. Klicken Sie dazu mit der rechten Maustaste auf Visual Studio und wählen Sie “Preferences” aus.

Scrollen Sie im sich nun öffnenden Fenster ganz nach unten zum “Preview Features” und aktivieren Sie das Kontrollkästchen “Use the .NET 8 SDK…”.

Klicken Sie auf „OK“ und starten Sie Visual Studio neu.

Nachdem Sie die oben genannten Schritte durchgeführt haben, müssen Sie die Avalonia-Vorlagen für die weitere Arbeit installieren. Nach der Installation können Sie in Visual Studio vorgefertigte Vorlagen auswählen, um die weitere Entwicklung zu vereinfachen. Dazu müssen Sie die Konsole öffnen und den folgenden Befehl eingeben:

dotnet new install Avalonia.Templates

Jetzt können Sie mit der Projekterstellung in Visual Studio beginnen.

Erstellung einer Anwendung 

Starten Sie Visual Studio und erstellen Sie ein Projekt. Scrollen Sie bei der Auswahl einer Vorlage nach unten zur Gruppe “Other” und wählen Sie “Custom” aus. Wählen Sie im Fenster die Avalonia .NET-App aus. Dies sind genau die Vorlagen, die Sie über den Konsolenbefehl installiert haben. Klicken Sie auf Continue.

Als nächstes werden die Vorlagen konfiguriert. Wählen Sie die .NET- und Avalonia-Version aus. Wir empfehlen, die Avalonia-Version 11.1.0 -betta und höher auszuwählen, da darin viele visuelle Fehler behoben wurden. In unserem Beispiel wählen wir die .NET-Version 8 aus. Klicken Sie auf “Continue”. 

Sie verfügen jetzt über ein Avalonia-Vorlagenprojekt in Visual Studio. Als nächstes müssen Sie einen privaten NuGet-Server verbinden, von dem Sie NuGet-Pakete von Avalonia beziehen können. Klicken Sie dazu mit der rechten Maustaste auf Ihr Projekt und wählen Sie “Manage NuGet Packages…” aus.

In dem nun erscheinenden Fenster steht ganz am Ende „Package source: All sources“. Erweitern Sie die Liste und klicken Sie auf “Configure Sources…”.

In dem nun erscheinenden Fenster klicken Sie auf “Add”. Es erscheint ein Fenster zum Eintragen der Daten.
- Name: Name der Quelle ohne Leerzeichen (zum Beispiel FastReport-Nuget);
- Location: https://nuget.fast-report.com/api/v3/index.json;
- Username: E-Mail vom Fast Reports-Konto;
- Password: Passwort für Fast Reports-Konto.

Nachdem Sie alle erforderlichen Daten eingegeben haben, können Sie das Fenster schließen. Jetzt verfügen Sie über einen privaten NuGet-Server, den Sie verwenden können.

Der nächste Schritt besteht darin, die notwendigen Pakete für das Projekt hinzuzufügen, nämlich: FastReport.Avalonia und FastReport.Forms.Avalonia.

Wählen Sie dazu im Fenster „NuGet-Pakete“ unseren privaten NuGet-Server als Quelle aus. Der Einfachheit halber geben Sie in das Suchfeld “Avalonia” ein, um Pakete mit dem entsprechenden Namen zu finden. Wählen Sie die gewünschten Pakete aus, installieren Sie diese.

Nachdem Sie nun das Projekt konfiguriert haben, können Sie beginnen den Code zu schreiben. Betrachten wir als Nächstes ein einfaches Beispiel, das die Leistungsfähigkeit der FastReport Avalonia-Pakete demonstriert. Öffnen Sie zunächst die Datei MainWindow.axaml.cs und füllen Sie sie wie folgt aus:

using Avalonia.Controls;
using Avalonia.Interactivity;
using FastReport;
namespace FRAvalonia;
public partial class MainWindow : Window
{
 public MainWindow()
 {
 InitializeComponent();
 }
 public void ButtonClicked(object source, RoutedEventArgs args)
 {
 Report report = new Report();
 report.Load("Barcode.frx");
 report.Design();
 }
}

Bisher haben wir hier lediglich eine Methode zur Bearbeitung der Schaltfläche hinzugefügt und angegeben, welcher Bericht im Designer geöffnet wird.

Gehen Sie dann zu MainWindow.axaml und füllen Sie es wie folgt aus:

<Window xmlns="https://github.com/avaloniaui"
 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
 xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
 xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
 mc:Ignorable="d" d:DesignWidth="800" d:DesignHeight="450"
 x:Class="FRAvalonia.MainWindow"
 Title="FRAvalonia">
 <Button Click="ButtonClicked" >Start Designer!</Button>
</Window>

Fügen Sie anschließend die Schaltfläche selbst hinzu, die bereits über einen Handler verfügt. Jetzt können Sie das Projekt starten.

Wenn Sie das Projekt starten, werden Sie ein Fenster mit einer Schaltfläche sehen, klicken Sie darauf. Dies ist, wo die Magie passiert, FastReport Designer wird in Avalonia gestartet.

Sie können auch die Vorschau aktivieren und sich den Bericht in der Vorschau anzeigen lassen.

So haben wir es geschafft, FastReport Avalonia unter macOS mit Visual Studio 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!