BarCoder vs IronBarcode：C#バーコードライブラリの比較

複数パッケージ生成ワークフロー

インストール事例を見れば、その規模の違いがすぐに分かるだろう。 Barcoderでは、基本的なPNG出力には2つの別々のパッケージが必要です。

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

dotnet add package Barcoder
dotnet add package Barcoder.Renderer.Image

Code128バーコードを生成してPNGとして保存する完全なワークフローには、3つの名前空間インポート、フォーマット固有のエンコーダ呼び出し、オプションオブジェクトを使用したレンダラーの構築、ファイルストリーム、およびレンダリング呼び出しが必要です。

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

// Barcoder: 3 namespaces, 7 steps to save a PNG
using Barcoder;
using Barcoder.Code128;
using Barcoder.Renderers;

IBarcode barcode = Code128Encoder.Encode("PRODUCT-12345", false);

var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 2,
    BarHeightFor1DBarcode = 50
});

using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);

Imports Barcoder
Imports Barcoder.Code128
Imports Barcoder.Renderers
Imports System.IO

Dim barcode As IBarcode = Code128Encoder.Encode("PRODUCT-12345", False)

Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 2,
    .BarHeightFor1DBarcode = 50
})

Using stream As FileStream = File.OpenWrite("barcode.png")
    renderer.Render(barcode, stream)
End Using

バーコード形式の切り替えはパラメータの変更ではなく、別の名前空間をインポートして別のクラスを呼び出す必要があります。 CODE-38308--@@は@@--CODE-38309--@に対してboolを取り、@@--CODE-38310--@はエラー訂正レベルと2つの追加のboolを取り、@@--CODE-38311--@は文字列のみを取る。 特定の形式でバーコードを作成するための統一されたインターフェースは存在しない。

詳細な機能比較

バーコード方式

バーコード処理では、フォーマット選択は別々の名前空間にある別々のエンコーダークラスを通して行われます。 フォーマットを切り替えるということは、新しいusing@ディレクティブを追加し、異なるメソッドのシグネチャを持つ異なるクラスを使用することを意味します：

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

// Code128
using Barcoder.Code128;
IBarcode barcode = Code128Encoder.Encode("data", false);

// QR Code — different namespace, different class, different parameters
using Barcoder.Qr;
IBarcode barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, false, false);

// DataMatrix — different namespace, different class again
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

Imports Barcoder.Code128
Imports Barcoder.Qr
Imports Barcoder.DataMatrix

' Code128
Dim barcode As IBarcode = Code128Encoder.Encode("data", False)

' QR Code — different namespace, different class, different parameters
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix — different namespace, different class again
barcode = DataMatrixEncoder.Encode("data")

各エンコーダーは独自のパラメータ契約を持っている。 既存のプロジェクトに新しいフォーマットを追加することは、単語一つ変更するだけで済むような簡単なことではありません。新しい名前空間のインポート、新しいクラスの学習、そして新しいパラメーターの理解が必要になります。

IronBarcodeのアプローチ

IronBarcodeはすべてのフォーマットの選択を統一されたBarcodeEncodingクラス上のBarcodeWriter列挙型を通して行います。 新しいフォーマットを追加するには、列挙値に単語を1つ変更するだけです。

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png");

// DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png");

// QR with logo
QRCodeWriter.CreateQrCode("data", 500)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Code128
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128).SaveAsPng("code128.png")

' DataMatrix — same class, same method, one word changed
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated optimized method
QRCodeWriter.CreateQrCode("data", 500).SaveAsPng("qr.png")

' QR with logo
QRCodeWriter.CreateQrCode("data", 500) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

実運用環境で使用する場合は、アプリケーション起動時にライセンスキーを追加してください。

IronBarCode.License.LicenseKey = "YOUR-KEY";

IronBarCode.License.LicenseKey = "YOUR-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

IronBarcodeのバーコード生成に関するドキュメントには、スタイル設定、余白、色のカスタマイズなど、生成オプションの全範囲が記載されています。

バーコード方式

Barcoderにおけるエンコードとレンダリングの分離は、アーキテクチャ上の原則としては妥当だが、出力フォーマットを変更するたびにオーバーヘッドが発生する。 ファイルに保存するには、FileStreamを開く必要があります。 バイナリデータを取得するには、MemoryStreamを開き、@@--CODE-38340--@を呼び出す必要があります。 すべての出力シナリオにおいて、オプションオブジェクトを使用してレンダラーを構築する必要があります。

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// Barcoder: changing output dimensions requires rebuilding the renderer
var renderer = new ImageRenderer(new ImageRendererOptions
{
    ImageFormat = ImageFormat.Png,
    PixelSize = 3,
    BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode-large.png");
renderer.Render(barcode, stream);

// Getting binary data — different stream, same renderer pipeline
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' Barcoder: changing output dimensions requires rebuilding the renderer
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})

Using stream As FileStream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Getting binary data — different stream, same renderer pipeline
Using ms As New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

サイズコントロールは間接的です：CODE-38341--@@は、バーコードモジュールのサイズに対するスケール乗数であり、直接的な幅と高さの指定ではありません。

IronBarcodeのアプローチ

IronBarcodeはGeneratedBarcode@オブジェクトを返し、そこから連鎖したメソッド呼び出しによって任意の出力フォームに到達することができる。 レンダラーの構築も、ストリーム管理も不要です。

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

using IronBarCode;

var barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100);

// File
barcode.SaveAsPng("barcode.png");

// Bytes
byte[] pngBytes = barcode.ToPngBinaryData();

// Stream
System.IO.Stream stream = barcode.ToStream();

Imports IronBarCode

Dim barcode = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100)

' File
barcode.SaveAsPng("barcode.png")

' Bytes
Dim pngBytes As Byte() = barcode.ToPngBinaryData()

' Stream
Dim stream As System.IO.Stream = barcode.ToStream()

CODE-38343--@@は、明示的なピクセル寸法を受け取り、同じオブジェクト上の任意の出力メソッドと連鎖します。

バーコード方式

バーコードには読み取り機能やデコード機能はありません。 APIは存在せず、APIの導入予定もなく、ライブラリ内での回避策もありません。 アプリケーションがバーコードを読み取る必要がある場合、Barcoder に加えて、別のライブラリ（独自の API サーフェスと追跡対象の独自のバージョンを持つ、別のNuGet依存関係）を追加する必要があります。 つまり、少なくとも2つの読み取り関連依存関係が必要になるということだ。生成にはBarcoder、そして読み取りには別の何かが必要だ。

IronBarcodeのアプローチ

IronBarcodeは、生成と読み取りの両方を同じパッケージと一貫したAPIパターンでカバーします。 CODE-38344--@@メソッドは、画像ファイル、バイト配列、ストリーム、PDFをネイティブに受け入れます：

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// PDFから読み込む — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

using IronBarCode;

// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);
    Console.WriteLine(result.Format);
}

// PDFから読み込む — no conversion step, no extra dependency
var pdfResults = BarcodeReader.Read("document.pdf");

// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-label.png", options);

Imports IronBarCode

' Read from image file
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine(result.Value)
    Console.WriteLine(result.Format)
Next

' PDFから読み込む — no conversion step, no extra dependency
Dim pdfResults = BarcodeReader.Read("document.pdf")

' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-label.png", options)

PDFファイルの読み込みはネイティブで行われ、中間的な画像抽出、変換ライブラリ、追加パッケージは一切不要です。 IronBarcodeのバーコード読み取りに関するドキュメントでは、複数ページのPDF、関心領域の読み取り、およびパフォーマンスチューニングについて説明しています。

読書が要件に追加されました

多くのプロジェクトは、ラベルの印刷、文書用のコード生成、レポートへのバーコードの埋め込みなど、純粋な生成パイプラインとして始まります。 Barcoderは、これらのプロジェクトの初期段階から役立ちます。 同じアプリケーションが後で受信したバーコードを検証したり、スキャンしたドキュメントを処理したり、アップロードされたPDFからバーコードをデコードしたりする必要が生じた場合、Barcoderにはそれに対応する手段がありません。 チームは、2つ目のライブラリを評価し、そのAPIを習得し、 NuGetバージョンを個別に管理し、2つのライブラリ間の統合面を処理する必要がある。 この段階に達したチームは、2つの別々のバーコード依存関係を維持するのではなく、両方の側面を処理するライブラリに統合することが多い。

.NET Frameworkの互換性の問題

.NET Frameworkのサポートを削除しました。.NET フレームワーク4.x 上でサービスやデスクトップアプリケーションを保守しているチームが、定期的な依存関係の保守中にイメージレンダラーパッケージを更新すると、ビルドエラーが発生します。 これは設定ミスではなく、図書館によるプラットフォームサポートに関する決定です。 IronBarcodeは、特別なパッケージングや異なるターゲット向けの条件付き依存関係なしに、.NET フレームワーク4.6.2から.NET 9までをサポートします。

パッケージバージョンのずれが調整上の問題を引き起こす

CODE-38376--@@とBarcoder.Renderer.Image@のバージョンは独立しているため、依存関係の更新の際に一方を更新せずに他方を更新すると、微妙な非互換性が生じる可能性があります。 複数のプロジェクトを含むリポジトリでは、各プロジェクトが異なるバージョンのレンダラーパッケージを使用しているため、プロジェクト間で一貫した動作を確保することは、チームの規模が大きくなるにつれて複雑化する調整上の問題となる。 IronBarcodeに統合したチームは、1つのパッケージと1つのバージョンを管理することで、この種の問題が完全に解消されると報告している。

フォーマットのカバー範囲は時間とともに拡大する

プロジェクトはCode128ラベルから始まり、後から顧客向けリンク用のQRコードを追加し、さらにコンプライアンス要件を満たすためにDataMatrixを追加するといった流れになるかもしれません。 Barcoderでは、フォーマットを追加するたびに、新しい名前空間のインポート、異なるメソッドパラメータを持つ異なるエンコーダクラス、そして場合によっては新しいNuGetパッケージが必要になります。 IronBarcodeでは、フォーマットの追加は既存の呼び出しのBarcodeEncoding列挙値の変更です。 バーコード形式の対応範囲拡大をロードマップに盛り込んでいるチームは、列挙型ベースのモデルの方がメンテナンスがはるかに容易であることに気づいています。

MAUIとクロスプラットフォーム展開の要件

Barcoderは、MAUI、Docker、AWS Lambda、またはAzureデプロイメントのサポートに関するドキュメントを提供していません。 クロスプラットフォームのMAUIアプリケーションを構築しているチームや、バーコード処理をサーバーレスインフラストラクチャにデプロイしているチームは、Barcoderのドキュメントとテストがこれらの対象を網羅していないことに気づきます。 IronBarcodeは、iOS、Android、Windows、macOS MAUIターゲット、Dockerコンテナ、および主要なクラウドプラットフォーム全体にわたるデプロイメントに関するドキュメントを作成し、積極的にテストを行っています。

"@--CODE-38379--@@"から"@--CODE-38380--@"へのタイプ変更

変数を格納し、後でレンダラーに渡す BarCodeer コードをリファクタリングする必要があります。 IronBarcodeでは、GeneratedBarcodeは独自の出力メソッドを持ちます。現在IBarcodeを受け入れるすべてのメソッドシグネチャはGeneratedBarcodeを受け入れるように変更され、そのメソッド内のレンダリング呼び出しは@@--CODE-38385--@や@@--CODE-38386--@のような直接呼び出しになるはずです。 型システムは、コンパイル中に更新が必要なすべての場所を表示します - BarCode-38387--@@は、Barcoderパッケージが削除された後、解決されません。

PixelSize に直接相当するものはありません。

BarCodeのPixelSizeは、バーコードの自然なモジュールサイズに対するスケール乗数であり、明示的なピクセル寸法ではありません。 出力幅は、バーコードの内容、フォーマット、および乗数の組み合わせによって決まります。 IronBarcodeはピクセル寸法を明示した.ResizeTo(width, height)を使用します。 移行中、既存のBarCodeコードが生成する実際の出力寸法を測定し、その値を.ResizeTo()@呼び出しで使用してください：

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .ResizeTo(300, 80)
    .SaveAsPng("barcode.png");

BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .ResizeTo(300, 80) _
    .SaveAsPng("barcode.png")

名前空間の統合

BarCodeプロジェクトは、using Barcoder.*@ステートメントを蓄積します。 移行中、これらはすべて1つのusing IronBarCode;にまとまります。 ソリューション全体でusing Barcoderを検索すると、更新が必要なすべてのファイルが特定されます。 影響を受けるファイルの数は、通常、チームが予想するよりも多くなります。なぜなら、バーコード形式を使用する各ファイルは、それぞれ独自の形式固有の名前空間をインポートするからです。

SVG出力パスの変更

CODE-38395--@@とSvgRenderer@クラスを使用するプロジェクトでは、レンダラー・パイプラインをGeneratedBarcodeの直接メソッド呼び出しに置き換えます：

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

// Before
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);

// After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
    .SaveAsSvg("barcode.svg");

Imports System.IO

' Before
Dim svgRenderer As New SvgRenderer()
Using stream As FileStream = File.OpenWrite("barcode.svg")
    svgRenderer.Render(barcode, stream)
End Using

' After
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
    .SaveAsSvg("barcode.svg")

すべてのSVGレンダリングサイトが移行されたら、Barcoder.Renderer.Svg@パッケージは削除できます。