BarcoderからIronBarcodeへの移行
このガイドでは、 .NET開発者向けにBarcoderからIronBarcodeへの移行手順全体を解説します。 移行によって、2つのパッケージが1つに統合され、エンコーダーレンダラーパイプラインが単一のメソッド呼び出しに置き換えられ、すべての形式固有の名前空間インポート — using Barcoder.Code128, using Barcoder.Qr, using Barcoder.DataMatrix — が単一のusing IronBarCode;に折りたたまれます。 ImageRendererOptions型が完全に削除されました。 読み取りが欠けている機能であり、Barcoderと共に二次的なライブラリを追加する原因となっていた場合、IronBarcodeはBarcodeReader.Read()でネイティブに読み取りをカバーします。
Barcoderから移行する理由
Barcoderから移行するチームは、以下の要因を報告しています。
補足事項: Barcoderは生成専用ライブラリであり、デコード機能はありません。 アプリケーションが受信したバーコードを検証したり、スキャンしたドキュメントを処理したり、アップロードされたPDFからバーコードを読み取ったりする必要がある場合、Barcoderにはそれを実行する手段がありません。 読み取り用に2つ目のライブラリを追加すると、コードベースが分割され、 NuGetの依存関係が2つになり、維持管理すべきAPIが2つになり、追跡すべきバージョン履歴が2つになります。 IronBarcodeは、生成と読み取りの両方を同じパッケージで処理します。
.NET Frameworkの互換性が破壊されました: Barcoder.Renderer.Imageは.NET Frameworkサポートを削除しました。 .NET Framework 4.x 上でサービスまたはデスクトップアプリケーションを実行しているチームが、定期的な依存関係のメンテナンス中にイメージレンダラーパッケージを更新すると、ビルドエラーが発生します。 IronBarcodeは、異なるターゲット向けに条件付きパッケージングを行うことなく、 .NET Framework 4.6.2から.NET 9までをサポートしています。
パッケージバージョンのドリフト: Barcoder.Renderer.Imageは独立してバージョニングされるNuGetパッケージです。 依存関係の更新時に、一方だけを更新すると、互換性の問題が発生する可能性があります。 複数のプロジェクトを含むリポジトリでは、各レンダラーのバージョンをすべてのプロジェクトで一貫して使用できるようにすることは、チーム規模が大きくなるにつれて増大する調整上の負担となる。
複数のフォーマットが追加される: Code128 から始まり、後で QR、次に DataMatrix を追加するプロジェクトでは、新しい名前空間のインポートを追加し、各フォーマットごとに異なるメソッド パラメータを持つ別のエンコーダ クラスを学習する必要があります。 IronBarcodeはBarcodeEncoding列挙型を使用します — 形式を追加することは、既存の呼び出しに対する一語の変更です。 新しい名前空間も、新しいクラスも、異なるメソッドシグネチャもありません。
MAUIおよびクラウドデプロイメントの要件: Barcoderは、MAUI、Docker、AWS Lambda、またはAzureデプロイメントのサポートについてはドキュメント化していません。 クロスプラットフォームのモバイルアプリケーションやサーバーレスのバーコード処理パイプラインを構築するチームは、Barcoderのドキュメントに記載されているターゲットがこれらのシナリオを網羅していないことに気づきます。
基本的な問題
Barcoderは、フォーマット選択を名前空間のインポートと連動させ、すべての出力操作に対してレンダリングパイプラインを強制的に実行します。 フォーマットや出力タイプを変更するには、コードの構造的な変更が必要です。
// Barcoder: 3 namespaces, encoder-specific class, renderer pipeline, stream management
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 UsingIronBarcode、同じ操作を単一のチェーン呼び出しとして表現できます。
// IronBarcode: 1 namespace, 1 method, 1 output call
using IronBarCode;
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
.SaveAsPng("barcode.png");Imports IronBarCode
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
.SaveAsPng("barcode.png")IronBarcodeとBarcoder:機能比較
| フィーチャー | バーコード | IronBarcode |
|---|---|---|
| 必要なNuGetパッケージ | 最小2つ(バーコーダー + バーコーダー.レンダラー.イメージ) | 1 (IronBarcode) |
| バーコード生成 | はい | はい |
| バーコードの読み取り/デコード | なし | はい |
| フォーマットごとのエンコーダークラス | はい — Code128Encoder, QrEncoder, DataMatrixEncoderなど | いいえ — BarcodeEncoding列挙型 |
| フォーマットごとの名前空間インポート | はい — Barcoder.Code128, Barcoder.Qr, Barcoder.DataMatrix | いいえ — using IronBarCodeのみ |
| 結果オブジェクトの出力メソッド | いいえ — IBarcodeには保存メソッドがありません | はい — SaveAsPng, ToPngBinaryData, ToStreamがあります |
| PDFを読む | なし | はい — BarcodeReader.Read(path) |
| ロゴ入りQRコード | なし | はい — .AddBrandLogo(path) |
| .NET Frameworkのサポート | 画像レンダラーにドロップされました | .NET Framework 4.6.2以降 |
| .NET 9 のサポート | 不明瞭/活動が限定的 | はい |
| MAUIサポート | なし | はい — iOS、Android、Windows、macOS |
| Docker/Azure/AWSラムダ。 | 記録なし | はい |
| ライセンス | MIT(オープンソース) | Commercial — Lite $999, Plus $1,499, Professional $2,399, Unlimited $4,799 |
| 読書速度制御 | なし | はい — ReadingSpeed列挙型 |
| 複数バーコード検出 | なし | はい — ExpectMultipleBarcodesオプション |
クイックスタート:BarcoderからIronBarcodeへの移行
ステップ 1: NuGet パッケージを置き換える
プロジェクトからすべてのBarcoderパッケージを削除してください。
dotnet remove package Barcoder
dotnet remove package Barcoder.Renderer.Image
SVGレンダラーも追加した場合:
dotnet remove package Barcoder.Renderer.Svg
IronBarcodeをインストールしてください:
dotnet add package IronBarcode
ステップ 2: 名前空間の更新
プロジェクト内のすべてのファイルからusing Barcoder.*ステートメントをすべて削除してください。
// Remove all of these
using Barcoder;
using Barcoder.Code128;
using Barcoder.Qr;
using Barcoder.DataMatrix;
using Barcoder.Renderers;
using Barcoder.Ean;
using Barcoder.Pdf417;
// ... and any other Barcoder.* namespaces in your projectnetそれら全てを単一のusingディレクティブに置き換えてください。
using IronBarCode;Imports IronBarCodeステップ 3: ライセンスの初期化
アプリケーションの起動時にライセンス初期化を追加— Program.cs, Startup.cs, またはMauiProgram.cs。
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";Imports IronBarCode
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"無料トライアルキーはironsoftware.comで入手できます。
コード移行の例
コード128生成
バーコード方式:
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 UsingIronBarcodeのアプローチ:
// NuGet: dotnet add package IronBarcode
using IronBarCode;
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
.SaveAsPng("barcode.png");Imports IronBarCode
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
.SaveAsPng("barcode.png")Code128Encoder, ImageRenderer, ImageRendererOptions, およびストリーム管理が完全に削除されました。 フォーマットは統合されたBarcodeEncoding.Code128として指定されます。 出力メソッドは、返されたGeneratedBarcodeオブジェクトに直接あります。 IronBarcodeのバーコード生成に関するドキュメントでは、スタイル、余白、色のカスタマイズについて説明しています。
QRコード生成
バーコード方式:
using Barcoder;
using Barcoder.Qr;
using Barcoder.Renderers;
IBarcode barcode = QrEncoder.Encode("https://example.com", ErrorCorrectionLevel.M);
var renderer = new ImageRenderer(new ImageRendererOptions
{
ImageFormat = ImageFormat.Png,
PixelSize = 4
});
using var stream = File.OpenWrite("qr.png");
renderer.Render(barcode, stream);Imports Barcoder
Imports Barcoder.Qr
Imports Barcoder.Renderers
Dim barcode As IBarcode = QrEncoder.Encode("https://example.com", ErrorCorrectionLevel.M)
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
.ImageFormat = ImageFormat.Png,
.PixelSize = 4
})
Using stream = File.OpenWrite("qr.png")
renderer.Render(barcode, stream)
End UsingIronBarcodeのアプローチ:
using IronBarCode;
QRCodeWriter.CreateQrCode("https://example.com", 500)
.SaveAsPng("qr.png");Imports IronBarCode
QRCodeWriter.CreateQrCode("https://example.com", 500) _
.SaveAsPng("qr.png")CreateQrCodeへの第2パラメータは、ピクセル単位の出力寸法です。 エラー訂正レベルはデフォルトで適切な値に設定されており、必要に応じて設定変更が可能です。 IronBarcodeは、Barcoderでは不可能な操作、つまりQRコードセンターにブランドロゴを埋め込む機能もサポートしています。
using IronBarCode;
QRCodeWriter.CreateQrCode("https://example.com", 500)
.AddBrandLogo("logo.png")
.SaveAsPng("qr-branded.png");Imports IronBarCode
QRCodeWriter.CreateQrCode("https://example.com", 500) _
.AddBrandLogo("logo.png") _
.SaveAsPng("qr-branded.png")データマトリックス生成
バーコード方式:
using Barcoder;
using Barcoder.DataMatrix;
using Barcoder.Renderers;
IBarcode barcode = DataMatrixEncoder.Encode("ITEM-XYZ-001");
var renderer = new ImageRenderer(new ImageRendererOptions
{
ImageFormat = ImageFormat.Png,
PixelSize = 5
});
using var stream = File.OpenWrite("datamatrix.png");
renderer.Render(barcode, stream);Imports Barcoder
Imports Barcoder.DataMatrix
Imports Barcoder.Renderers
Imports System.IO
Dim barcode As IBarcode = DataMatrixEncoder.Encode("ITEM-XYZ-001")
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
.ImageFormat = ImageFormat.Png,
.PixelSize = 5
})
Using stream As FileStream = File.OpenWrite("datamatrix.png")
renderer.Render(barcode, stream)
End UsingIronBarcodeのアプローチ:
using IronBarCode;
BarcodeWriter.CreateBarcode("ITEM-XYZ-001", BarcodeEncoding.DataMatrix)
.SaveAsPng("datamatrix.png");Imports IronBarCode
BarcodeWriter.CreateBarcode("ITEM-XYZ-001", BarcodeEncoding.DataMatrix) _
.SaveAsPng("datamatrix.png")パターンはCode128と同一ですが、BarcodeEncoding値のみが変更されます。 新しい名前空間のインポートも、異なるクラスも、異なるメソッドシグネチャもありません。
出力サイズの制御
Barcoderは、バーコードモジュールサイズのスケール乗算子としてBarHeightFor1DBarcodeを使用します — 直接的な幅/高さAPIはありません。
バーコード方式:
var renderer = new ImageRenderer(new ImageRendererOptions
{
ImageFormat = ImageFormat.Png,
PixelSize = 3,
BarHeightFor1DBarcode = 80
});
using var stream = File.OpenWrite("barcode.png");
renderer.Render(barcode, stream);Imports System.IO
Dim renderer = New ImageRenderer(New ImageRendererOptions With {
.ImageFormat = ImageFormat.Png,
.PixelSize = 3,
.BarHeightFor1DBarcode = 80
})
Using stream As FileStream = File.OpenWrite("barcode.png")
renderer.Render(barcode, stream)
End UsingIronBarcodeのアプローチ:
using IronBarCode;
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
.ResizeTo(400, 100)
.SaveAsPng("barcode.png");Imports IronBarCode
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
.ResizeTo(400, 100) _
.SaveAsPng("barcode.png").ResizeTo(width, height)は明示的なピクセル寸法を取ります。 これは、同じGeneratedBarcodeオブジェクトの他の出力メソッドと連鎖されます。
ファイルではなくバイナリデータを取得する
バーコード方式:
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
});
using var ms = new MemoryStream();
renderer.Render(barcode, ms);
byte[] pngBytes = ms.ToArray();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
})
Using ms As New MemoryStream()
renderer.Render(barcode, ms)
Dim pngBytes As Byte() = ms.ToArray()
End UsingIronBarcodeのアプローチ:
using IronBarCode;
byte[] pngBytes = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
.ToPngBinaryData();Imports IronBarCode
Dim pngBytes As Byte() = BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128).ToPngBinaryData()GeneratedBarcodeへの単一の連鎖メソッド呼び出しに置き換えられます。
バーコード読み取り(新機能)
Barcoderには読み取りAPIがありません。 以前に読書用に2つ目のライブラリを追加していた場合は、それを削除できます。 IronBarcodeは、生成に使用したのと同じパッケージを使用して、ファイル、バイト配列、ストリーム、およびPDFからデータを読み取ります。
IronBarcodeのアプローチ:
using IronBarCode;
// Read from image file
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
{
Console.WriteLine($"Value: {result.Value}");
Console.WriteLine($"Format: {result.Format}");
}
// Read from PDF natively — no image extraction step, no extra dependency
var pdfResults = BarcodeReader.Read("invoice.pdf");
// Read multiple barcodes from one image
var options = new BarcodeReaderOptions
{
Speed = ReadingSpeed.Balanced,
ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-sheet.png", options);
foreach (var result in multiResults)
Console.WriteLine(result.Value);
// Read from a stream directly
using var fileStream = File.OpenRead("barcode.png");
var streamResults = BarcodeReader.Read(fileStream);Imports IronBarCode
' Read from 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 from PDF natively — no image extraction step, no extra dependency
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
' Read multiple barcodes from one image
Dim options As New BarcodeReaderOptions With {
.Speed = ReadingSpeed.Balanced,
.ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-sheet.png", options)
For Each result In multiResults
Console.WriteLine(result.Value)
Next
' Read from a stream directly
Using fileStream = File.OpenRead("barcode.png")
Dim streamResults = BarcodeReader.Read(fileStream)
End UsingIronBarcodeのバーコード読み取りに関するドキュメントには、複数ページのPDFファイル、関心領域の読み取り、およびパフォーマンス調整オプションについて記載されています。
SVG出力
バーコード方式:
using Barcoder.Renderers;
var svgRenderer = new SvgRenderer();
using var stream = File.OpenWrite("barcode.svg");
svgRenderer.Render(barcode, stream);Imports Barcoder.Renderers
Dim svgRenderer = New SvgRenderer()
Using stream = File.OpenWrite("barcode.svg")
svgRenderer.Render(barcode, stream)
End UsingIronBarcodeのアプローチ:
using IronBarCode;
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
.SaveAsSvg("barcode.svg");Imports IronBarCode
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
.SaveAsSvg("barcode.svg")すべてのSVGレンダリングサイトが移行されると、Barcoder.Renderer.Svgパッケージは削除できます。
バーコード API からIronBarcodeへのマッピング リファレンス
| バーコード | IronBarcode |
|---|---|
Code128Encoder.Encode("data", false) | BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) |
QrEncoder.Encode("data", ErrorCorrectionLevel.M) | QRCodeWriter.CreateQrCode("data", 500) |
DataMatrixEncoder.Encode("data") | BarcodeWriter.CreateBarcode("data", BarcodeEncoding.DataMatrix) |
new ImageRenderer(new ImageRendererOptions { ... }) | 不要 |
renderer.Render(barcode, fileStream) | .SaveAsPng(path) |
renderer.Render(barcode, memoryStream) + ms.ToArray() | .ToPngBinaryData() |
IBarcode | GeneratedBarcode |
PixelSize = 2, BarHeightFor1DBarcode = 50 | .ResizeTo(width, height) |
SvgRenderer + renderer.Render(barcode, stream) | .SaveAsSvg(path) |
| 読み取りAPIはありません | BarcodeReader.Read(path / stream / bytes / pdf) |
2つのパッケージ — Barcoder + Barcoder.Renderer.Image | 1つのパッケージ — IronBarcode |
エンコーダーごとのフォーマット名前空間(Barcoder.Code128, Barcoder.Qrなど) | BarcodeEncoding列挙型、単一の名前空間 |
一般的な移行の問題と解決策
問題1:IBarcodeには保存メソッドがない
Barcoder:IBarcode変数を格納し、後でレンダラーに渡すコードは、遅延レンダリングパターンに従います。 renderer.Render()を呼び出すすべてのヘルパーメソッドはリファクタリングが必要です。
解決策: GeneratedBarcodeに変更します。 GeneratedBarcodeオブジェクトは、それ自体の出力メソッドを持っているので、結果を保存またはシリアル化する必要があるメソッドに渡します。
// IronBarcode — GeneratedBarcode carries output methods
using IronBarCode;
var barcode = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128);
SaveBarcodeToFile(barcode, "output.png");
static void SaveBarcodeToFile(GeneratedBarcode barcode, string path)
{
barcode.SaveAsPng(path);
}Imports IronBarCode
Dim barcode = BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
SaveBarcodeToFile(barcode, "output.png")
Private Sub SaveBarcodeToFile(barcode As GeneratedBarcode, path As String)
barcode.SaveAsPng(path)
End Subソリューション全体でrenderer.Render(を検索すると、すべての遅延レンダリングサイトが見つかります。
問題2:PixelSizeには直接的な同等のものが存在しない
Barcoder:PixelSizeは、バーコードの自然なモジュールサイズへのスケール乗算子です。出力寸法は、コンテンツの長さ、フォーマット、および乗数の組み合わせに依存します。 BarHeightFor1DBarcodeは、1Dの高さを独立して制御します。 幅や高さに関する直接的な指定はありません。
**解決策:**既存のBarcoderコードが生成する実際のピクセル出力を測定し、それらの値を.ResizeTo(width, height)に渡します。
BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128)
.ResizeTo(300, 80)
.SaveAsPng("barcode.png");BarcodeWriter.CreateBarcode("data", BarcodeEncoding.Code128) _
.ResizeTo(300, 80) _
.SaveAsPng("barcode.png")問題3:フォーマット名前空間インポートの蓄積
**Barcoder:**プロジェクトで使用される各バーコードフォーマットは、それを使用する各ファイルにusing Barcoder.[Format]ディレクティブを追加します。 Code128、QR、およびDataMatrixを使用するプロジェクトでは、通常、ファイルごとに3つの形式固有のインポートがあり、using Barcoder.Renderersもあります。
**解決策:**すべてのusing IronBarCode;に置き換えます。
grep -rn "using Barcoder" --include="*.cs" .
すべての結果は削除すべき行であり、ファイルごとに1回、単一のusing IronBarCode;ディレクティブに置き換えられます。
問題4:パッケージバージョンの同期エラー
Barcoder:Barcoder.Renderer.Imageのいずれか1つを更新後にビルドすると、タイプ解決エラーが発生する可能性があります。これは、2つのパッケージが異なるバージョンの組み合わせで互換性がない可能性があるためです。
**解決策:**両方のBarcoderパッケージを削除してIronBarcodeをインストールした後、1つのパッケージと1つのバージョンになります。 このカテゴリにおけるパッケージロックの競合は解消されます。 Barcoder.*参照がないことを確認してください。
バーコード移行チェックリスト
マイグレーション前のタスク
変更を加える前に、コードベースを監査して、Barcoderの使用箇所をすべて特定してください。
grep -rn "using Barcoder" --include="*.cs" .
grep -rn "Code128Encoder\.Encode" --include="*.cs" .
grep -rn "QrEncoder\.Encode" --include="*.cs" .
grep -rn "DataMatrixEncoder\.Encode" --include="*.cs" .
grep -rn "ImageRenderer\|ImageRendererOptions" --include="*.cs" .
grep -rn "SvgRenderer" --include="*.cs" .
grep -rn "renderer\.Render(" --include="*.cs" .
grep -rn "IBarcode" --include="*.cs" .
grep -rn "ErrorCorrectionLevel" --include="*.cs" .
IBarcodeが変数型として格納されたり、メソッドパラメーターとして渡されたりするすべての場所を文書化してください。これらは、最も注意を要する遅延レンダリングのサイトです。 BarHeightFor1DBarcodeのすべての値を記録し、対応する出力寸法を測定します。
コード更新タスク
- すべてのプロジェクトから
BarcoderNuGetパッケージを削除します - すべてのプロジェクトから
Barcoder.Renderer.ImageNuGetパッケージを削除します Barcoder.Renderer.SvgNuGetパッケージが存在する場合、削除しますIronBarcodeNuGetパッケージをインストールします- アプリケーションの起動時に
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";を追加します - すべての
using IronBarCode;に置き換えます BarcodeWriter.CreateBarcode(..., BarcodeEncoding.Code128)で置き換えますQRCodeWriter.CreateQrCode(..., size)で置き換えますBarcodeWriter.CreateBarcode(..., BarcodeEncoding.DataMatrix)で置き換えます- すべての
new ImageRenderer(new ImageRendererOptions {...})構築を削除します .SaveAsPng(path)に置き換えますrenderer.Render(barcode, memoryStream)+.ToPngBinaryData()で置き換えます.SaveAsSvg(path)に置き換えますGeneratedBarcodeに変更します.ResizeTo(width, height)に置き換えます
移行後のテスト
生成された各バーコード形式が、標準スキャナーまたはIronBarcode独自のリーダーで正しくスキャンできることを確認してください。
- マイグレーション前の出力寸法と視覚出力寸法を比較し、
.ResizeTo()の値が同等のサイズを生成することを確認します - QRコードの出力をスマートフォンのスキャナーでテストし、エラー訂正レベルが適切であることを確認する。 プロジェクトでSVGを使用している場合は、ブラウザと印刷環境でSVG出力が正しくレンダリングされることを確認してください。
- 第2の読み取りライブラリを削除した場合、
BarcodeReader.Read()が同じ入力で同等のデコード値を生成することを確認してください プロジェクトで PDF 文書を処理する場合は、PDF の読み取りをテストしてください。複数ページの PDF 文書がすべてのページを正しく読み取ることを確認してください。 - すべての
Barcoder.*参照が残っていない状態でビルドを実行し、コンパイラーエラーが発生する場合は、見逃した移行サイトを示しています
IronBarcodeへの移行の主なメリット
パッケージ依存関係の統合: 1つのNuGetパッケージで2つ(SVGレンダラーも使用していた場合は3つ)のパッケージを置き換えます。 追跡するバージョンは1つ、監視する変更履歴も1つ、そして依存関係の更新時にパッケージ間の互換性の問題は発生しません。 packages.lock.jsonの複雑さは即座に減少します。
**ネイティブ読み取り機能:**従来バーコード読み取りのために別のライブラリが必要だったアプリケーションは、 IronBarcodeに統合できます。 BarcodeReader.Read()は、画像ファイル、バイト配列、ストリーム、およびPDFを同一のAPIを介して受け取り、マルチバーコード検出および読み取り速度調整機能が組み込まれています。
**形式選択を設定として:**既存のプロジェクトに新しいバーコード形式を追加することは、既存のBarcodeEncoding列挙型の値を一語変更するだけです。 新しい名前空間のインポートも、新しいエンコーダークラスも、新しいパッケージもありません。 これにより、製品要件の変化に応じてフォーマットを拡張する際の摩擦が軽減されます。
明示的な出力寸法:PixelSize乗数システムを明示的なピクセル指定で置き換えます。 コードと出力の関係は直接的かつ予測可能であり、バーコードの内容の長さやフォーマット固有のモジュールサイズとは無関係である。
プラットフォーム対応範囲の拡大: IronBarcodeは、 .NET Framework 4.6.2から.NET 9までをサポートし、iOS、Android、Windows、macOSへのMAUIデプロイメント、およびDocker、AWS Lambda、Azure Functionsへのデプロイメントに関するドキュメントを提供しています。 プラットフォームの要件が.NET Coreを超えて拡張されるチームは、Barcoder.Renderer.Imageに影響を与えるフレームワークサポートのギャップに直面しません。
積極的なメンテナンスと将来的な互換性: IronBarcodeは、 .NETとの互換性に関するタイムラインを文書化した定期的なアップデートをリリースしています。 アクティブなリリースサイクルは、ライブラリを現在 for .NETバージョンに合わせ続け、最近のリリース活動が限定されているライブラリからは保証されません。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。