BarcodeLibコア生成パターン

標準的なBarcodeLib生成ワークフローでは、インスタンスを作成し、プロパティを設定し、寸法を指定してEncode()を呼び出す必要があります。

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

Imports BarcodeStandard
Imports SkiaSharp

Dim b As New Barcode()
b.IncludeLabel = True
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

これが生成ワークフロー全体です。 プロパティセッターパターンは設計の一部です: 設定はSKImageです。

詳細な機能比較

BarcodeLibのアプローチ

BarcodeLibはインスタンスを構築し、プロパティを設定してから寸法でEncode()を呼び出す必要があります。 出力はSKImageです:

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

using BarcodeStandard;
using SkiaSharp;

public byte[] GenerateCode128(string data)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

Imports BarcodeStandard
Imports SkiaSharp

Public Function GenerateCode128(data As String) As Byte()
    Dim b As New Barcode()
    b.IncludeLabel = True
    Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, data, 300, 100)

    Using ms As New MemoryStream()
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
        Return ms.ToArray()
    End Using
End Function

MemoryStreamを要求することを意味します。 IncludeLabelプロパティはブール値のトグルです - BarcodeLibはエンコードされたデータ文字列をバーの下に見えるラベルとしてレンダリングします。

IronBarcodeのアプローチ

IronBarcodeの生成は完全に静的です。 設定チェーンはCreateBarcode()の後に続き、出力メソッドはチェーンを直接終了します:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateCode128(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .AddBarcodeValueTextBelowBarcode()
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateCode128(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .AddBarcodeValueTextBelowBarcode() _
        .ToPngBinaryData()
End Function

MemoryStreamオブジェクトなしでバイト配列を直接返します。 .AddBarcodeValueTextBelowBarcode()はバーの下のラベルとしてエンコードされたデータ文字列をレンダリングします。 高度な生成シナリオについては、 IronBarcodeのバーコード生成に関するドキュメントを参照してください。

BarcodeLibのアプローチ

BarcodeLibには読み取りAPIがありません。 Decode(), Scan(), またはReadBarcode()メソッドはありません。 読み取りはライブラリの設計の一部ではありませんでした。 デコードメソッドを呼び出そうとすると、コンパイルエラーが発生します。

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()

' There is no Decode, Scan, or Read method on Barcode.
' b.Decode("barcode.png")      ' does not exist
' b.Scan("barcode.png")        ' does not exist
' b.ReadBarcode("barcode.png") ' does not exist

' The only public operation is generation:
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

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

IronBarcodeのアプローチ

System.Drawing.Bitmapオブジェクトを受け入れます。 PDFファイルの読み込みには、追加のライブラリは必要ありません。

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

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

Imports IronBarCode

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

' Read all barcodes from a PDF — no separate PDF library needed
Dim pdfResults = BarcodeReader.Read("invoice-batch.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

ReadingSpeed列挙型は、大量処理シナリオにおけるスキャンパフォーマンスの調整を可能にします。 読み取り設定に関するガイダンスについては、 IronBarcodeの読み取りに関するドキュメントを参照してください。

BarcodeLibのアプローチ

BarcodeLib 3.xから、ライブラリはSystem.Drawing.Commonを置き換えるグラフィックスバックエンドとしてSkiaSharpを導入しましたが、.NET 6以降はWindows専用となりました。BarcodeLib 3.1.5はSkiaSharp >= 2.88.8を宣言します。 既存のプロジェクトがMicrosoft.Maui.Graphicsを使用するMAUIプロジェクトでの他の依存関係を通じてすでにSkiaSharpを使用している場合、SkiaSharp 3.xに向かう傾向があります — 解決されたバージョンは収束しない可能性があります。 その結果、最低でもNU1608警告が発生し、最悪の場合は実行時にアセンブリバインディングエラーが発生します。

warning NU1608: Detected package version outside of dependency constraint:
BarcodeLib 3.1.5 requires SkiaSharp (>= 2.88.8) but
version SkiaSharp 3.116.1 was resolved.

明示的なパッケージ参照を通じて解決を強制することは一つの方法ですが、それがランタイムの互換性を保証するわけではありません：

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />
  <PackageReference Include="SkiaSharp" Version="3.116.1" />
  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

明示的なオーバーライドを使っても、互換性はBarcodeLibの内部API呼び出しが解決されたSkiaSharpバージョンが公開しているものであるかによります。 コミュニティで保守されているプロジェクトとして、BarcodeLibはリリースのタイミングに商業的なサポート契約が付いていません。

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は完全なチェーンをネイティブで処理します: BarcodeReader.Read("file.pdf")がすべてのページを走査し、中間レンダリングステップなしで検出されたすべてのバーコードを返します。

QRコードや他の2Dシンボロジー要件が現れる

元々は線形バーコードだけが必要だったプロジェクトは、しばしばQRコード、Data Matrix、PDF417、またはAztecの出力を必要とするように進化します。 BarcodeLibの3.xシリーズでは、2Dシンボロジーを生成しません — BarcodeStandard.Type列挙型にはQRコードやその他の2Dエントリが含まれていないため、2D要件は別のライブラリを追加するか、BarcodeLibを完全に置き換える必要があります。 IronBarcodeのBarcodeWriterは、同じ流暢なAPIを通じてQRコード（ロゴ埋め込み、色制御、およびエラー訂正調整を行う）、Data Matrix、PDF417、Aztecをカバーします。 シンボロジー要件が2Dへと移行するチームは、そのギャップが移行の決定要因であることを発見します。

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

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

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

' The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .AddBarcodeValueTextBelowBarcode() _
    .SaveAsPng(outputPath)

SKImageから直接出力へ

BarcodeLib 3.xはSKEncodedImageFormatとストリームが必要です。 image.Encode(...).SaveTo(stream)を通過するコードは更新が必要です。 IronBarcodeの流暢なチェーンは、目的の出力形式で直接終了します — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — 中間の画像オブジェクトやストリームへのエンコードステップが不要になります。

Type Enum to BarcodeEncoding Enum

BarcodeLib 3.xはBarcodeStandard.Type.Code128のようなPascalCase値を持ちます。 IronBarcodeはBarcodeEncoding.Code128のような値を持ちます。 1D値は直接対応します: Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39。 .cs ファイル全体のBarcodeStandard.Type.をgrepして、更新が必要なすべての出現を特定します。

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

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