CameraBarcodeReaderView架構

CameraBarcodeReaderView控件是ZXing.Net.MAUI的中央組件。 它在XAML中聲明，並通過BarcodeReaderOptions綁定進行配置。 每個使用它的頁面都必須實施IsDetecting狀態：

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <zxing:CameraBarcodeReaderView
        x:Name="CameraView"
        Options="{Binding ReaderOptions}"
        BarcodesDetected="OnBarcodesDetected" />
</ContentPage>

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <zxing:CameraBarcodeReaderView
        x:Name="CameraView"
        Options="{Binding ReaderOptions}"
        BarcodesDetected="OnBarcodesDetected" />
</ContentPage>

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  //否IDisposable on the control
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  //否IDisposable on the control
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

' Toggling IsDetecting in lifecycle overrides is the documented pattern
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False '否IDisposable on the control
    End If
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = True
    End If
End Sub

ZXing.Net.MAUI應用程式中的每個掃描頁面都帶有此生命周期樣板。 缺少Dispose模式。

詳細功能比較

ZXing.Net.MAUI 方法

ZXing.Net.MAUI 是圍繞 iOS 和 Android 的平台相機 API 設計的。 Windows MAUI僅支持條碼生成——沒有實現相機掃描，也不在公眾路線圖中。這反映了將程式庫構建為現有相機取景器控件的架構選擇，這些平台實現僅為移動操作系統編寫。

針對net8.0-windows10.0.19041.0的MAUI項目不會從ZXing.Net.MAUI獲取條碼掃描功能。 Mac Catalyst在目標框架列表中出現，但在該目標上的掃描未正式記錄。 只針對移動裝置開始專案後，後來新增Windows或macOS需求的團隊將發現ZXing.Net.MAUI無法覆蓋這些目標的掃描用例。 即使是iOS支持本身也帶有警告：GitHub問題#260記錄了iPhone 15 Pro和Pro Max裝置受到自動對焦問題影響，無法實現可靠檢測。

IronBarcode 方法

IronBarcode支持所有MAUI目標框架——iOS、Android、Windows和macOS——從相同包和同程式碼路徑部署。 MediaPicker + MediaPicker.CapturePhotoAsync()喚起裝置相機； 在Windows上，它映射到文件選擇器，這是桌面環境中適當的行為。 無需平台特定程式碼，無條件編譯，無需平台服務註冊。

MAUI 桌面條碼模式"Windows 和 macOS"由同一包涵蓋，用於處理移動端掃描。 同一個BarcodeReader.Read()調用在Android 裝置上運行，也能在ASP.NET Core端點、WinForms桌面應用程式或Azure Function中運行——部署目標不會影響API。

ZXing.Net.MAUI 方法

CameraBarcodeReaderView是一個持久的相機控件嵌入在XAML頁面中。 當false時停止。 缺乏IDisposable模式釋放。 記錄的補救措施是將OnAppearing()恢復它：

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    CameraView.IsDetecting = true;
}

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    CameraView.IsDetecting = true;
}

' ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    CameraView.IsDetecting = False
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    CameraView.IsDetecting = True
End Sub

此模式必須在每個裝載掃描器的頁面上重複。 導航頻繁往來掃描頁面的應用程式可能會積累未完全釋放的相機資源，這與GitHub問題#164一併追踪，出現記憶體增長和返回時偶發性相機初始化。 iPhone 15 Pro自動對焦問題（GitHub問題#260）是相機整合層內的另一問題：相機視圖清晰渲染條碼，但自動對焦系統無法清晰鎖定於iPhone16,2硬體。 記錄的應對方案是指導使用者手動調整裝置與條碼之間的距離。

IronBarcode 方法

IronBarcode 不在 XAML 佈局中嵌入相機控件。 而是當使用者點擊按鈕時，MediaPicker.CapturePhotoAsync() 會打開系統相機UI。 系統相機獨立處理焦點、曝光和自動對焦。 當使用者確認拍攝時，生成的影像作為位元組 массива傳遞給BarcodeReader.Read()：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanButton_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 barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

//否OnAppearing or OnDisappearing needed — no camera state to manage

// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanButton_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 barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

//否OnAppearing or OnDisappearing needed — no camera state to manage

Imports IronBarCode
Imports System.IO

Private Async Sub ScanButton_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 barcode In results
                Console.WriteLine($"{barcode.Format}: {barcode.Value}")
            Next
        End Using
    End Using
End Sub

'否OnAppearing or OnDisappearing needed — no camera state to manage

.NET MAUI 條碼掃描教程涵蓋此模式的完整項目設置，包括iOS和Android的權限配置。 因為沒有持續的相機檢視，沒有要釋放的資源，沒有需切換的狀態，以及不必在頁面間維護生命周期樣板。

ZXing.Net.MAUI 方法

ZXing.Net.MAUI 繼承了 ZXing.Net 格式規範要求。 在掃描開始之前，開發者必須用BarcodeFormats枚舉值的位遮罩。 不包含在此列表中的格式將無法檢測——默默地，沒有錯誤或警告：

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

' ZXing.Net.MAUI: formats must be declared explicitly
' Formats not listed here are not detected
ReaderOptions = New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA,
    .TryHarder = True,
    .AutoRotate = True
}

如果使用者用相機對準 GS1 DataBar、Aztec code、MaxiCode或任何未在選項中聲明的格式，掃描將不返回結果且不報錯。 相機會渲染條碼，但沒有返回結果給應用程式。 在一個受控環境中——每個項目都有一個Code128標籤的倉庫中——可以控管。 在條碼格式由外部供應商、客戶或第三方系統確定的部署中，缺少回退路徑會成為重複的支援問題。

IronBarcode 方法

IronBarcode 在所有支援格式中自動執行格式檢測，無需預先配置。 BarcodeReader.Read() 分析影像並返回它識别的每個條碼的結果，不管格式。 不需要BarcodeReaderOptions列表：

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

Imports IronBarcode

' IronBarcode: no format specification needed
' All 50+ formats detected automatically
Dim results = BarcodeReader.Read(imageBytes)
For Each barcode In results
    Console.WriteLine($"{barcode.Format}: {barcode.Value}")
Next

如果需要性能調整，用於僅期待某一格式的受控情況，可以選擇性傳過格式提示——但正確檢測從不需要。 即使是由開發者未預期的格式的條碼，也會被檢測到並返回。

ZXing.Net.MAUI 方法

ZXing.Net.MAUI 是一個相機控制庫。 它沒有用於從檔案路徑，直接從儲存傳遞的位元組陣列，或PDF文件中讀取條碼的API。 CameraBarcodeReaderView 控件需要即時相機反饋； 沒有靜態方法接受檔案路徑並返回條碼結果。 需要從上傳的PDF、檔案管理系統或者批處理影像處理隊列中讀取條碼的團隊無法在這些情景中使用ZXing.Net.MAUI，必須引入一個獨立的程式庫。

IronBarcode 方法

IronBarcode 從任何來源通過相同的BarcodeReader.Read()方法讀取條碼。 它接受檔案路徑、位元組陣列、流和PDF文件。 PDF解析是原生的——IronBarcode直接處理PDF頁面，而無需中間光柵化步驟：

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read barcodes from a PDF file
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read barcodes from a PDF file
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

Imports IronBarCode
Imports Microsoft.Maui.Storage

' Read barcodes from a PDF file
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

' Read from a user-selected file using MAUI FilePicker
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim fileResults = BarcodeReader.Read(file.FullPath)
    For Each result In fileResults
        ResultLabel.Text &= $"\n{result.Format}: {result.Value}"
    Next
End If

完整的PDF條碼讀取工作流程，包括多頁文件和跨頁的混合條碼格式，文件於 從PDF讀取條碼指南中。 這涵蓋運單，數位票證，檔案管理工作流程，以及ZXing.Net.MAUI無法解決的批處理情境。

Windows MAUI需求

重新評估的最常見觸發因素是將Windows MAUI目標新增到只啓動於iOS和Android的項目中。 MAUI團隊通常以移動優先的構建開始，隨著需求的變化，擴展到桌面目標。 當這種擴展發生時，ZXing.Net.MAUI未提供前進的道路——未實現Windows平臺，且不在公眾路線圖中。團隊必須要麼接受Windows上的條碼掃描將無法使用，要麼替換庫。 由於替換無論如何涉及到對於掃描模式的結構改變，團隊通常對所有平臺同時進行更改。

當前世代硬體相容性

iPhone 15 Pro 自動對焦問題（GitHub 問題 #260）是任何想向 iOS 使用者推出生產條碼掃描儀的團隊都必須考量的問題。 iPhone 15 Pro 和 Pro Max 是消費者市場中期望得到精緻應用體驗的常見機型，而要求使用者調整距離以掃描條碼的變通方案相較於舊款 iPhone 硬體來說，是明顯的使用者體驗退化。 在質檢中浮現此問題的團隊，或從iPhone 15 Pro使用者處收到支援報告的團隊，面臨的是繼續使用目前沒有可用修補的庫，還是遷移到不受相機查看焦點模型影響的解決方案。

檔案與文件處理

條碼掃描需求很少局限於現場相機捕獲。 從作為庫存掃描儀開始的應用通常會擴展以包括從已上傳的PDF讀取條碼，處理運送單據，或處理電子郵件附件中的數位票證。 ZXing.Net.MAUI對於這些場景沒有提供API。 當有讀取檔案或文件中的條碼的產品需求出現在待辦事項中，使用ZXing.Net.MAUI的團隊就必須引入一個單獨的庫來處理它。 如果團隊已經在為這些基於文件的情境中使用IronBarcode，整合MAUI相機掃描到相同的庫中則成為自然的下一步。

生產穩定性需求

v0.7.4的前1.0標籤——儘管該包本身爲一個穩定的NuGet版本——在進行軟體組成分析、依賴性審計或內部審批流程的團隊中有其意義。 某些企業環境要求生產依賴項具有1.0+穩定釋出，商業支持合同，或者兩者兼具。 ZXing.Net.MAUI是社羣維護的前1.0程式庫，適合用於內部工具和原型，但增加了在客戶導向應用程式中需要審覈的步驟，即當條碼掃描儀是主要工作流程時。 缺乏付費支援層級意味著任何重要錯誤取決於社羣維護者的可用性。

CameraBarcodeReaderView到MediaPicker模式

CameraBarcodeReaderView XAML控件及其xmlns:zxing命名空間宣告完全被移除。 在每個XAML文件中含有一個掃描器視圖，替換為MediaPicker.CapturePhotoAsync()。 事件驅動模式——其中結果透過BarcodeReader.Read()的返回值所取代。

去掉 IsDetecting 生命週期

每個CameraView.IsDetecting，可以被刪除。 即使這些覆蓋包含其他頁面生命周期邏輯，IsDetecting行被移除，並保留剩餘邏輯。 IronBarcode並無同語法的IsDetecting，因未維持持續相機狀態於頁面導航之間。

去掉 UseBarcodeReader() 註冊

ZXing.Net.MAUI要求在builder.UseBarcodeReader()調用來註冊其平臺相機服務。 IronBarcode不需要任何MauiProgram.cs註冊。 using ZXing.Net.Maui;命名空間導入也隨著包解除安裝而移除。