使用 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 表單上，即可新增按鈕。

Visual Studio 工具箱中"所有 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 依賴項）打包到一個可部署的單元中。

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

Visual Studio 解決方案資源管理器上下文功能表顯示"新增">"新項目"選項，用於建立安裝項目

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

Visual Studio 新增專案輸出群組對話方塊顯示 SetupProject 的部署選項，並可見解決方案資源管理器。

為確保 MSI 安裝程式順利運行，您必須在安裝專案中包含以下三個檔案： onnxruntime.dll 、 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

在 Visual Studio 檔案對話方塊中選擇 ReaderInterop.dll 以新增至安裝項目，並在解決方案資源管理器中顯示依賴項

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

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

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

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

Visual Studio 顯示已完成的安裝程式構建，其中包含 Release 資料夾以及 setup.exe 和安裝程式檔案。

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

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

下載 WinForm MSI 應用程式項目