Accusoft BarcodeXpressとIronBarcodeの比較：C#バーコードライブラリの比較

2キーシステムの説明

BarcodeXpressは、ライセンスを概念的に分離した2つのレイヤーに分けています。

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

// BarcodeXpress: two separate license keys required
using Accusoft.BarcodeXpressSdk;

var barcodeXpress = new BarcodeXpress();
// Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName";
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
// Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"));

Imports Accusoft.BarcodeXpressSdk

Dim barcodeXpress As New BarcodeXpress()
' Step 1: SDK license (for development)
barcodeXpress.Licensing.SolutionName = "YourCompanyName"
barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
' Step 2: Runtime license (for production — minimum 5 purchased)
barcodeXpress.Licensing.UnlockRuntime("YourRuntimeKey", Convert.ToInt64("98765432109876"))

CODE-37878--@と@@--CODE-37879--@のペアは、SDK自体をアクティブにします。 独自のキーとソリューション・キーを別々の引数として取るUnlockRuntime@呼び出しは、プロダクション・デプロイメント機能を有効にします。 本番環境への展開において、完全かつ隠蔽されていないバーコード値を返すためには、両方の情報が存在し、かつ有効である必要があります。

コード・レビューにおいて、このパターンは予測可能な質問を生み出す："なぜUnlockRuntimeを2つの異なるキーで呼び出しているのですか？その答えは、AccusoftがSDKライセンスとデプロイメントライセンスを別個の課金を伴う別個の製品として扱っていることであり、API自体からは必ずしも明らかではありません。 初期設定から6か月後にこのコードを保守しているチームは、どのキーがどれに対応しているかを理解するために、ドキュメントまで遡って調べる必要がある場合が多い。

CODE-37882--@@プロパティを使用すると、ランタイム・レイヤーがアクティブかどうかを確認できます：

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

if (!barcodeXpress.Licensing.IsRuntimeUnlocked)
{
    // In this state, barcode values are partially obscured
    // "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active");
}

If Not barcodeXpress.Licensing.IsRuntimeUnlocked Then
    ' In this state, barcode values are partially obscured
    ' "1234567890" returns as "1234...XXX"
    Console.WriteLine("Warning: runtime license not active")
End If

このチェックは、評価モードの出力が例外をスローしたり明らかに失敗したりするのではなく、部分的なデータを黙って返すことにチームが気づいたときに追加するガードです。

詳細な機能比較

BarcodeXpressのアプローチ

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

using Accusoft.BarcodeXpressSdk;

public class BarcodeService
{
    private readonly BarcodeXpress _barcodeXpress;

    public BarcodeService()
    {
        _barcodeXpress = new BarcodeXpress();

        // Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp";
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");

        // Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime(
            "RuntimeKey-XXXXXX",
            Convert.ToInt64("98765432109876"));

        // Guard against partial-value mode
        if (!_barcodeXpress.Licensing.IsRuntimeUnlocked)
        {
            throw new InvalidOperationException(
                "Runtime license not active — barcode values will be obscured");
        }
    }
}

Imports Accusoft.BarcodeXpressSdk

Public Class BarcodeService
    Private ReadOnly _barcodeXpress As BarcodeXpress

    Public Sub New()
        _barcodeXpress = New BarcodeXpress()

        ' Layer 1: SDK license
        _barcodeXpress.Licensing.SolutionName = "AcmeCorp"
        _barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")

        ' Layer 2: Runtime license — separate purchase, minimum 5
        _barcodeXpress.Licensing.UnlockRuntime("RuntimeKey-XXXXXX", Convert.ToInt64("98765432109876"))

        ' Guard against partial-value mode
        If Not _barcodeXpress.Licensing.IsRuntimeUnlocked Then
            Throw New InvalidOperationException("Runtime license not active — barcode values will be obscured")
        End If
    End Sub
End Class

これは、バーコード操作が行われる前に、2つの異なるライセンスキーシステムを管理するためだけに存在する、15行のコンストラクタです。 CODE-37900--@@@ガードはオプションではありません - これがないと、ランタイムキーがない、または設定ミスのある環境では、サービスは黙って劣化した値を返します。

IronBarcodeのアプローチ

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

using IronBarCode;

// In Program.cs or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

' In Program.vb or startup configuration
IronBarCode.License.LicenseKey = "YOUR-KEY"

これが完全なライセンス設定です。別のランタイムのアンロック、ソリューション名、2つの引数UnlockRuntime呼び出しはありません。 Dockerでは、これは起動時に読み込まれる環境変数になります。CI/CDパイプラインでは、これは1つのシークレットです。 コンテナオーケストレーターでは、これはポッドに注入される環境変数の1つです。

BarcodeXpressのアプローチ

BarcodeXpressでの読み取りは、定数と値を取るSetPropertyValueを介してリーダーを設定し、結果を取得するためにAnalyze()を呼び出すことを含む：

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

using Accusoft.BarcodeXpressSdk;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var barcodeXpress = new BarcodeXpress();
    barcodeXpress.Licensing.SolutionName = "AcmeCorp";
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234");
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"));

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath);
    barcodeXpress.reader.BarcodeTypes =
        BarcodeType.LinearBarcode |
        BarcodeType.DataMatrixBarcode |
        BarcodeType.QRCodeBarcode;

    var results = barcodeXpress.reader.Analyze();
    return results.Select(r => r.BarcodeValue);
}

Imports Accusoft.BarcodeXpressSdk

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim barcodeXpress = New BarcodeXpress()
    barcodeXpress.Licensing.SolutionName = "AcmeCorp"
    barcodeXpress.Licensing.SolutionKey = Convert.ToInt64("12345678901234")
    barcodeXpress.Licensing.UnlockRuntime("RuntimeKey", Convert.ToInt64("98765432109876"))

    barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, imagePath)
    barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.DataMatrixBarcode Or BarcodeType.QRCodeBarcode

    Dim results = barcodeXpress.reader.Analyze()
    Return results.Select(Function(r) r.BarcodeValue)
End Function

定数@--CODE-37904--@は、処理するファイルを指定するAPIの方法です。 定数識別子と値を一般的なSetPropertyValue@メソッドに渡すというこのパターンは、古いCOMベースのAPIを彷彿とさせます。もしドキュメントがBarcodeTypesにリストされていないフォーマットを含んでいる場合、それは見つかりません。 文書のソースが変更されると、これはメンテナンス上の負担となる。

IronBarcodeのアプローチ

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

using IronBarCode;

public IEnumerable<string> ReadAllBarcodes(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results.Select(r => r.Value);
}

Imports IronBarCode

Public Function ReadAllBarcodes(imagePath As String) As IEnumerable(Of String)
    Dim results = BarcodeReader.Read(imagePath)
    Return results.Select(Function(r) r.Value)
End Function

IronBarcodeは、サポートされているすべてのシンボル体系においてフォーマットを自動的に検出します。 画像にCode 128、QRコード、およびDataMatrixが含まれている場合、設定変更なしで、これら3つすべてが結果コレクションに返されます。 読み取り動作をより詳細に制御するために、 BarcodeReaderOptionsクラスでは、速度、スレッド数、およびマルチバーコードの設定が公開されています。

ネイティブPDFの閲覧も同じ方法で可能です。

using IronBarCode;

//ネイティブPDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

using IronBarCode;

//ネイティブPDF support — no separate library needed
var results = BarcodeReader.Read("invoice-batch.pdf");

foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}");
}

Imports IronBarCode

'ネイティブPDF support — no separate library needed
Dim results = BarcodeReader.Read("invoice-batch.pdf")

For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: [{result.Format}] {result.Value}")
Next

BarcodeXpressはPDFをネイティブに読み込む機能を持っていません。 まず、別のライブラリを使用して各ページを画像としてレンダリングし、次にそれらの画像をBarcodeXpressリーダーに渡す必要があります。 これにより、依存関係が増え、変換手順が増え、選択したPDFライブラリによってはライセンス費用も追加されます。

BarcodeXpressのアプローチ

BarcodeXpressはインスタンスベースで、そのオブジェクトはステートフルです。 並列処理では、スレッドごとに1つのインスタンスが必要となり、各スレッドコンテキストで完全な2層ライセンス初期化が繰り返されます。

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

using Accusoft.BarcodeXpressSdk;
using System.Collections.Generic;

public Dictionary<string, string> ProcessBatch(IEnumerable<string> imagePaths)
{
    var results = new Dictionary<string, string>();

    foreach (var path in imagePaths)
    {
        _barcodeXpress.reader.SetPropertyValue(
            BarcodeXpress.cycBxeSetFilename, path);
        _barcodeXpress.reader.BarcodeTypes =
            BarcodeType.LinearBarcode | BarcodeType.QRCodeBarcode;

        var barcodes = _barcodeXpress.reader.Analyze();
        if (barcodes.Length > 0)
            results[path] = barcodes[0].BarcodeValue;
    }

    return results;
}

Imports Accusoft.BarcodeXpressSdk
Imports System.Collections.Generic

Public Function ProcessBatch(imagePaths As IEnumerable(Of String)) As Dictionary(Of String, String)
    Dim results As New Dictionary(Of String, String)()

    For Each path In imagePaths
        _barcodeXpress.reader.SetPropertyValue(BarcodeXpress.cycBxeSetFilename, path)
        _barcodeXpress.reader.BarcodeTypes = BarcodeType.LinearBarcode Or BarcodeType.QRCodeBarcode

        Dim barcodes = _barcodeXpress.reader.Analyze()
        If barcodes.Length > 0 Then
            results(path) = barcodes(0).BarcodeValue
        End If
    Next

    Return results
End Function

スタンダード版では、1分間に40ページという表示速度の上限も設けられています。 10万件の文書を毎分40件の速度で処理する場合、完了までにおよそ41時間かかります。 Professional版ではこの制限は撤廃されますが、既に購入済みのランタイムライセンスに加えて、開発者一人当たりのコストが高くなります。

IronBarcodeのアプローチ

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

using IronBarCode;
using System.Collections.Concurrent;
using System.Threading.Tasks;

// IronBarcode — parallel batch with thread-safe static API
var files = Directory.GetFiles("/incoming/scans", "*.png");
var allResults = new ConcurrentBag<string>();

Parallel.ForEach(files, file =>
{
    var r = BarcodeReader.Read(file);
    foreach (var barcode in r)
        allResults.Add($"{file}: {barcode.Value}");
});

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.Threading.Tasks

' IronBarcode — parallel batch with thread-safe static API
Dim files = Directory.GetFiles("/incoming/scans", "*.png")
Dim allResults = New ConcurrentBag(Of String)()

Parallel.ForEach(files, Sub(file)
    Dim r = BarcodeReader.Read(file)
    For Each barcode In r
        allResults.Add($"{file}: {barcode.Value}")
    Next
End Sub)

IronBarcodeの静的メソッドはステートレスであるため、インスタンス分離の必要がなく、安全です。 IronBarcodeは、どの料金プランにおいてもスループットの上限を設けていません。 読み取りパフォーマンスを調整するために、BarCodeReaderOptionsクラスは、@--CODE-37909--@および@--CODE-37910--@@の設定を提供します：

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var results = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim results = BarcodeReader.Read("warehouse-scan.png", options)

CODE-37911はデフォルトです。 バーコードがきれいな高スループットのパイプラインにはReadingSpeed.Fasterを、損傷した画像や低コントラストの画像にはReadingSpeed.Detailedを使用してください。

40 PPMの壁を超えてスケ​​ールアップする

標準版の1分あたり40ページという制限は、一見寛大に思えるが、ビジネスチームが1年分のアーカイブされた請求書に対して、1日の終わりに一括処理を実行することを決定した場合、その制限は無視できないものとなる。 そのペースで10万件の文書を処理するには、およそ41時間かかります。 Professional版に移行すると上限はなくなりますが、既に購入済みのランタイムライセンスに加えて、開発者1人あたりのライセンス費用が高くなります。 発注書に署名した後にスループットの上限に気づいたチームは、その上限を解消するための総コストが当初の見積もりを大幅に上回ることが多いことに気づく。

CI/CDパイプラインのライセンスの複雑さ

一般的なCI/CDのセットアップでは、一時的なコンテナ内でビルドが実行されます。 BarcodeXpressでは、すべてのビルド環境において、SDKキーペアとランタイムアンロックキーの両方が必要となり、これらは別々のシークレットとして管理されます。 ランタイムキーが欠落しているか、設定が間違っている場合、ビルドは成功するかもしれませんが、統合テストでは隠蔽された値が返されます。これは、テストアサーションを実際のバーコードの内容に対して慎重に記述しないと、テストパイプラインで見落としやすいサイレントな失敗モードです。

エアギャップとセキュリティを確保した展開要件

医療記録を処理する医療システム、政府文書のワークフロー、金融機関のバックオフィス処理など、一部の環境では、発信ネットワーク通話を行う際にライセンス認証を行うことはできません。 BarcodeXpressのランタイムライセンスシステムはAccusoftのライセンスインフラストラクチャを使用しているため、ネットワーク送信制限が厳しい環境ではコンプライアンス上の懸念が生じる可能性があります。 そうした環境で活動するチームは、ライセンス認証が完全にローカルで行われるライブラリを選択することが多い。

Dockerとコンテナのデプロイ

Docker 上で BarcodeXpress を使用するには、通常、ライセンスファイルを既知のパスにコンテナ内にマウントするか、ライセンスサーバーを設定してコンテナからそのサーバーを参照するようにする必要があります。 どちらの方法も導入の複雑さを増す。ライセンスファイルを配布して同期を維持する必要があり、ライセンスサーバーは維持管理すべき追加のインフラストラクチャとなる。 マイクロサービスアーキテクチャやサーバーレスデプロイメントパターンに移行するチームは、設定ファイル方式が不変のコンテナイメージにうまく移行できないことに気づきます。

評価精度の要件

購入を決定する前に、自社の文書で読み取り精度を検証する必要があるチームにとって、BarcodeXpressの評価モードは根本的に制約が多い。 実際の文書スキャンデータを用いたテスト（ライブラリが低コントラストのバーコード、歪んだ画像、または複数のバーコードを含むページを処理できるかどうかを確認する）には、完全なデコード値が必要です。 一部が隠れた出力からは、図書館がバーコードを検出したことはわかるが、正しく読み取ったかどうかはわからない。

インスタンス管理から静的呼び出しへ

BarcodeXpressは、操作の前にBarcodeXpress@インスタンスを作成し、ライセンスを取得する必要があります。 IronBarcodeの静的メソッドはインスタンスを必要としません。 移行するチームには、通常、BarcodeService@クラスがあり、そのコンストラクタは、大部分がライセンスの定型文になっています。

バーコードタイプの列挙削除

すべてのBarcodeXpressの読み取り操作では、どのシンボルを検索するかを列挙するために、BarcodeTypesフラグの割り当てが必要です。 IronBarcodeは、デフォルトでサポートされているすべてのフォーマットを自動的に検出します。 移行中、すべてのreader.BarcodeTypes = ...@の割り当ては置き換えることなく削除できます。 検索スペースを制限するパフォーマンス上の理由がある場合、BarcodeReaderOptionsは、必須のデフォルトではなく、明示的なオプトインとしてフォーマットフィルタリングをサポートします。

結果プロパティ名の変更

2つのプロパティ名の変更は、すべての結果処理コードに影響します：CODE-37939--@@は@@--CODE-37940--@となり、@@--CODE-37941--@は@@--CODE-37942--@となります。 ソリューション全体を対象とした検索置換機能を使えば、両方とも処理できます。 IronBarcodeの結果には、result.Confidenceとresult.PageNumberも公開されており、BarcodeXpressと同等のものはなく、既存の結果処理にコードを変更することなく、追加のフィルタリングに使用することができます。

Dockerライセンス構成

BarcodeXpressのDockerデプロイメントでは通常、マウントされたライセンス設定ファイルを使用します。IronBarcodeは環境変数を使用します。 この移行では、設定ファイルのCOPY命令を削除し、環境変数の割り当てを1つ追加します。 Kubernetesでは、ライセンスキーはマウントされたボリュームではなく、Pod仕様内の秘密参照として扱われます。