BarcodeScanning.MAUI 與 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 系統中，蘋果的 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； 在伺服器上，它來自表單上傳； 在桌面應用程式中，它來自檔案對話框。

//IronBarcodein 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;
}

//IronBarcodein 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

'IronBarcode in MAUI: capture a photo, then read barcodes from it
' NuGet: dotnet add package IronBarcode

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 特有的（Vision 框架）和 Android 特有的（ML Kit）原生 API。 Windows 系統本身不具備這兩種 API。 建立面向 iOS、Android 和 Windows 的 MAUI 應用程式的團隊（這是標準的多目標場景）不能使用 BarcodeScanning.Native.Maui 作為所有三個目標的條碼解決方案。 他們要么必須單獨為 Windows 平台編寫特定程式碼，要么必須完全替換該程式庫。

IronBarcode方法

IronBarcode 的 BarcodeReader.Read() 呼叫可在 Windows、iOS、Android 和 macOS MAUI 目標上運行，無需任何平台特定的程式碼。 沒有 #if WINDOWS 程式碼區塊，沒有條件依賴加載，也不需要存根實作。 對於文件和 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也支援在 ASP.NET、Docker、Azure Functions 和 AWS Lambda 環境中進行伺服器端部署，而 BarcodeScanning.Native.Maui 在這些環境中根本沒有路徑。

條碼掃描.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 issues 中被單獨記錄為"非常有問題——大多數掃描都不會發生"，影響貨運標籤、駕駛執照和登機證。

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

對於條碼資料準確性直接影響庫存查找、銷售點交易或供應鏈整合的應用而言，IronBarcode 的正確格式處理消除了 BarcodeScanning.Native.Maui 在應用程式程式碼中留下的一類生產錯誤。 IronBarcode 條碼讀取文件詳細介紹了特定格式的行為。

已將 Windows MAUI 目標新增至建置中

MAUI 應用程式通常以 iOS 和 Android 為目標平台，隨著應用程式的成熟或企業分發需求的擴展，再逐步加入 Windows 版本。 在新增 Windows 目標後，BarcodeScanning.Native.Maui 會立即成為一個阻礙因素——庫中沒有 Windows 實現，也沒有解決方法。 在這種情況下，團隊要么必須使用不同的庫為 Windows 維護單獨的條碼實現，要么必須將整個條碼層遷移到一個可以在所有 MAUI 目標上一致工作的庫。 第二條路徑操作起來更簡單，並且消除了平台特定分支的維護開銷。

新增文件上傳或PDF處理要求

行動應用程式通常最初以即時攝影機掃描作為唯一的輸入方式，之後才擴展到接受上傳的影像或文件。 當使用者需要掃描圖庫中的照片、透過電子郵件收到的圖像或包含貨運清單或登機證的 PDF 中的條碼時，BarcodeScanning.Native.Maui 沒有可提供的程式碼路徑。 達到此需求閾值的團隊面臨一個選擇：要么在 BarcodeScanning.Native.Maui 之外再添加一個條碼庫來處理文件和 PDF 輸入，要么遷移到一個能夠處理所有輸入類型的單一庫。管理兩個具有不同 API、不同結果類型和不同格式支援表的條碼包會增加長期的複雜性，而單一套件解決方案則可以避免這一點。

伺服器端條碼處理技術推出

在行動裝置上掃描條碼的應用程式通常會開發一個伺服器端元件——一個用於驗證條碼的 ASP.NET API 端點、一個用於處理 PDF 的後台作業，或一個用於從上傳的文件中提取追蹤號碼的雲端函數。 BarcodeScanning.Native.Maui 是一個依賴相機硬體上下文的 UI 控制庫； 它無法在伺服器進程中運行。 如果團隊需要在行動端和伺服器端使用相同的條碼讀取邏輯，則伺服器端必須使用不同的函式庫。當出現伺服器端需求時，團隊通常會評估是使用同時涵蓋行動端和伺服器端的單一函式庫，還是維護兩個獨立的實作更可取。

UPC-A 數據準確性成為生產問題

iOS UPC-A 13 位數的行為並非總是能在開發過程中被發現。 在開發過程中掃描的 UPC-A 條碼可能看起來運作正常，但 Apple 的 Vision 框架引入的前導零會出現在資料庫中。 在庫存記錄、銷售點系統或供應鏈整合中發現 13 位元 UPC-A 值的團隊，除了面臨程式碼問題外，還面臨資料修正問題。 BarcodeScanning.Native.Maui 的 GitHub 問題中記錄的解決方法可以修正新的掃描結果，但無法修復歷史資料。 當資料品質問題的範圍變得明確時，遷移到無需應用級規範化即可返回正確 UPC-A 值的庫通常是更清晰的長期解決方案。

PDF417 文件掃描要求

PDF417 是北美地區用於貨運標籤、駕駛執照和登機證的條碼格式。 這些是物流、身分驗證和旅遊應用中常見的掃描目標。 BarcodeScanning.Native.Maui 的 GitHub 問題追蹤器將 PDF417 描述為"問題重重——大多數掃描都無法成功"。對於任何將 PDF417 的可靠性視為功能性要求而非錦上添花的應用來說，這個已知問題會直接阻礙應用的運行，迫使開發者評估其他替代庫。

相機事件到媒體選擇器和靜態讀取

遷移的核心結構變化是用 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 位元行為的程式碼庫都會有程式碼檢查 BarcodeFormat.UPC_A 並呼叫 Substring(1) 來移除前導零。 遷移後必須刪除此程式碼 —IronBarcode傳回正確的 12 位元值，保留此變通方法會錯誤地從有效的 UPC-A 讀取中移除第一位數字。

MAUI權限

BarcodeScanning.Native.Maui 會在其軟體包設定過程中自動為 Android 和 iOS 清單新增相機權限。當IronBarcode使用 MediaPicker 時，需要 AndroidManifest.xml 和 Info.plist 中的標準 MAUI 相機權限－這與任何 MAUI 應用在 MediaPicker.CapturePhotoAsync()@ 中所需的權限相同。 這些權限通常已存在於使用攝影機的 MAUI 專案中，無論專案用途如何。