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

先決條件

在開始專案之前，請下載[Microsoft Visual Studio Installer Projects 擴充功能]( 要讓 MSI 建置正常運作，需要從 https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2022InstallerProjects 取得該專案。

建立 MSI 安裝程式

在本範例中，我們將使用 Windows Forms 應用程式 (.NET Framework) 專案來示範其功能。

新增按鈕

• 導航至工具箱 搜尋按鈕
• 將按鈕拖曳到視窗窗體上。

！新增按鈕

編輯按鈕程式碼

雙擊按鈕元件以存取窗體的 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}");
                    }
                }
            }
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

新增安裝項目

設定好表單及其控制器邏輯後，我們需要為現有解決方案新增一個安裝項目來建立 MSI 安裝程式。 安裝專案允許我們為剛剛建立的應用程式建立安裝程式。

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

！新增安裝項目

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

！新增項目輸出

為確保 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

新增其他 DLL 文件

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

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

運行並測試安裝程序

我們使用 MSI 檔案安裝應用程序，以確保一切運作順暢。

下載 MSI 安裝程式範例項目

您可以下載本指南的完整程式碼。程式碼以壓縮檔案的形式提供，您可以在 Visual Studio 中將其作為 WinFormApp 專案開啟。

下載 WinForm MSI 應用程式項目