IronBarcode ile C# MSI Yükleyicisi Oluşturma

Başlamadan Önce Hangi Gereksinimlere İhtiyacım Var?

Projeye başlamadan önce, lütfen [Microsoft Visual Studio Installer Projects eklentisini] indirin MSI derlemesinin çalışması için, https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2022InstallerProjects URL'sine bakabilirsiniz. Ayrıca, projenizde IronBarcode'un NuGet üzerinden yüklü olduğundan emin olun.

Başlangıç MSI Yükleyici Projesini Nasıl Oluştururum?

Bu örnek için fonksiyonelliği göstermek üzere Windows Forms App (.NET Framework) projesi kullanın. Bu yaklaşım, masaüstü barkod okuma uygulamaları için aşina bir UI paradigması sağlar.

Windows Formuna Buton Nasıl Eklenir?

• ToolBox adresine gidin
• Button'yi ara
• Butonu sürükleyip Windows formuna bırakarak ekleyin

Buton Kodunu Bir Barkod Tarama İşlemini Yönetmek İçin Nasıl Düzenlerim?

Formun C# koduna erişmek için buton bileşenine çift tıklayın. Form bileşeni için mantık aşağıda verilmiştir - bir barkod alır ve taramaya çalışır. Bu kod yalnızca görüntüleri tarar ve PDF'ler için çalışmaz. PDF belgeleri için ReadPdf yöntemini kullanın. Kapsamlı barkod okuma seçenekleri için, barkod okuyucu ayarları belgelerine bakın.

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

MSI'de Oluşturma İçin Bir Kurulum Projesi Nasıl Eklerim?

Formu ve kontrolci mantığını ayarladıktan sonra, oluşturduğunuz uygulama için bir MSI yükleyici oluşturmak için mevcut çözümünüze bir Kurulum Projesi ekleyin. Kurulum Projesi, yeni oluşturduğunuz uygulamanın bir yükleyicisini oluşturmanıza olanak tanır. Bu süreç, IronBarcode bağımlılıkları da dahil olmak üzere tüm gerekli bileşenleri tek bir dağıtılabilir birim haline getirir.

Çözüme sağ tıklayın, ardından Ekle > Yeni Proje... seçeneğine gidin.

MSI yükleyicisi için, MsiInstallerSample projesini tekrar Yayın modunda derleyin.
Kurulum Projesine sağ tıklayın, ardından Ekle > Proje Çıktısı... seçeneğine gidin.

MSI yükleyicisinin sorunsuz çalışmasını sağlamak için, kurulum projenize şu üç dosyayı eklemelisiniz: onnxruntime.dll, IronBarcodeInterop.dll ve ReaderInterop.dll. Bu dosyalar, projeyi Yayın modunda derlediğinizde üretilir:

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

Bu dosyalardan biri eksikse, şu sorun giderme makalesinde belirtildiği gibi aşağıdaki hata mesajını alabilirsiniz: MSI Yükleyicisi Oluştururken Eksik DLL'ler

Son olarak, Kurulum Projesini oluşturun. Yükleyici şu konumda bulunacaktır: MsiInstallerSample\SetupProject\Release

MSI Yükleyicisini Nasıl Çalıştırır ve Test Ederim?

Her şeyin düzgün çalışmasını sağlamak için MSI dosyası ile uygulamayı yükleyin. Test, düzgün dağıtımı doğrulamak için hem kurulum hem de kaldırma senaryolarını kapsamalıdır.

Tam Örnek Projeyi Nereden İndirebilirim?

Bu kılavuz için tam kodu indirebilirsiniz. Visual Studio'da bir WinFormApp projesi olarak açabileceğiniz zip dosyası şeklinde gelir. Örnek, gerekli tüm yapılandırmaları içerir ve MSI dağıtımı için en iyi uygulamaları gösterir.

WinForm MSI Uygulama Projesini İndirin