Criando um Instalador MSI em C# com IronBarCode

Quais são os pré-requisitos para começar?

Antes de iniciar o projeto, por favor baixe a extensão Microsoft Visual Studio Installer Projects para que a construção do MSI funcione. Além disso, certifique-se de ter instalado o IronBarCode via NuGet no seu projeto.

Como Crio o Projeto Inicial do Instalador MSI?

Para este exemplo, use um projeto Windows Forms App (.NET Framework) para demonstrar sua funcionalidade. Esta abordagem fornece um paradigma de interface gráfica familiar para aplicativos de escaneamento de código de barras para desktop.

Como Adiciono um Botão ao Formulário do Windows?

• Navegue até a Caixa de Ferramentas
• Procure por Botão
• Adicione o botão arrastando e soltando no formulário do Windows

Como Edito o Código do Botão para Lidar com Escaneamento de Código de Barras?

Dê um duplo clique no componente do botão para acessar o código C# do formulário. Abaixo está a lógica para o componente de formulário—ele recebe um código de barras e tenta escaneá-lo. Este código escaneia apenas imagens e não funciona para PDFs. Use o método ReadPdf para documentos PDF. Para opções abrangentes de leitura de códigos de barras, consulte a documentação de configurações do leitor de códigos de barras.

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
}

Como adiciono um projeto de instalação para criar o MSI?

Após configurar o formulário e sua lógica de controlador, adicione um projeto de instalação à solução existente para criar um instalador MSI. O projeto de instalação permite que você crie um instalador para o aplicativo que acabou de criar. Esse processo empacota todos os componentes necessários, incluindo as dependências do IronBarCode, em uma única unidade implantável.

Clique com o botão direito do mouse na solução e depois vá para Adicionar > Novo Projeto...

Para o instalador MSI, compile novamente o projeto MsiInstallerSample no modo Release. Clique com o botão direito do mouse no projeto de instalação e depois vá para Adicionar > Saída do Projeto...

Para garantir que o instalador MSI funcione sem problemas, você deve incluir os seguintes três arquivos em seu projeto de instalação: onnxruntime.dll, IronBarcodeInterop.dll e ReaderInterop.dll. Esses arquivos são gerados quando você compila o projeto no modo Release:

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

Se algum desses arquivos estiver faltando, você poderá enfrentar a seguinte mensagem de exceção, conforme observado neste artigo de solução de problemas: Falta de DLLs ao Criar Instalador MSI

Por fim, compile o projeto de instalação. O instalador estará localizado em: MsiInstallerSample\SetupProject\Release

Como executo e testo o instalador MSI?

Instale o aplicativo com o arquivo MSI para garantir que tudo funcione sem problemas. Os testes devem cobrir tanto cenários de instalação quanto de desinstalação para verificar a implantação correta.

Onde Posso Baixar o Projeto de Exemplo Completo?

Você pode baixar o código completo para este guia. Ele vem como um arquivo zipado que você pode abrir no Visual Studio como um projeto WinFormApp. O exemplo inclui todas as configurações necessárias e demonstra as melhores práticas para implantação MSI.

Baixe o Projeto WinForm MSI App