Barcode4NET生成API

Barcode4NETにおける完全な生成ワークフローは、プロパティセッターパターンを採用していました。

//バーコード4NET— manual DLL,.NET Frameworkonly
// NoNuGetパッケージ— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

//バーコード4NET— manual DLL,.NET Frameworkonly
// NoNuGetパッケージ— requires ThirdParty/Barcode4NET/Barcode4NET.dll in source control
using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

var barcode = new Barcode4NET.Barcode();
barcode.Symbology = Symbology.Code128;
barcode.Data = "ITEM-12345";
barcode.Width = 300;
barcode.Height = 100;
Bitmap barcodeImage = barcode.GenerateBarcode();
barcodeImage.Save(outputPath, ImageFormat.Png);

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Dim barcode As New Barcode4NET.Barcode()
barcode.Symbology = Symbology.Code128
barcode.Data = "ITEM-12345"
barcode.Width = 300
barcode.Height = 100
Dim barcodeImage As Bitmap = barcode.GenerateBarcode()
barcodeImage.Save(outputPath, ImageFormat.Png)

これは、Barcode4NET API の機能の全てを表しています。 このライブラリには、流暢なチェイニング、読み取り機能、QRコードサポート、高度な2Dオプション（ロゴ埋め込みやエラー訂正コントロールなど）はありませんでした。

詳細な機能比較

Barcode4NETのアプローチ

Barcode4NETは、命令型のプロパティ設定パターンを採用していた。 開発者はSystem.Drawing.Bitmapを受け取りました。

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

using Barcode4NET;
using System.Drawing;
using System.Drawing.Imaging;

public Bitmap GenerateLabel(string sku)
{
    var barcode = new Barcode4NET.Barcode();
    barcode.Symbology = Symbology.Code128;
    barcode.Data = sku;
    barcode.Width = 400;
    barcode.Height = 120;
    return barcode.GenerateBarcode();
}

Imports Barcode4NET
Imports System.Drawing
Imports System.Drawing.Imaging

Public Function GenerateLabel(sku As String) As Bitmap
    Dim barcode As New Barcode4NET.Barcode()
    barcode.Symbology = Symbology.Code128
    barcode.Data = sku
    barcode.Width = 400
    barcode.Height = 120
    Return barcode.GenerateBarcode()
End Function

戻り値の型 — System.Drawing.Bitmap — は、呼び出すコードが画像の保存、表示、またはストリーミングを担当することを意味しました。 これはPictureBoxに割り当てることができるWinFormsアプリケーションに適していましたが、他の出力ターゲットには追加の変換ステップが必要でした。

IronBarcodeのアプローチ

IronBarcodeは、流暢な静的APIを使用しています。 単一のメソッド呼び出しで生成が開始され、チェーン可能なメソッドによって、最終保存または変換メソッドの前に結果が構成されます。

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public byte[] GenerateLabel(string sku)
{
    return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GenerateLabel(sku As String) As Byte()
    Return BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .ToPngBinaryData()
End Function

Symbology列挙型に直接対応します。 Heightプロパティの割り当てを置き換えます。 終端メソッド — .ToPngBinaryData() — は、個別のGenerateBarcode()およびビットマップ保存の呼び出しを置き換えます。 より高度な生成シナリオについては、 IronBarcodeのバーコード生成に関するドキュメントを参照してください。

Barcode4NETのアプローチ

Barcode4NETには読み取りAPIがありませんでした。 画像やスキャンした文書からバーコードをデコードする必要のあるチームは、オープンソースの代替手段であるZXing .NET、または商用のスキャナSDKのいずれか、別のライブラリを完全に統合する必要がありました。 その結果、2つの独立した依存関係チェーンが構築された。1つはコード生成用のBarcode4NET、もう1つは読み取り用のライブラリである。

IronBarcodeのアプローチ

IronBarcodeは静的メソッドとしてBarcodeReader.Read()を提供し、画像ファイルパス、ストリームオブジェクト、およびPDF文書を受け入れます。

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

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

大量またはノイズの多い画像シナリオでは、BarcodeReaderOptionsクラスは読み取り速度と複数のバーコード検出の制御を提供します。 設定オプションについては、バーコード読み取りに関するドキュメントを参照してください。

Barcode4NETのアプローチ

Barcode4NETは.NET Frameworkアセンブリに対してコンパイルされました。 Windows上で、 .NET Frameworkアプリケーション、IISでホストされるWebフォームおよびWindowsフォームプロジェクトで動作しました。 Linuxビルドも、 .NET Coreビルドも、クラウドランタイムのサポートもありませんでした。 マイクロソフトが.NET Coreを導入し、後にプラットフォームを.NET 5+として統合した際、Barcode4NETにはそれに対応するアップデートがありませんでした。 net5.0以降をターゲットとするプロジェクトはライブラリをまったく参照できませんでした。

DLL配布モデルは、プラットフォームの制約をさらに悪化させた。 開発者ワークステーション、ビルドエージェント、Dockerコンテナなど、あらゆるビルド環境において、DLLが既知のパスに存在することが必要だった。 コンテナベースのデプロイでは、DLLをカスタムベースイメージに焼き込むか、コンテナビルド中にコピーする必要があり、いずれも標準のdotnet restoreワークフローと互換性がありません。

IronBarcodeのアプローチ

IronBarcodeは、単一のNuGetパッケージから複数のフレームワークに対応しています。具体的には、.NET Framework4.6.2から.NET 9まで、およびWindows、Linux、macOS上のすべての最新 for .NETリリースに対応しています。 Dockerコンテナへのデプロイでは、標準 for .NETランタイムイメージをそのまま使用します。 Azure Functions、AWS Lambda、およびその他のサーバーレスランタイムは、同じNuGetパッケージを通じてサポートされます。 dotnet restoreコマンドはすべての依存関係を手動DLL管理なしで解決します。

Barcode4NETのアプローチ

Barcode4NET は事実上終了間近です。新しいライセンスはComponentSourceを通じて販売されていませんが、既存の顧客は、ベンダーの条件に基づいて、ComponentSource を通じてサポートとソフトウェアアップデートを更新できます。 Barcode4NETを使用しているチームに新しい開発者が加わった場合、追加席を購入する仕組みはありません。 最後のコードリリースは2007年のバージョン2.0であり、それ以来発見されたいかなる欠陥やセキュリティ問題もパッチで対処されません。

IronBarcodeのアプローチ

IronBarcodeは、永続ライセンス付きの、積極的にメンテナンスされている商用製品です。 ライセンスの価格は、シングル開発者向けのLiteライセンスが749ドルから始まり、 Plus （1,499ドル、開発者3名）、 Professional （2,999ドル、開発者10名）、Unlimited（5,999ドル）の各ティアが用意されています。 すべてのプランには、ロイヤリティフリーでの導入が含まれています。 セキュリティパッチ、バグ修正、および.NETバージョンの互換性アップデートは、定期的なリリースサイクルで提供されます。 ライセンスキーなしで評価できる30日間の無料トライアルをご利用いただけます。

.NETアップグレードがブロックされました

最も一般的な強制要因は、 .NETの近代化プロジェクトです。 チームは.csprojでターゲットにし、ビルドを実行し、Barcode4NETが.NET Framework 1.1 / 2.0 / 3.x用に構築されており、モダンな.NETターゲットから参照できないため、ロードの失敗が発生します。 この時点で、チームは二者択一を迫られる。ターゲットフレームワークの変更を元に戻して.NET Frameworkを使い続けるか、Barcode4NETを置き換えるかだ。 移行を延期すれば、より広範な近代化の取り組みが阻害されることになる。

インフラストラクチャ変更後のCI/CDパイプラインの障害

Barcode4NETのDLL配布モデルは、ビルドパイプラインに潜在的な脆弱性を生み出す。 ビルドエージェントが再プロビジョニングされた場合、コンテナイメージが更新された場合、または新しいCI環境が構成された場合は、Barcode4NET DLLをプロジェクトファイルが想定するパスに手動で配置する必要があります。 この手順を丁寧に文書化していないチームは、パイプラインが失敗したときに初めて問題に気づくことになる。 IronBarcodeへの移行は、dotnet restoreがすべてを処理することを意味します— DLLの位置の問題は存在しなくなります。

新しいチームメンバーはライセンスを取得できません

請負業者がプロジェクトに参加したり、別の開発者がバーコード機能の開発に取り組む必要が生じた場合でも、ライセンスを購入する必要はありません。 チームはこの制約を回避する必要がある。新しい開発者がバーコードコードを完全に回避するか、あるいは元の契約条件の下では法的に譲渡できない可能性のあるライセンスを誰かが譲渡するかのどちらかだ。 どちらの状況も、積極的に製品開発に取り組んでいるチームにとっては持続可能ではない。

セキュリティおよびコンプライアンス監査

ソフトウェア部品表の生成や、サポート終了データベースとの依存関係のチェックを行う組織は、Barcode4NETを問題として認識することがあります。 これは商業製品で、2007年以来コードリリースがなく、CVEトラッキングやパッチストリームもありません。 セキュリティ監査者は通常、この状態にある依存関係を積極的に維持されているライブラリとは異なる扱いをし、その発見はしばしば、保留されるリスクではなく、正式な修正アイテムとなります。

既存のワークフローに読み取り機能を追加

当初はバーコード生成のみのワークフローにBarcode4NETを使用していたチームが、後にスキャンした文書のバーコードを検証したり、ユーザーがアップロードした画像を処理したり、PDF請求書からデータを抽出したりする必要があることに気づく。 Barcode4NETを使用する場合、これには別のライブラリを統合する必要があります。 IronBarcodeのBarcodeReader.Read()は、依存関係を単一の維持されたパッケージに統合し、画像もPDFもネイティブに扱います。

DLL参照の削除

Barcode4NETはNuGetパッケージとして配布されていないため、dotnet remove packageコマンドはありません。 ライブラリを参照するすべての<Reference Include="Barcode4NET">要素が含まれています。 これらの要素はそれぞれ手動で見つけて削除する必要があります。 ソリューション全体をgrepで検索すると、それらが見つかります。

grep -rl "Barcode4NET" --include="*.csproj" .

grep -rl "Barcode4NET" --include="*.csproj" .

ソース管理のDLLディレクトリ—通常はgit rmで削除の対象としてステージングする必要があります。

戻り値の型をビットマップからバイト配列に変更

Barcode4NETのSystem.Drawing.Bitmapを返します。 IronBarcodeの流暢なチェーンは.SaveAsPng()を書き込みます。 戻り値をBitmapを期待するメソッドに渡すコード — 例えばWinFormsのPictureBox — 呼び出し箇所で1行の調整が必要です：バイト配列をImage.FromStream()を呼び出します。

シンボル列挙型の名前変更

Barcode4NETのBarcodeEncoding列挙型に直接対応します。 一般的な値— QRCode—はその名前を保持します。 BarcodeEncoding.にソリューション全体で置き換えることでほとんどのケースをカバーしますが、各置換はコンテキストを確認するために精査する必要があります。

ビルドスクリプトのクリーンアップ

Barcode4NET DLLを出力ディレクトリまたはビルドエージェントにコピーするビルドスクリプトおよびCI/CD構成ファイルを更新する必要があります。 これらのステップはNuGetへの移行後に相当するものはありません — dotnet restoreがすべての手動DLL管理を置き換えます。 移行後に古いDLLコピー手順を残しておいてもビルドエラーは発生しませんが、それらは不要な設定であり、将来の保守担当者にとって混乱の原因となります。