Erstellen eines C# MSI-Installers mit IronBarCode

Welche Voraussetzungen brauche ich, bevor ich anfange?

Bevor Sie mit dem Projekt beginnen, laden Sie bitte die Microsoft Visual Studio Installer Projects extension herunter, damit der MSI-Build funktioniert. Stellen Sie außerdem sicher, dass Sie IronBarCode über NuGet in Ihrem Projekt installiert haben.

Wie erstelle ich das MSI-Installer-Projekt?

Verwenden Sie für dieses Beispiel ein Windows Forms App (.NET Framework) Projekt, um dessen Funktionalität zu demonstrieren. Dieser Ansatz bietet ein vertrautes UI-Paradigma für Desktop-Barcodescan-Anwendungen.

Wie füge ich eine Schaltfläche zu einem Windows-Formular hinzu?

• Navigieren Sie zur Werkzeugkiste
• Suchen Sie nach Button
• Hinzufügen der Schaltfläche durch Ziehen und Ablegen auf das Windows-Formular

Wie bearbeite ich den Code der Schaltfläche, um das Scannen von Barcodes zu ermöglichen?

Doppelklicken Sie auf die Schaltflächenkomponente, um auf den C#-Code des Formulars zuzugreifen. Im Folgenden ist die Logik für die Formularkomponente dargestellt - sie nimmt einen Barcode auf und versucht, ihn zu scannen. Dieser Code scannt nur Bilder und funktioniert nicht für PDFs. Verwenden Sie die Methode ReadPdf für PDF-Dokumente. Umfassende Optionen zum Lesen von Barcodes finden Sie in der Dokumentation der Barcode-Leseeinstellungen.

using IronBarCode;
using IronSoftware.Drawing;
using System;
using System.Drawing;
using System.Windows.Forms;

namespace MsiInstallerSample
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.All;
            IronSoftware.Logger.LogFilePath = "Default.log";

            IronBarCode.License.LicenseKey = "IRONBARCODE-MYLICENSE-KEY-1EF01";

            using (OpenFileDialog openFileDialog = new OpenFileDialog())
            {
                openFileDialog.Filter = "Image files (All files (*.*)|*.*";

                if (openFileDialog.ShowDialog() == DialogResult.OK)
                {
                    try
                    {
                        // Load the selected image
                        using (Bitmap bmp = new Bitmap(openFileDialog.FileName))
                        {
                            // Process the image
                            AnyBitmap anyBitmap = AnyBitmap.FromBitmap(bmp);

                            // Configure barcode reader options (customize as needed)
                            var option = new BarcodeReaderOptions
                            {
                                Speed = ReadingSpeed.Detailed,
                                ExpectMultipleBarcodes = true,
                                ScanMode = BarcodeScanMode.Auto,
                            };

                            BarcodeResults result = IronBarCode.BarcodeReader.Read(anyBitmap, option);

                            if (result.Count > 0)
                            {
                                string output = string.Empty;
                                foreach(var barcode in result)
                                {
                                    Console.WriteLine($"Barcode Found: {barcode.Text}");
                                    output += barcode.Text + "\n";
                                }

                                MessageBox.Show($"Detected Barcodes: \n{output}");
                            }
                            else
                            {
                                MessageBox.Show("No Barcode found.");
                            }
                        }
                    }
                    catch (Exception ex)
                    {
                        MessageBox.Show($"{ex.Message}");
                    }
                }
            }
        }
    }
}

using IronBarCode;
using IronSoftware.Drawing;
using System;
using System.Drawing;
using System.Windows.Forms;

namespace MsiInstallerSample
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.All;
            IronSoftware.Logger.LogFilePath = "Default.log";

            IronBarCode.License.LicenseKey = "IRONBARCODE-MYLICENSE-KEY-1EF01";

            using (OpenFileDialog openFileDialog = new OpenFileDialog())
            {
                openFileDialog.Filter = "Image files (All files (*.*)|*.*";

                if (openFileDialog.ShowDialog() == DialogResult.OK)
                {
                    try
                    {
                        // Load the selected image
                        using (Bitmap bmp = new Bitmap(openFileDialog.FileName))
                        {
                            // Process the image
                            AnyBitmap anyBitmap = AnyBitmap.FromBitmap(bmp);

                            // Configure barcode reader options (customize as needed)
                            var option = new BarcodeReaderOptions
                            {
                                Speed = ReadingSpeed.Detailed,
                                ExpectMultipleBarcodes = true,
                                ScanMode = BarcodeScanMode.Auto,
                            };

                            BarcodeResults result = IronBarCode.BarcodeReader.Read(anyBitmap, option);

                            if (result.Count > 0)
                            {
                                string output = string.Empty;
                                foreach(var barcode in result)
                                {
                                    Console.WriteLine($"Barcode Found: {barcode.Text}");
                                    output += barcode.Text + "\n";
                                }

                                MessageBox.Show($"Detected Barcodes: \n{output}");
                            }
                            else
                            {
                                MessageBox.Show("No Barcode found.");
                            }
                        }
                    }
                    catch (Exception ex)
                    {
                        MessageBox.Show($"{ex.Message}");
                    }
                }
            }
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

// For PDF documents, use ReadPdf method
if (Path.GetExtension(openFileDialog.FileName).ToLower() == ".pdf")
{
    var pdfResults = BarcodeReader.ReadPdf(openFileDialog.FileName, option);
    // Process PDF results similar to image results
}

// For PDF documents, use ReadPdf method
if (Path.GetExtension(openFileDialog.FileName).ToLower() == ".pdf")
{
    var pdfResults = BarcodeReader.ReadPdf(openFileDialog.FileName, option);
    // Process PDF results similar to image results
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Wie füge ich ein Setup-Projekt hinzu, um die MSI zu erstellen?

Nach dem Einrichten des Formulars und seiner Steuerungslogik fügen Sie der vorhandenen Lösung ein Setup-Projekt hinzu, um ein MSI-Installationsprogramm zu erstellen. Mit dem Setup-Projekt können Sie ein Installationsprogramm für die gerade erstellte Anwendung erstellen. Bei diesem Prozess werden alle erforderlichen Komponenten, einschließlich der IronBarCode-Abhängigkeiten, in einer einzigen einsatzfähigen Einheit zusammengefasst.

Rechtsklicken Sie auf die Lösung und gehen Sie zu Hinzufügen > Neues Projekt...

Für den MSI-Installer bauen Sie das Projekt MsiInstallerSample erneut im Release-Modus. Rechtsklicken Sie auf das Setup-Projekt und gehen Sie zu Hinzufügen > Projektausgabe...

Um sicherzustellen, dass der MSI-Installer reibungslos läuft, müssen Sie die folgenden drei Dateien in Ihr Setup-Projekt einschließen: onnxruntime.dll, IronBarcodeInterop.dll und ReaderInterop.dll. Diese Dateien werden generiert, wenn Sie das Projekt im Release-Modus aufbauen:

• onnxruntime.dll: Befindet sich unter MsiInstallerSample\MsiInstallerSample\bin\Release
• IronBarcodeInterop.dll: Befindet sich unter MsiInstallerSample\MsiInstallerSample\bin\Release\runtimes\win-x86\native
• ReaderInterop.dll: Befindet sich unter MsiInstallerSample\MsiInstallerSample\bin\Release\runtimes\win-x86\native

Wenn eine dieser Dateien fehlt, können Sie die folgende Ausnahmemeldung erhalten, wie in diesem Artikel zur Fehlerbehebung beschrieben: Fehlende DLLs beim Erstellen des MSI-Installationsprogramms

Schließlich bauen Sie das Setup-Projekt auf. Das Installationsprogramm wird unter folgender Adresse zu finden sein: MsiInstallerSample\SetupProject\Release

Wie kann ich das MSI-Installationsprogramm ausführen und testen?

Installieren Sie die Anwendung mit der MSI-Datei, um sicherzustellen, dass alles reibungslos abläuft. Die Tests sollten sowohl Installations- als auch Deinstallationsszenarien abdecken, um die ordnungsgemäße Bereitstellung zu überprüfen.

Wo kann ich das vollständige Beispielprojekt herunterladen?

Sie können den vollständigen Code für dieses Handbuch herunterladen. Er wird als gezippte Datei geliefert, die Sie in Visual Studio als WinFormApp-Projekt öffnen können. Das Beispiel enthält alle notwendigen Konfigurationen und demonstriert die besten Praktiken für die MSI-Bereitstellung.

Laden Sie das WinForm MSI App-Projekt herunter