IronBarcodeでMSIインストーラーを作成する

始める前に必要な前提条件はありますか?

プロジェクトを開始する前に、[Microsoft Visual Studio Installer Projects extension]()をダウンロードしてください。 https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2022InstallerProjects)をダウンロードしてください。 さらに、プロジェクトにNuGet経由でIronBarcodeがインストールされていることを確認してください。

どのように最初の MSI インストーラー プロジェクトを作成しますか?

この例では、Windows Forms App (.NET Framework)プロジェクトを使ってその機能を説明します。 このアプローチは、デスクトップバーコードスキャンアプリケーションに馴染みのあるUIパラダイムを提供します。

Windowsフォームにボタンを追加するには?

• ツールボックスに移動します
• ボタンを検索します
• Windowsフォームにドラッグ＆ドロップしてボタンを追加します。

フォームに追加するためにすべてのWindowsフォームセクションの下に強調表示されたボタンコントロールを表示するVisual Studioツールボックス。

バーコード スキャンを処理するためにボタン コードを編集するにはどうすればよいですか?

ボタンコンポーネントをダブルクリックして、フォームのC#コードにアクセスしてください。 以下は、フォーム・コンポーネントのロジックで、BarCodeを取り込んでスキャンしようとします。 このコードは画像のみをスキャンし、PDFには対応していません。 PDF文書にはReadPdfメソッドを使用してください。 包括的なバーコード読み取りオプションについては、barcode reader settings documentationを参照してください。

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

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

セットアップ プロジェクトを追加して MSI を作成するにはどうすればよいですか?

フォームとそのコントローラロジックを設定した後、既存のソリューションにセットアッププロジェクトを追加して、MSIインストーラを作成します。 セットアッププロジェクトでは、作成したアプリケーションのインストーラを構築することができます。 このプロセスでは、IronBarcodeの依存関係を含むすべての必要なコンポーネントを単一のデプロイ可能なユニットにパッケージ化します。

ソリューションで右クリックし、追加 > 新しいプロジェクト...に移動します。

セットアップ プロジェクトを作成するための [追加] > [新規プロジェクト] オプションを表示する Visual Studio Solution Explorer コンテキスト メニュー。

MSIインストーラーのため、ReleaseモードでMsiInstallerSampleプロジェクトを再度ビルドします。 セットアッププロジェクトで右クリックし、追加 > プロジェクト出力...に移動します。

ソリューションエクスプローラーが表示されている状態で SetupProject の展開オプションを表示する Visual Studio Add Project Output Group ダイアログ。

MSIインストーラーがスムーズに動作するために、セットアッププロジェクトに次の3つのファイルを必ず含める必要があります：onnxruntime.dll、IronBarcodeInterop.dll、および ReaderInterop.dll。 これらのファイルは、Releaseモードでプロジェクトをビルドすると生成されます：

• onnxruntime.dll：MsiInstallerSampleにあります。
• IronBarcodeInterop.dll：場所はMsiInstallerSampleです。
• ReaderInterop.dll：場所はMsiInstallerSampleです。

セットアッププロジェクトに追加するReaderInterop.dllを選択するVisual Studioのファイルダイアログと依存関係を表示するソリューションエクスプローラー。

これらのファイルのいずれかが欠けている場合、このトラブルシューティングの記事に記載されているように、次のような例外メッセージが表示されることがあります：MSIインストーラの作成でDLLが見つからない。

最後に、セットアッププロジェクトをビルドします。 インストーラーは次の場所に配置されます：MsiInstallerSampleSetupProject</Releaseにあります。

MSIインストーラーを実行してテストするには?

MSIファイルを使用してアプリケーションをインストールし、すべてがスムーズに動作するようにします。 テストは、インストールとアンインストールの両方のシナリオをカバーし、適切なデプロイメントを検証する必要があります。

インストーラのビルドが完了し、setup.exe とインストーラファイルが含まれる Release フォルダが表示されているVisual Studio。

完全なサンプル プロジェクトはどこからダウンロードできますか?

このガイドの完全なコードをダウンロードできます。これは、Visual StudioでWinFormAppプロジェクトとして開くことができるジップファイルで提供されます。 サンプルには、必要な設定がすべて含まれており、MSIデプロイのベストプラクティスが示されています。

WinForm MSIアプリプロジェクトをダウンロード