Creating a MSI Installer with IronBarCode

Voraussetzungen

Bevor wir mit dem Projekt beginnen, laden Sie bitte die [Microsoft Visual Studio Installer Projects-Erweiterung] https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2022InstallerProjects) herunter, damit der MSI-Build funktioniert.

Einen MSI-Installer erstellen

Wir verwenden ein Windows-Forms-App-Projekt (.NET Framework), um seine Funktionalität für dieses Beispiel zu demonstrieren.

Einen Button hinzufügen

• Navigieren Sie zur Werkzeugkiste
• Suchen Sie nach Button
• Fügen Sie den Button durch Ziehen und Ablegen in das Windows-Formular ein.

Den Button-Code bearbeiten

Doppelklicken Sie auf die Schaltflächenkomponente, um auf den C#-Code des Formulars zuzugreifen. Unten ist die Logik für die Formular-Komponente, sie nimmt einen Barcode auf und versucht ihn zu scannen. Dieser Code scannt nur Bilder und funktioniert nicht für PDF. Verwenden Sie die Methode ReadPdf für PDF-Dokumente.

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

Ein Setup-Projekt hinzufügen

Nach dem Einrichten des Formulars und seiner Steuerungslogik müssen wir ein Setup-Projekt zur bestehenden Lösung hinzufügen, um einen MSI-Installer zu erstellen. Das Setup-Projekt ermöglicht uns den Bau eines Installers für die Anwendung, die wir gerade erstellt haben.

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 in MsiInstallerSample\MsiInstallerSample\bin\Release
• IronBarcodeInterop.dll: befindet sich in MsiInstallerSample\MsiInstallerSample\bin\Release\runtimes\win-x86\native
• ReaderInterop.dll: befindet sich in MsiInstallerSample\MsiInstallerSample\bin\Release\runtimes\win-x86\native

Wenn eine dieser Dateien fehlt, können Sie die folgende Fehlermeldung erhalten, wie in diesem Troubleshooting-Artikel beschrieben: Fehlende DLLs beim Erstellen des MSI-Installers

Schließlich bauen Sie das Setup-Projekt auf. Der Installer befindet sich unter: MsiInstallerSample\SetupProject\Release

Den Installer ausführen & testen

Wir installieren die Anwendung mit der MSI-Datei, um sicherzustellen, dass alles reibungslos läuft.

Beispielprojekt für den MSI-Installer 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.

Laden Sie das WinForm MSI App-Projekt herunter