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

インストール事例を見れば、その規模の違いがすぐに分かるだろう。 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つの名前空間インポート、フォーマット固有のエンコーダ呼び出し、オプションオブジェクトを使用したレンダラーの構築、ファイルストリーム、およびレンダリング呼び出しが必要です。

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);

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

バーコード形式の切り替えはパラメータの変更ではなく、別の名前空間をインポートして別のクラスを呼び出す必要があります。 DataMatrixEncoder.Encodeは文字列のみを受け取ります。 特定の形式でバーコードを作成するための統一されたインターフェースは存在しない。

詳細な機能比較

バーコード方式

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

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

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

// DataMatrix
using Barcoder.DataMatrix;
IBarcode barcode = DataMatrixEncoder.Encode("data");

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

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

// DataMatrix
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
barcode = QrEncoder.Encode("data", ErrorCorrectionLevel.M, False, False)

' DataMatrix
barcode = DataMatrixEncoder.Encode("data")

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

IronBarcodeのアプローチ

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

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// DataMatrix
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png");

// QR — dedicated 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
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix).SaveAsPng("dm.png")

' QR — dedicated 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-LICENSE-KEY";

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

Imports IronBarCode

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

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

バーコード方式

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

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

// File output
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);

// Binary data via MemoryStream
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();

Imports System.IO

' File output
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
    .ImageFormat = ImageFormat.Png,
    .PixelSize = 3,
    .BarHeightFor1DBarcode = 80
})
Using stream = File.OpenWrite("barcode-large.png")
    renderer.Render(barcode, stream)
End Using

' Binary data via MemoryStream
Using ms = New MemoryStream()
    renderer.Render(barcode, ms)
    Dim pngBytes As Byte() = ms.ToArray()
End Using

サイズ制御は間接的です: PixelSize はバーコードのモジュールサイズに対するスケール乗数であり、直接的な幅と高さの指定ではありません。

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()

.ResizeTo(width, height)は、明示的なピクセル寸法を受け取り、同じオブジェクト上の任意の出力メソッドと連鎖します。

バーコード方式

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

IronBarcodeのアプローチ

IronBarcodeは、生成と読み取りの両方を同じパッケージと一貫したAPIパターンでカバーします。 BarcodeReader.Read()メソッドは、画像ファイル、バイト配列、ストリーム、および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から読み込む natively
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から読み込む natively
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から読み込む natively
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の互換性の問題

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

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

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コンテナ、および主要なクラウドプラットフォーム全体にわたるデプロイメントに関するドキュメントを作成し、積極的にテストを行っています。

GeneratedBarcodeタイプへの変更

BarcoderコードでIBarcode変数を格納して後でレンダラーに渡す場合はリファクタリングが必要です。 IronBarcodeでは、.ToPngBinaryData()のような直接呼び出しに変更します。 型システムはコンパイル中に必要なすべての更新箇所を表示します。Barcoderパッケージが削除された後、IBarcodeは解決されません。

PixelSizeには直接の同等物がありません

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

名前空間の統合

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

SVG出力パスの変更

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パッケージを削除できます。