使用IronBarcode建立 C# MSI 安裝程序

開始之前我需要具備哪些先決條件？

在開始專案之前，請下載[Microsoft Visual Studio Installer Projects 擴充功能]( 要讓 MSI 建置正常運作，需要從 https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2022InstallerProjects 取得該專案。 此外，請確保已透過NuGet在您的專案中安裝了IronBarcode 。

如何建立初始 MSI 安裝程式專案？

在這個範例中，使用 Windows Forms 應用程式 (.NET Framework) 專案來示範其功能。 這種方法為桌面條碼掃描應用程式提供了一種熟悉的使用者介面範式。

如何在 Windows 表單中新增按鈕？

• 導航至工具箱 搜尋按鈕
• 將按鈕拖曳到 Windows 表單上，即可新增按鈕。

如何編輯按鈕代碼以支援條碼掃描？

雙擊按鈕元件即可存取窗體的 C# 程式碼。 以下是表單元件的邏輯——它接收條碼並嘗試掃描它。 這段程式碼只能掃描影像，不能掃描PDF檔。 對 PDF 文件使用 ReadPdf 方法。 有關完整的條碼讀取選項，請參閱條碼讀取器設定文件。

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

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

如何新增安裝專案以建立 MSI 檔案？

設定好表單及其控制器邏輯後，請向現有解決方案新增安裝項目以建立 MSI 安裝程式。 安裝專案可讓您為剛剛建立的應用程式建立安裝程式。 此程序將所有必要的元件(包括IronBarcode依賴項)打包到一個可部署的單元中。

右鍵單擊解決方案，然後選擇"新增" > "新專案..."

對於 MSI 安裝程序，請在 Release 模式下再次建置 MsiInstallerSample 專案。 右鍵單擊"設定項目"，然後選擇"新增" > "項目輸出…"

為確保 MSI 安裝程式順利運行，您必須在安裝專案中包含以下三個檔案：IronBarcodeInterop.dll 和 ReaderInterop.dll。 這些文件是在以發布模式建立專案時產生的：

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

如果缺少任何這些文件，您可能會遇到以下異常訊息，如這篇故障排除文章所述：在建立 MSI 安裝程式時缺少 DLL 文件

最後，建置安裝專案。 安裝程式位於：MsiInstallerSample\SetupProject\Release

如何運行和測試 MSI 安裝程式？

請使用 MSI 檔案安裝應用程序，以確保一切順利運行。 測試應涵蓋安裝和卸載兩種場景，以驗證部署是否正確。

在哪裡可以下載完整的範例專案？

您可以下載本指南的完整程式碼。程式碼以壓縮檔案的形式提供，您可以在 Visual Studio 中將其作為 WinFormApp 專案開啟。 此範例包含所有必要的配置，並示範了 MSI 部署的最佳實務。

下載 WinForm MSI 應用程式項目