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

詳細な機能比較

BarcodeLibのアプローチ

BarcodeLibは、Encode()を呼び出す前に、インスタンスを構築し、プロパティを設定する必要があります。 出力はSystem.Drawing.Image@オブジェクトです：

--コード-38228--@@`.csharp using BarcodeLib; using System.Drawing; using System.Drawing.Imaging;

public byte[] GenerateCode128(string data) { var b = new Barcode(); b.IncludeLabel = true; b.Width = 300; b.Height = 100; Image img = b.Encode(TYPE.CODE128, data);

using var ms = new MemoryStream();
img.Save(ms, ImageFormat.Png);
return ms.ToArray();

} --コード-38228--@@`.

CODE-38211--@@戻り値の型は、バイト配列出力がMemoryStream仲介を必要とすることを意味します。 このプロパティはブーリアン・トグルで、BarcodeLib はエンコードされたデータ文字列をバーの下の可視ラベルとして自動的にレンダリングします。

IronBarcodeのアプローチ

IronBarcodeの生成は完全に静的です。 CODE-38214--@@の後のコンフィギュレーション・チェーン、および出力メソッドは、直接チェーンを終了します：

--コード-38228--@@`.csharp // NuGet: dotnet add package IronBarcode using IronBarCode;

public byte[] GenerateCode128(string data) { return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) .ResizeTo(300, 100) .AddAnnotationTextBelowBarcode(data) .ToPngBinaryData(); } --コード-38228--@@`.

CODE-38215--@@はバイト配列を直接返します - 中間の@@--CODE-38216--@や@@--CODE-38217--@オブジェクトはありません。 CODE-38218--@@は、ラベル文字列を明示的に受け取り、バーの下に表示されるテキストを制御します。 高度な生成シナリオについては、 IronBarcodeのバーコード生成に関するドキュメントを参照してください。

BarcodeLibのアプローチ

BarcodeLibには読み取りAPIがありません。 CODE-38219--@、@@--CODE-38220--@、@--CODE-38221--@のメソッドはありません。 これはバージョンの違いによるものではなく、図書館の設計において読書はそもそも考慮されていなかった。 デコードメソッドを呼び出そうとすると、コンパイルエラーが発生します。

--コード-38228--@@`.csharp //バーコードリブ— reading does not exist using BarcodeLib;

var b = new Barcode();

// This will not compile — there is no Decode or Read method // var value = b.Decode("barcode.png"); // CS1061: no definition // var value = b.Scan("barcode.png"); // CS1061: no definition // var value = b.ReadBarcode("barcode.png"); // CS1061: no definition

// The only thing you can do is generate: Image img = b.Encode(TYPE.CODE128, "PRODUCT-12345"); // this works --コード-38228--@@`.

BarcodeLibに加えて生成と読み取りの両方を必要とするチームは、2つ目のライブラリ（通常はZXing .NET ）を追加する必要があり、これにより独自の依存関係管理の負担と、維持管理が必要な2つ目のAPIサーフェスが発生します。

IronBarcodeのアプローチ

画像ファイル、PDFファイル、ストリーム、オブジェクトを受け付けます。 PDFファイルの読み込みには、追加のライブラリは必要ありません。

--コード-38228--@@`.csharp using IronBarCode;

// Read from an image var results = BarcodeReader.Read("barcode.png"); Console.WriteLine(results.First().Value); // "PRODUCT-12345"

// Read all barcodes from a PDF — no separate PDF library needed var pdfResults = BarcodeReader.Read("invoice-batch.pdf"); foreach (var result in pdfResults) { Console.WriteLine($"Page {result.PageNumber}: {result.Value}"); }

// Tune reading for speed vs. thoroughness var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced, ExpectMultipleBarcodes = true }; var multiResults = BarcodeReader.Read("warehouse-scan.png", options); --コード-38228--@@`.

CODE-38224--@@@列挙型は、大量のシナリオ用にスキャン・パフォーマンスを調整することができます。 読み取り設定に関するガイダンスについては、 IronBarcodeの読み取りに関するドキュメントを参照してください。

BarcodeLibのアプローチ

BarcodeLib 3.xから、ライブラリは、.NET 6以降Windows専用となったSystem.Drawing.Commonに代わるグラフィックスバックエンドとしてSkiaSharpを導入しました。 プロジェクトがすでに別の依存関係を通してSkiaSharpを使用している場合（@--CODE-38226--@@とMicrosoft.Maui.Graphicsを使用するMAUIプロジェクトで一般的）、解決されたバージョンはBarcodeLibの想定範囲外になる可能性があります。 その結果、最低でもNU1608警告が発生し、最悪の場合は実行時にアセンブリバインディングエラーが発生します。

--コード-38228--@@. 警告 NU1608: 依存関係の制約外のパッケージバージョンが検出されました: BarcodeLib 3.1.5 は SkiaSharp (>= 2.88.7 && < 2.89.0) を必要としますが、 SkiaSharp バージョン 3.116.1 の問題が解決しました。 --コード-38228--@@.

明示的なパッケージ参照によって解決を強制すると、複雑さが増すだけで、解決の保証はありません。

--コード-38228--@@`.xml

--コード-38228--@@`.

明示的なオーバーライドを行った場合でも、互換性はBarcodeLibの内部API呼び出しが、固定バージョンで公開されているものと一致するかどうかに依存します。 プロジェクトにとって重要なスケジュールでの修正を保証するサポート契約は存在しません。

IronBarcodeのアプローチ

IronBarcodeは、アプリケーションコードとSkiaSharpの依存関係グラフを共有しません。 管理すべきバージョンネゴシエーションはなく、診断すべきNU1608もなく、SkiaSharpのバージョン解決に関連するランタイムアセンブリバインディングのリスクもありません。 MAUIプロジェクト、 Blazorプロジェクト、およびSkiaSharpに依存するその他のアプリケーションは、バージョン競合を起こすことなくIronBarcodeをインストールできます。 MAUI固有の統合パターンについては、 IronBarcode MAUIのドキュメントを参照してください。

読書要件が表示されます

数ヶ月にわたり配送ラベルを生成してきたシステムに、新たな要件が課せられた。それは、サプライヤーから返送されたラベルも処理しなければならないというものだ。 倉庫との連携では、入荷貨物明細書からバーコードを解析する必要があります。 文書管理システムは、スキャンされたPDFファイル上のバーコードをインデックス化する必要がある。 BarcodeLibはこれらの要件をいずれも満たすことができません。読み取りAPIが存在しないためです。チームはBarcodeLibに加えてZXing .NETを追加することを検討し、2つのライブラリのメンテナンス負担と2つの独立した依存関係グラフを考慮した上で、生成と読み取りの両方を単一のNuGetインストールで処理できるライブラリを使用する方がよりクリーンな方法であると判断しました。

SkiaSharp社がマウイ島のプロジェクトで紛争を発生

あるチームが既存のMAUIアプリケーションにBarcodeLibを追加したところ、復元中にすぐにNU1608警告が発生しました。 彼らは調査し、BarcodeLibが期待するSkiaSharpの範囲とMAUIが要求するバージョンとの間のバージョンの不一致を特定し、強制的に解決するために明示的な<PackageReference>オーバーライドを追加し、ビルドをパスさせます。 その後、SkiaSharpのネイティブバイナリが誤ったバージョンをロードした際に、デバイス上でランタイムクラッシュが発生する。 この問題を解決するには、アセンブリバインディングログの詳細な調査が必要です。 IronBarcodeに切り替えることで、根本的な競合が解消されます。これは、互換性のあるSkiaSharpのバージョンを探すのではなく、共有されている依存関係を完全に排除することによって実現されます。

PDFバーコード処理が必要です

請求書、作業指示書、出荷明細書など、バーコードが埋め込まれたPDF文書を生成するアプリケーションは、後続の処理中にそれらのバーコードを読み取る必要がある場合があります。 BarcodeLibはバーコード画像を生成しますが、PDFファイルへの対応はしていません。 BarcodeLibを使用してPDFからバーコードを読み取るには、まず別のPDFライブラリを使用してPDFを画像にレンダリングし、次にその画像を別の読み取りライブラリに渡す必要があります。 IronBarcodeはフルチェーンをネイティブで処理します：すべてのページをトラバースし、中間レンダリングステップなしで検出されたすべてのバーコードを返します。

QRコードの機能が基本世代の枠を超える

当初は基本的なQRコード生成のみを必要としたプロジェクトでも、ロゴの埋め込み、色のカスタマイズ、エラー訂正レベルの設定などが必要になる場合が少なくない。 BarcodeLibは、TYPE.QR_Codeを通じてQRコードをサポートしますが、標準のWidth、Height、およびIncludeLabelプロパティ以上のオプションは提供しません。 IronBarcodeのQRCodeWriterは、連鎖メソッドを通してロゴの埋め込み、カラーコントロール、エラー訂正のチューニングを公開します。 QRコードに関する要件がBarcodeLibの基本実装でサポートされている範囲を超えたチームは、機能のギャップが移行の決定要因となることに気づいています。

インスタンスAPIから静的Fluent APIへ

BarcodeLibのコードは、Mutableオブジェクトパターンを使用しています。 IronBarcodeは静的フルエントパターンを使用します: BarcodeWriter.CreateBarcode()を呼び出し、設定メソッドを連鎖させ、出力メソッドで終了します。 CODE-38261--@@インスタンスをフィールドとして格納したり、メソッド間で渡したりする既存のコードは、再構築が必要です。 典型的な変更点は、プロパティ設定ブロックをメソッドチェーンに置き換えることです。

--コード-38228--@@.csharp // The property setters on b become chained methods BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) .ResizeTo(300, 100) .AddAnnotationTextBelowBarcode(data) .SaveAsPng(outputPath); --コード-38228--@@.

System.Drawing.Image を直接出力へ

BarcodeLibはSystem.Drawing.Imageを返し、バイトを生成するにはMemoryStreamが必要です。 CODE-38264--@または@@--CODE-38265--@にタイプされたコードは、更新が必要です。 IronBarcodeのフルーエントチェーンは希望の出力フォーマット-@--CODE-38266--@@、@--CODE-38267--@@、@--CODE-38268--@@@で直接終了するため、中間イメージオブジェクトとMemoryStreamステップの必要性がなくなります。

TYPE Enum から BarcodeEncoding Enum へ

BarcodeLibは、TYPE@クラスを使用し、TYPE.CODE128@のような大文字の定数を使用します。 IronBarcodeはBarcodeEncodingのようなPascalCase値を持つ列挙型を使用します。 値は直接対応します。 CODE-38274--@@を.cs@ファイル全体でgrepすると、更新が必要なすべての出現が特定され、体系的な検索と置換で一般的な形式がカバーされます：コード-38276--@@ → @--コード-38277--@、@--コード-38278--@ → @--コード-38279--@、@--コード-38280--@ → @--コード-38281--@、@--コード-38282--@ → @--コード-38283--@。

SkiaSharp リファレンスのクリーンアップ

明示的な<PackageReference Include="SkiaSharp">エントリを追加したプロジェクトは、IronBarcodeに切り替えた後、それらのオーバーライドを削除することができます。 SkiaSharpを削除する前に、dotnet list package --include-transitive@コマンドは、プロジェクト内の他のパッケージによってSkiaSharpがまだ必要であるかどうかを確認します。