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

ファイルベースのライセンスアーキテクチャ

LEADTOOLSの初期化には、最初のバーコード操作を実行する前に約20行のコードが必要です。 この手順では、ファイルパスの解決、有効期限の検証、および機能ごとのロックチェックを行います。

// LEADTOOLS: 20行以上 before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

// LEADTOOLS: 20行以上 before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

' LEADTOOLS: 20行以上 before the first barcode operation

RasterSupport.SetLicense("C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC", "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

バーコードの読み取りまたは書き込み操作が機能するには、この初期化ブロックが正常に実行される必要があります。 ファイルがない、パスが正しくない、ファイルのパーミッションが正しくない場合、LEADTOOLSは初期化されません。

詳細な機能比較

リードツールズアプローチ

LEADTOOLSライセンスには、ファイルシステム上の既知のパスに物理的に存在する.LIC@ファイルと、RasterSupport.SetLicenseに渡される開発者キー文字列が必要です。 CODE-38845--@@@を呼び出した後、アプリケーションは、ライセンスが失効していないこと、および各バーコード機能が個別にロック解除されていることを確認する必要があります。 すべてのチェックを通過して初めて、BarcodeEngineが作成されます：

// LEADTOOLS: 20行以上 before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

// LEADTOOLS: 20行以上 before the first barcode operation
using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

' LEADTOOLS: 20行以上 before the first barcode operation

RasterSupport.SetLicense("C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC", "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

このファイルベースのモデルは、現代の機密情報管理システムよりも古い時代に遡る。 CODE-38847--@@@ファイルは、アプリケーションを実行するすべての環境（開発者マシン、CIビルドエージェント、ステージングサーバー、本番ホスト）でプロビジョニングされなければなりません。

IronBarcodeのアプローチ

IronBarcodeのライセンス初期化はたった1行です。

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

そのキーは、環境変数、設定ファイル、シークレットマネージャーなど、文字列が取得できる場所ならどこからでも取得できます。 検索すべきファイルはなく、書き込みすべき有効期限チェックもなく、検証すべき機能ロックもありません。 ライセンスのセットアップとデプロイオプションについては、環境変数、appsettings.json、Azure Key Vaultなど、すべてのパターンをドキュメントでカバーしています。

リードツールズアプローチ

LEADTOOLS Dockerのデプロイには、.LIC@ファイルをコンテナ・イメージにコピーするか、実行時にボリュームとしてマウントする必要があります：

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

# The license file must be physically present in the container
COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC

ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
ENV LEADTOOLS_DEVELOPER_KEY=your-developer-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

このアプローチには、後々の複雑な問題が伴う。 ライセンスキーをローテーションまたは取り消すには、イメージを再構築するか、ボリュームを再マウントする必要があります。 CI/CDパイプラインは、.LIC@ファイルをチェックインするか、ビルド時にbase64エンコードされたシークレットからデコードする必要があります。Key-Value文字列ペアのために設計されたKubernetesシークレットは、今やファイルコンテンツを格納する必要がある。 一時的なコンテナを運用するチームは、新しいノードごとにファイルプロビジョニングの問題を解決する必要があります。

IronBarcodeのアプローチ

IronBarcodeはコンテナ内にファイルを必要としません。

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

環境変数モデルは、Dockerシークレット、Kubernetesシークレット、AWS Secrets Manager、Azure Key Vault、HashiCorp Vaultなど、コンテナの環境に文字列を挿入できるあらゆるシステムとネイティブに連携します。 AlpineとDebianの両方のベースイメージを網羅した、DockerとLinuxの完全な導入ガイドが用意されています。

リードツールズアプローチ

LEADTOOLSの読み取りには、画像を読み込むためのRasterCodecs@インスタンス、スキャンするためのBarcodeEngine@インスタンス、どのフォーマットを探すかを指定するBarcodeSymbology@値の明示的な配列を作成する必要があります。 配列からシンボルを省略すると、LEADTOOLSはそのタイプのバーコードを検出しなくなります。

// LEADTOOLS: codec, engine, explicit symbology list
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

return barcodes.Select(b => b.Value).ToArray();

// LEADTOOLS: codec, engine, explicit symbology list
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

return barcodes.Select(b => b.Value).ToArray();

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim barcodes As IEnumerable(Of BarcodeData)
Using codecs As New RasterCodecs()
    Using image As RasterImage = codecs.Load(imagePath)
        Dim engine As New BarcodeEngine()

        Dim symbologies As BarcodeSymbology() = {
            BarcodeSymbology.Code128,
            BarcodeSymbology.QR,
            BarcodeSymbology.DataMatrix,
            BarcodeSymbology.EAN13,
            BarcodeSymbology.UPCA
        }

        barcodes = engine.Reader.ReadBarcodes(
            image,
            LogicalRectangle.Empty,
            0,
            symbologies)
    End Using
End Using

Return barcodes.Select(Function(b) b.Value).ToArray()

IronBarcodeのアプローチ

IronBarcodeは、サポートされている50種類以上のシンボル体系すべてにおいて、フォーマットを自動的に検出します。 ファイルパスは直接渡されます。 画像読み込みレイヤーやシンボル配列は不要です。

// IronBarcode: auto-detect, no object setup
using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

// IronBarcode: auto-detect, no object setup
using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

Imports IronBarCode

Dim results = BarcodeReader.Read(imagePath)
Return results.Select(Function(r) r.Value).ToArray()

読み取りオプション、速度と精度の調整、および複雑な画像の処理に関する詳細については、 "画像からのバーコード読み取りガイド"を参照してください。このガイドでは、APIの全機能が網羅されています。

リードツールズアプローチ

LEADTOOLSのバーコード生成では、シンボル、値、境界を持つBarcodeData@オブジェクトを作成し、明示的なピクセル寸法、ビット深度、バイト順序、およびビュー視点を持つ空白のRasterImage@を作成し、FillCommandを使用して白い背景で塗りつぶし、engine.Writer.WriteBarcode()を呼び出し、RasterCodecsで保存する必要があります。 これは、複数のオブジェクトタイプにわたる5つの異なる操作です。

// LEADTOOLS: 5 operations, 25歳以上 lines
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, outputPath, RasterImageFormat.Png, 0);

// LEADTOOLS: 5 operations, 25歳以上 lines
using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, outputPath, RasterImageFormat.Png, 0);

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim barcodeData As New BarcodeData(BarcodeSymbology.Code128) With {
    .Value = data,
    .Bounds = New LeadRect(0, 0, 400, 100)
}

Using image As New RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    Nothing, IntPtr.Zero, 0)

    Dim fillCommand As New FillCommand(RasterColor.White)
    fillCommand.Run(image)
    engine.Writer.WriteBarcode(image, barcodeData, Nothing)

    Using codecs As New RasterCodecs()
        codecs.Save(image, outputPath, RasterImageFormat.Png, 0)
    End Using
End Using

IronBarcodeのアプローチ

IronBarcodeは、画像の作成、背景の塗りつぶし、エンコードを内部的に処理します。

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

Imports IronBarcode

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng(outputPath)

IronBarcode APIは、バーコード画像を作成する際に、一連の命令型設定オブジェクトではなく、流暢なチェーンを通じて、スタイル設定、余白、回転、フォーマット変換を提供します。

コンテナとクラウドのデプロイメント

ワークロードをDocker、Kubernetes、またはサーバーレス環境に移行するチームは、ファイルベースのライセンスモデルを具体的な運用上の問題として直面する。 新しいコンテナ・インスタンス、新しいクラウド・リージョン、新しい環境はすべて、アプリケーションを開始する前に、.LIC@ファイルがプロビジョニングされ、アクセスできるようになっていなければなりません。 文字列値の秘密情報を扱うように設計された秘密情報管理システムは、ファイルベースの成果物を適切に処理することができません。 環境変数による設定を標準化しているチームは、LEADTOOLSでは通常のシークレットワークフローとは別に、別途プロビジョニング手順が必要になることに気づいています。 デプロイメントの規模が拡大すると（オートスケーリング、ブルーグリーンデプロイメント、マルチリージョンレプリケーションなど）、ファイルプロビジョニングの運用コストもそれに合わせて拡大します。

SDKのフットプリントと依存関係の管理

バーコードの読み取りまたは生成がサービスの主要な、あるいは唯一の要件である場合、5つのパッケージからなるLEADTOOLSのインストールとMSVC++ 2017ランタイムへの依存は、コンテナイメージのサイズ、サーバーレス関数のコールドスタートの遅延、およびCI/CDパイプラインのビルド時間に影響を与えるオーバーヘッドとなります。 軽量なマイクロサービスやLambdaスタイルの関数を構築するチームは、バーコード固有のニーズに対応するために完全なイメージングSDKを取り込むと、コードレビューやアーキテクチャレビューで正当化するのが難しい依存関係が生じることに気づきます。 将来のプラットフォームアップグレードでネイティブランタイムの依存関係の変更をテストする必要が生じた場合、その作業はサービスを保守するチームが担当する。

価格の透明性

開発開始前にプロジェクトの予算を立てる必要がある開発チームは、LEADTOOLSが公開している価格情報だけでは、コストの全体像を把握することができません。 開発ライセンスは開発者1人あたり年間1,295ドル～1,469ドルで提供されていますが、サーバーアプリケーション向けの運用ライセンスは別途販売部門を通じて見積もりが行われます。 3台の運用サーバーに製品を出荷する5人の開発者チームは、LEADTOOLSが予算内に収まるかどうかを確認する前に、個別の見積もりを取得する必要があります。 公開されている価格に基づいて調達決定を行うことを好むチーム（選択肢を比較したり、社内承認を得たり、複数年予算を計画したりするチーム）にとって、このモデルでは評価が完了する前に営業担当者との話し合いが必要になる。

バーコードのみの要件

OCR、DICOM画像処理、文書注釈、またはLEADTOOLSSuiteのその他の機能を必要とせずにバーコードの読み取りまたは生成を行う必要があるアプリケーションは、その要件よりも広範なプラットフォームに費用を支払っていることになります。 LEADTOOLSの統合価値、つまりOCR、バーコード、文書処理モジュール間でデータをやり取りできる機能は確かに存在するが、それはこのSuiteの複数の機能が実際に使用されている場合にのみ有効となる。 要件がWeb APIでのバーコードスキャン、または文書処理パイプラインでの生成に限定されている場合、包括的なイメージングプラットフォームの負担を負うことなく、特化したバーコードライブラリで要件に直接対応できます。

ライセンス初期化置換

LEADTOOLSの初期化ブロック全体（ファイルパス、有効期限チェック、機能ごとのロック検証）が1行に置き換えられます。IronBarcodeライセンスキーは、文字列を保存する任意のシークレット管理システムに保存できます。

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

' Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Docker環境変数パターン

Dockerファイル内のCOPY LEADTOOLS.LIC@行は完全に削除されます。 ライセンスは実行時に環境変数を通じて提供され、すべての標準的なシークレットインジェクションメカニズムに対応しています。

# Remove: COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC
# Remove: ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
# Add:
ENV IRONBARCODE_LICENSE=your-license-key

荷物の回収

5つのLEADTOOLSパッケージ（およびオプションのPDFコーデック）は削除され、1つのパッケージに置き換えられました。

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package IronBarcode

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package IronBarcode