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

ライブカメラのスキャンパターン

BarcodeScanning.Native.Maui API パターン全体は、XAML コントロールと C# イベント ハンドラーの組み合わせで構成されています。

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

このコントロールにより、ユーザーはMAUIページに埋め込まれたリアルタイムのビューファインダーを利用できるようになります。 カメラ映像がアクティブな間は、バーコード検出機能が継続的に作動します。"ポイント＆スキャン"が主な操作となるコンシューマー向けアプリにとって、このユーザーエクスペリエンスは非常に優れています。 制限事項としては、このライブラリがサポートするインタラクションはこれだけであり、iOSやAndroidでのライブカメラ検出を超える要件が発生した場合、BarcodeScanning.Native.Mauiでは対応できません。

詳細な機能比較

バーコードスキャン。MAUIアプローチ

BarcodeScanning.Native.Mauiは、各プラットフォームのネイティブカメラ検出パイプラインをラップします。 Androidでは、ML Kitがフレームを処理します。 iOSでは、AppleのVisionフレームワークがフレームを処理します。 このライブラリは、MAUIのCameraView@コントロールとして、OnDetectionFinished@イベントとともに表示されます。 アプリケーションコードは画像バイトを直接処理することはなく、イベントから得られる検出されたバーコード値のみを処理します。

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

この設計の結果、他に侵入経路は存在しない。 カメラは必須です。図書館が認識する唯一の入力機器です。 サーバー、ファイル、PDF、Windowsマシン――これらのどれも、このライブラリが想定するような意味でのカメラは備えていません。

IronBarcodeのアプローチ

IronBarcodeは静的メソッドで画像データを受け取ります。 呼び出し元はあらゆるソースからデータを提供し、ライブラリがそれをデコードする。 MAUIでは、データはMediaPickerから来ています； サーバー上では、フォームアップロードによって取得されます。 デスクトップアプリケーションでは、ファイルダイアログから取得されます。

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO

Private Async Sub ScanBarcodeButton_Clicked(sender As Object, e As EventArgs)
    Dim photo = Await MediaPicker.CapturePhotoAsync()
    If photo Is Nothing Then Return

    Using stream = Await photo.OpenReadAsync()
        Using ms As New MemoryStream()
            Await stream.CopyToAsync(ms)

            Dim results = BarcodeReader.Read(ms.ToArray())
            For Each result In results
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

このコードは、iOS、Android、およびWindows MAUIで全く同じように動作します。 サーバサイドで使用する場合、同じBarcodeReader.Read()メソッドは、アップロードされたファイルのバイト配列またはPDFパスを受け入れます。 IronBarcodeのドキュメントには、サポートされているすべての入力タイプが記載されています。

バーコードスキャン。MAUIアプローチ

BarcodeScanning.Native.Maui は、MAUI の Windows ターゲットをサポートしていません。 これは一時的な隙間ではなく、図書館の建築構造に起因する構造的な結果である。 このライブラリは、iOS固有のネイティブAPI（Visionフレームワーク）とAndroid固有のネイティブAPI（ML Kit）をラップしています。Windowsにはどちらもありません。 iOS、Android、Windowsを対象とするMAUIアプリケーションを開発するチーム（標準的なマルチターゲットシナリオ）は、BarcodeScanning.Native.Mauiを3つのターゲットすべてに対応するバーコードソリューションとして使用することはできません。 Windows向けにプラットフォーム固有のコードを別途実装するか、ライブラリ全体を置き換えるかのいずれかを選択する必要がある。

IronBarcodeのアプローチ

IronBarcodeのBarcodeReader.Read()@コールは、Windows、iOS、Android、macOS MAUIターゲット上でプラットフォーム固有のコードなしで動作します。 CODE-38443--@@@ブロック、条件付き依存性ロード、スタブ実装は必要ありません。 ファイル入力とPDF入力についても、パターンは一貫しています。

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

IronBarcodeのMAUI統合ガイドには、すべてのMAUIターゲットに対する完全なセットアップ手順が記載されています。 IronBarcodeは、BarcodeScanning.Native.MauiにパスがまったくないASP.NET、Docker、Azure Functions、およびAWS Lambda環境でのサーバーサイドデプロイメントもサポートしています。

バーコードスキャン。MAUIアプローチ

iOSでは、BarcodeScanning.Native.Mauiの基盤となる検出機能（Apple Vision）は、UPC-Aバーコードに対して13桁の数字を返します。 UPC-Aは12桁の形式です。 先頭の余分なゼロはEAN-13エンコーディングと一致します。 ライブラリはこの生の値を修正せずにそのまま渡します。 UPC-A値をデータベースに保存するアプリケーションは、本来含まれるべきではない先頭のゼロを含むレコードを蓄積してしまう可能性があります。

文書化された回避策では、フォーマットを確認し、値を切り詰める必要があります。

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

' Workaround required for iOS UPC-A — strip the leading zero manually
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormat.UPC_A AndAlso value.Length = 13 Then
        value = value.Substring(1) ' strip Apple's prepended leading zero
    End If

    ProcessBarcode(value)
End Sub

この回避策は、フォーマットチェックを省略した場合、0で始まるEAN-13バーコードを暗黙のうちに破損させてしまう。 PDF417はGitHubの課題報告で"非常に問題が多い ― ほとんどのスキャンは実行されない"と別途記載されており、配送ラベル、運転免許証、搭乗券に影響を及ぼしている。

IronBarcodeのアプローチ

IronBarcodeは、手動による正規化を行わずに、正しい12桁のUPC-A値を返します。 PDF417は、確実に読み込めるサポートされているフォーマットです。 生成側はIronBarcodeのAPIを通じても利用可能です。

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

バーコードデータの精度が在庫検索、POS取引、サプライチェーン統合に直接影響するアプリケーションの場合、IronBarcodeの正しいフォーマット処理により、BarcodeScanning.Native.Mauiがアプリケーションコードに残してしまう種類の本番環境におけるバグが解消されます。 IronBarcodeのバーコード読み取りに関するドキュメントでは、フォーマット固有の動作について詳細に解説しています。

Windows MAUIターゲットがビルドに追加されました

MAUIアプリケーションは通常、iOSとAndroidをターゲットとして開発が始まり、アプリケーションの成熟度やEnterprise配布要件の拡大に伴い、後からWindowsを追加する。 Windowsターゲットを追加すると、BarcodeScanning.Native.Mauiがすぐに問題となります。ライブラリ内にWindows実装がなく、回避策もありません。 このような状況にあるチームは、別のライブラリを使用してWindows用のバーコード実装を別途維持するか、バーコードレイヤー全体をすべてのMAUIターゲットで一貫して動作するライブラリに移行する必要があります。 2つ目の方法は運用がより簡単であり、プラットフォーム固有の分岐に伴うメンテナンスの手間を省くことができる。

ファイルアップロードまたはPDF処理の要件が追加されました

モバイルアプリケーションは、多くの場合、入力方法としてライブカメラによるスキャンのみから始まり、後にアップロードされた画像やドキュメントを受け入れるように拡張される。 ユーザーがギャラリーの写真、電子メールで受信した画像、または出荷明細書や搭乗券を含むPDFからバーコードをスキャンする必要がある場合、BarcodeScanning.Native.Mauiには対応するコードパスがありません。 この要件の境界に達したチームは、BarcodeScanning.Native.Maui に加えてファイルおよび PDF 入力用の別のバーコードライブラリを追加するか、すべての入力タイプを処理する単一のライブラリに移行するかの選択を迫られます。異なる API、異なる結果タイプ、異なるフォーマットサポートテーブルを持つ 2 つのバーコード パッケージを管理すると、長期的に複雑さが増しますが、単一パッケージのソリューションではこれを回避できます。

サーバーサイドでのバーコード処理が導入されました

モバイル端末でバーコードをスキャンするアプリケーションは、多くの場合、サーバー側のコンポーネントを開発します。これは、バーコードを検証するASP.NET APIエンドポイント、PDFを処理するバックグラウンドジョブ、またはアップロードされたドキュメントから追跡番号を抽出するクラウド関数などです。 BarcodeScanning.Native.Mauiは、カメラのハードウェアコンテキストに依存するUIコントロールライブラリです。 サーバープロセスでは実行できません。 モバイルとサーバーの両方で同じバーコード読み取りロジックが必要なチームは、サーバー側で別のライブラリを使用する必要があります。サーバー側の要件が発生すると、チームはモバイルとサーバーの両方をカバーする単一のライブラリに統合する方が、2つの別々の実装を維持するよりも望ましいかどうかを検討することがよくあります。

UPC-Aデータの正確性が生産上の問題となる

iOSのUPC-A 13桁の動作は、開発段階で必ずしも検出されるとは限りません。 開発段階でスキャンされたUPC-Aバーコードは正しく動作するように見えるかもしれませんが、AppleのVisionフレームワークによって導入された先頭のゼロがデータベースに表示されます。 在庫記録、POSシステム、またはサプライチェーン統合において13桁のUPC-A値を発見したチームは、コードの問題に加えて、データの修正という問題にも直面する。 BarcodeScanning.Native.MauiのGitHubイシューに記載されている回避策は、新規スキャンを修正しますが、過去のデータは修正しません。 データ品質問題の範囲が明確になった場合、アプリケーションレベルの正規化を行わずに正しいUPC-A値を返すライブラリに移行することが、多くの場合、よりクリーンな長期的な解決策となります。

PDF417文書のスキャンが必要です

PDF417は、北米において配送ラベル、運転免許証、搭乗券などに使用されているバーコード形式です。 これらは、物流、本人確認、旅行関連のアプリケーションでよくスキャンされる対象です。 BarcodeScanning.Native.MauiのGitHubイシュートラッカーには、PDF417が"非常に問題が多く、ほとんどのスキャンは実行されない"と記載されています。PDF417の信頼性が必須要件であり、あれば良いというものではないアプリケーションにとって、この既知の問題は直接的な障害となり、代替ライブラリの評価を余儀なくされます。

カメライベントをMediaPickerと静的読み取りに転送

マイグレーションにおける中心的な構造的変更は、連続的なカメラ・イベント・パターンを、MediaPicker@キャプチャに続いてBarcodeReader.Read()@に置き換えることです。 イベントハンドラ、XAMLコントロール、XML名前空間宣言はすべて削除されています。 その代わりに、ボタンがMediaPicker.CapturePhotoAsync()をトリガーし、その結果の写真バイトがBarcodeReader.Read()に渡されます。 これにより、ユーザーエクスペリエンスはライブビューファインダーからシステムカメラの画面へと変化し、ほとんどのビジネスアプリケーションに適したものとなる。

スレッドマーシャリングの変更点

BarcodeScanning.Native.MauiはバックグラウンドのスレッドでOnDetectionFinished@を実行するため、UI要素を更新する既存のハンドラはすべてMainThread.BeginInvokeOnMainThread()@で更新をラップします。 IronBarcodeで使用されるMediaPicker + asyncパターンでは、awaitの後の継続は、通常メインスレッドである呼び出しコンテキストに戻ります。 ほとんどの場合、MainThread.BeginInvokeOnMainThread()ラッパーを削除して、イベントハンドラのコードを簡素化することができます。

UPC-A の回避策による削除

BarcodeScanning.Native.MauiのiOS UPC-A 13桁の動作を処理したコードベースは、@--CODE-38474--@@をチェックし、@--CODE-38475--@を呼び出して先頭のゼロを取り除くコードを持つことになります。 移行後、このコードは削除する必要があります。IronBarcodeは正しい12桁の値を返すため、この回避策を残しておくと、有効なUPC-A読み取り値から最初の桁が誤って削除されてしまいます。

マウイ島の許可

BarcodeScanning.Native.Mauiは、パッケージセットアップの一環として、AndroidおよびiOSマニフェストにカメラパーミッションを自動的に追加します。CODE-38476--@@を使用するIronBarcodeでは、@@--CODE-38477--@と@@--CODE-38478--@の標準MAUIカメラパーミッションが必要です。 これらの権限は、カメラを何らかの目的で使用するMAUIプロジェクトには通常既に含まれています。