Tworzenie instalatora MSI w języku C# za pomocą IronBarcode

Jakie warunki wstępne muszę spełnić przed rozpoczęciem pracy?

Przed rozpoczęciem projektu prosimy o pobranie rozszerzenia Microsoft Visual Studio Installer Projects aby kompilacja MSI działała. Dodatkowo upewnij się, że w swoim projekcie zainstalowałeś IronBarcode za pośrednictwem NuGet.

Jak utworzyć wstępny projekt instalatora MSI?

W tym przykładzie należy wykorzystać projekt aplikacji Windows Forms (.NET Framework) w celu zademonstrowania jego funkcjonalności. Takie podejście zapewnia znany paradygmat interfejsu użytkownika dla aplikacji do skanowania kodów kreskowych na komputerach stacjonarnych.

Jak dodać przycisk do formularza Windows Form?

• Przejdź do ToolBox
• Przycisk wyszukiwania
• Dodaj przycisk, przeciągając go i upuszczając na formularz Windows

Jak edytować kod przycisku, aby obsługiwał skanowanie BarCode'ów?

Kliknij dwukrotnie na komponent przycisku, aby uzyskać dostęp do kodu C# formularza. Poniżej znajduje się logika komponentu formularza — pobiera on BarCode i próbuje go zeskanować. Ten kod skanuje wyłącznie obrazy i nie działa w przypadku plików PDF. Użyj metody ReadPdf dla dokumentów PDF. Aby uzyskać informacje na temat wszystkich opcji odczytu kodów kreskowych, zapoznaj się z dokumentacją dotyczącą ustawień czytnika kodów kreskowych.

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}");
                    }
                }
            }
        }
    }
}

Imports IronBarCode
Imports IronSoftware.Drawing
Imports System
Imports System.Drawing
Imports System.Windows.Forms

Namespace MsiInstallerSample
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub button1_Click(sender As Object, e As EventArgs) Handles button1.Click
            IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.All
            IronSoftware.Logger.LogFilePath = "Default.log"

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

            Using openFileDialog As New OpenFileDialog()
                openFileDialog.Filter = "Image files (All files (*.*)|*.*"

                If openFileDialog.ShowDialog() = DialogResult.OK Then
                    Try
                        ' Load the selected image
                        Using bmp As New Bitmap(openFileDialog.FileName)
                            ' Process the image
                            Dim anyBitmap As AnyBitmap = AnyBitmap.FromBitmap(bmp)

                            ' Configure barcode reader options (customize as needed)
                            Dim option As New BarcodeReaderOptions With {
                                .Speed = ReadingSpeed.Detailed,
                                .ExpectMultipleBarcodes = True,
                                .ScanMode = BarcodeScanMode.Auto
                            }

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

                            If result.Count > 0 Then
                                Dim output As String = String.Empty
                                For Each barcode In result
                                    Console.WriteLine($"Barcode Found: {barcode.Text}")
                                    output += barcode.Text & vbCrLf
                                Next

                                MessageBox.Show($"Detected Barcodes: {vbCrLf}{output}")
                            Else
                                MessageBox.Show("No Barcode found.")
                            End If
                        End Using
                    Catch ex As Exception
                        MessageBox.Show($"{ex.Message}")
                    End Try
                End If
            End Using
        End Sub
    End Class
End Namespace

// 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
}

' For PDF documents, use ReadPdf method
If Path.GetExtension(openFileDialog.FileName).ToLower() = ".pdf" Then
    Dim pdfResults = BarcodeReader.ReadPdf(openFileDialog.FileName, option)
    ' Process PDF results similar to image results
End If

Jak dodać projekt instalacyjny, aby utworzyć plik MSI?

Po skonfigurowaniu formularza i logiki kontrolera dodaj projekt Setup Project do istniejącego rozwiązania, aby utworzyć instalator MSI. Projekt Setup pozwala na stworzenie instalatora dla właśnie utworzonej aplikacji. Proces ten łączy wszystkie niezbędne komponenty, w tym zależności IronBarcode, w jedną jednostkę gotową do wdrożenia.

Kliknij prawym przyciskiem myszy na rozwiązanie, a następnie przejdź do Dodaj > Nowy projekt...

W przypadku instalatora MSI należy ponownie skompilować projekt MsiInstallerSample w trybie Release. Kliknij prawym przyciskiem myszy na projekt Setup, a następnie przejdź do Add > Project Output...

Aby zapewnić płynne działanie instalatora MSI, musisz uwzględnić następujące trzy pliki w swoim projekcie instalacyjnym: onnxruntime.dll, IronBarcodeInterop.dll, i ReaderInterop.dll. Pliki te są generowane podczas kompilacji projektu w trybie Release:

• onnxruntime.dll: Zlokalizowany w MsiInstallerSample\MsiInstallerSample\bin\Release
• IronBarcodeInterop.dll: Zlokalizowany w MsiInstallerSample\MsiInstallerSample\bin\Release\runtimes\win-x86\native
• ReaderInterop.dll: Zlokalizowany w MsiInstallerSample\MsiInstallerSample\bin\Release\runtimes\win-x86\native

Jeśli którykolwiek z tych plików zostanie pominięty, może pojawić się następujący komunikat o wyjątku, jak opisano w tym artykule dotyczącym rozwiązywania problemów: Brakujące biblioteki DLL podczas tworzenia instalatora MSI

Na koniec skompiluj projekt instalacyjny. Instalator będzie zlokalizowany pod adresem: MsiInstallerSample\SetupProject\Release

Jak uruchomić i przetestować instalator MSI?

Zainstaluj aplikację za pomocą pliku MSI, aby upewnić się, że wszystko działa płynnie. Testy powinny obejmować zarówno scenariusze instalacji, jak i deinstalacji, aby zweryfikować poprawne wdrożenie.

Gdzie mogę pobrać kompletny projekt przykładowy?

Możesz pobrać pełny kod do tego przewodnika. Jest dostępny jako plik zip, który możesz otworzyć w Visual Studio jako projekt WinFormApp. Przykład zawiera wszystkie niezbędne konfiguracje i demonstruje najlepsze praktyki dla wdrożenia MSI.

Pobierz projekt aplikacji WinForm MSI