O problema fundamental

O problema estrutural é que CameraBarcodeReaderView bloqueia o desenvolvedor em um loop de eventos centrado na câmera com gerenciamento manual do ciclo de vida e uma lista de formatos fixos. Para qualquer coisa além do escaneamento básico de câmera no iOS e Android com formatos de código de barras conhecidos, a arquitetura atinge seu limite:

// ZXing.Net.MAUI: event loop, format list, lifecycle boilerplate on every scan page
public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode |
                      BarcodeFormats.Code128 |
                      BarcodeFormats.Ean13 |
                      BarcodeFormats.UpcA,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;  // Required — no Dispose() available
    }

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

// ZXing.Net.MAUI: event loop, format list, lifecycle boilerplate on every scan page
public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode |
                      BarcodeFormats.Code128 |
                      BarcodeFormats.Ean13 |
                      BarcodeFormats.UpcA,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;  // Required — no Dispose() available
    }

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

Imports ZXing.Net.MAUI

Public Partial Class ScannerPage
    Inherits ContentPage

    Public ReadOnly Property ReaderOptions As BarcodeReaderOptions

    Public Sub New()
        InitializeComponent()
        ReaderOptions = New BarcodeReaderOptions With {
            .Formats = BarcodeFormats.QRCode Or
                       BarcodeFormats.Code128 Or
                       BarcodeFormats.Ean13 Or
                       BarcodeFormats.UpcA,
            .TryHarder = True,
            .AutoRotate = True
        }
        BindingContext = Me
    End Sub

    Private Sub OnBarcodesDetected(sender As Object, e As BarcodeDetectionEventArgs)
        MainThread.BeginInvokeOnMainThread(Sub()
                                               For Each barcode In e.Results
                                                   ResultLabel.Text = $"{barcode.Format}: {barcode.Value}"
                                               Next
                                           End Sub)
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnDisappearing()
        MyBase.OnDisappearing()
        CameraView.IsDetecting = False ' Required — no Dispose() available
    End Sub

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

O IronBarcode substitui o loop de eventos por uma única chamada assíncrona ao tocar em um botão, remove completamente a configuração de formato e elimina o gerenciamento do ciclo de vida da página:

// NuGet: dotnet add package IronBarcode
// IronBarcode: stateless, all platforms, auto-detection, no lifecycle boilerplate
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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());
        ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
    }
    // Não OnAppearing / OnDisappearing needed
}

// NuGet: dotnet add package IronBarcode
// IronBarcode: stateless, all platforms, auto-detection, no lifecycle boilerplate
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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());
        ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
    }
    // Não OnAppearing / OnDisappearing needed
}

Imports IronBarCode

Public Partial Class ScannerPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    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())
                ResultLabel.Text = If(results.FirstOrDefault()?.Value, "No barcode found")
            End Using
        End Using
    End Sub
    ' Não OnAppearing / OnDisappearing needed
End Class

Passo 1: Remova ZXing .NET.Maui.Controls e limpe o arquivo MauiProgram.cs.

Remova o pacote NuGet ZXing .NET .MAUI:

dotnet remove package ZXing.Net.Maui.Controls

dotnet remove package ZXing.Net.Maui.Controls

ZXing.Net.MAUI requer uma chamada de registro única em MauiProgram.cs. Remova esta linha se ela estiver presente:

// Remover this line from MauiProgram.cs
builder.UseBarcodeReader();

// Remover this line from MauiProgram.cs
builder.UseBarcodeReader();

A importação using ZXing.Net.Maui; que suporta esta chamada também pode ser removida de MauiProgram.cs.

Passo 2: Instale o IronBarcode

dotnet add package IronBarcode

dotnet add package IronBarcode

O tutorial de scanner de código de barras .NET MAUI cobre a configuração completa do projeto, incluindo entradas de permissão de câmera Info.plist para iOS e declarações de permissão AndroidManifest.xml para Android.

Etapa 3: Atualizar Namespaces e Inicializar Licença

Remova as importações do namespace .NET.MAUI do ZXing de todos os arquivos:

// Remover these from every .cs file that imported them
using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

// Remover these from every .cs file that imported them
using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

Adicione o namespace IronBarcode e inicialize a chave de licença na inicialização do aplicativo. O local apropriado é MauiProgram.cs ou App.xaml.cs, antes de qualquer operação de código de barras ser realizada:

using IronBarCode;

// In MauiProgram.cs CreateMauiApp() or App.xaml.cs constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronBarCode;

// In MauiProgram.cs CreateMauiApp() or App.xaml.cs constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

' In MauiProgram.vb CreateMauiApp() or App.xaml.vb constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Substituindo o controle de câmera XAML e o código subjacente

O controle XAML CameraBarcodeReaderView e seu código de suporte são o principal alvo de migração. A alteração remove a visualização da câmera do layout da página e substitui o padrão de varredura orientado a eventos por uma captura assíncrona acionada por botão.

Abordagem ZXing .NET.MAUI:

XAML:

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

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

Código subjacente:

using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode | BarcodeFormats.Code128 | BarcodeFormats.Ean13,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;
    }

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

using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode | BarcodeFormats.Code128 | BarcodeFormats.Ean13,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;
    }

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

Imports ZXing.Net.Maui
Imports ZXing.Net.Maui.Controls

Public Partial Class ScannerPage
    Inherits ContentPage

    Public ReadOnly Property ReaderOptions As BarcodeReaderOptions

    Public Sub New()
        InitializeComponent()
        ReaderOptions = New BarcodeReaderOptions With {
            .Formats = BarcodeFormats.QRCode Or BarcodeFormats.Code128 Or BarcodeFormats.Ean13,
            .TryHarder = True,
            .AutoRotate = True
        }
        BindingContext = Me
    End Sub

    Private Sub OnBarcodesDetected(sender As Object, e As BarcodeDetectionEventArgs)
        MainThread.BeginInvokeOnMainThread(Sub()
                                               For Each barcode In e.Results
                                                   ResultLabel.Text = $"{barcode.Format}: {barcode.Value}"
                                               Next
                                           End Sub)
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnDisappearing()
        MyBase.OnDisappearing()
        CameraView.IsDetecting = False
    End Sub

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

Abordagem do IronBarcode:

XAML:

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
    <StackLayout>
        <Button Text="Scan Barcode" Clicked="ScanButton_Clicked" />
        <Label x:Name="ResultLabel" Text="Tap to scan..." />
    </StackLayout>
</ContentPage>

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
    <StackLayout>
        <Button Text="Scan Barcode" Clicked="ScanButton_Clicked" />
        <Label x:Name="ResultLabel" Text="Tap to scan..." />
    </StackLayout>
</ContentPage>

Código subjacente:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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());
        var first = results.FirstOrDefault();
        ResultLabel.Text = first != null
            ? $"{first.Format}: {first.Value}"
            : "No barcode found";
    }

    // Não OnAppearing or OnDisappearing required — no camera state exists between scans
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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());
        var first = results.FirstOrDefault();
        ResultLabel.Text = first != null
            ? $"{first.Format}: {first.Value}"
            : "No barcode found";
    }

    // Não OnAppearing or OnDisappearing required — no camera state exists between scans
}

Imports IronBarCode

Public Partial Class ScannerPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    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())
                Dim first = results.FirstOrDefault()
                ResultLabel.Text = If(first IsNot Nothing, $"{first.Format}: {first.Value}", "No barcode found")
            End Using
        End Using
    End Sub

    ' Não OnAppearing or OnDisappearing required — no camera state exists between scans
End Class

O namespace XAML zxing:, a lista de formatos BarcodeReaderOptions, o invólucro MainThread.BeginInvokeOnMainThread() e ambas as substituições de ciclo de vida são eliminados inteiramente. A continuação do método async roda no contexto de chamada — que é a thread principal para um manipulador de eventos de IU — portanto, não é necessário um checkpoint explícito de marshalling de threads.

Removendo a especificação de formato

Qualquer bloco de configuração BarcodeReaderOptions disperso por várias páginas ou cenários de escaneamento na base de código é deletado. O IronBarcode realiza a detecção automática de formatos em todos os mais de 50 formatos suportados, sem necessidade de pré-configuração.

Abordagem ZXing .NET.MAUI:

// ZXing.Net.MAUI: every anticipated format must be listed explicitly
// Formats not listed here will silently fail to detect
var readerOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.DataMatrix |
              BarcodeFormats.Aztec |
              BarcodeFormats.Pdf417 |
              BarcodeFormats.Code128 |
              BarcodeFormats.Code39 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA |
              BarcodeFormats.Codabar,
    TryHarder = true
};

// ZXing.Net.MAUI: every anticipated format must be listed explicitly
// Formats not listed here will silently fail to detect
var readerOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.DataMatrix |
              BarcodeFormats.Aztec |
              BarcodeFormats.Pdf417 |
              BarcodeFormats.Code128 |
              BarcodeFormats.Code39 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA |
              BarcodeFormats.Codabar,
    TryHarder = true
};

' ZXing.Net.MAUI: every anticipated format must be listed explicitly
' Formats not listed here will silently fail to detect
Dim readerOptions As New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.DataMatrix Or
               BarcodeFormats.Aztec Or
               BarcodeFormats.Pdf417 Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Code39 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA Or
               BarcodeFormats.Codabar,
    .TryHarder = True
}

Abordagem do IronBarcode:

// IronBarcode: no format configuration needed
// All formats are detected automatically on every read call
var results = BarcodeReader.Read(imageBytes);

// Optional: restrict to specific formats for performance tuning (not required for correctness)
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};
var tunedResults = BarcodeReader.Read(imageBytes, options);

// IronBarcode: no format configuration needed
// All formats are detected automatically on every read call
var results = BarcodeReader.Read(imageBytes);

// Optional: restrict to specific formats for performance tuning (not required for correctness)
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};
var tunedResults = BarcodeReader.Read(imageBytes, options);

Imports IronBarcode

' IronBarcode: no format configuration needed
' All formats are detected automatically on every read call
Dim results = BarcodeReader.Read(imageBytes)

' Optional: restrict to specific formats for performance tuning (not required for correctness)
Dim options As New BarcodeReaderOptions With {
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}
Dim tunedResults = BarcodeReader.Read(imageBytes, options)

O IronBarcode oferece dicas de formatação para cenários que exigem alto desempenho, mas são opcionais. Um código de barras em um formato não listado em um objeto de opções ainda será detectado e retornado.

Removendo o gerenciamento do ciclo de vida de detecção

Todos os OnAppearing e OnDisappearing substituem que existem para alternar CameraView.IsDetecting são removidos. Se essas substituições de método contiverem outra lógica de ciclo de vida de página, preserve essa lógica e remova apenas as linhas IsDetecting.

Abordagem ZXing .NET.MAUI:

// Required boilerplate on every page — omitting this causes camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;
}

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

// Required boilerplate on every page — omitting this causes camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;
}

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

' Required boilerplate on every page — omitting this causes camera resource leaks
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False
    End If
End Sub

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

Abordagem do IronBarcode:

// Delete both methods if they contain only IsDetecting management.
// If they contain other logic, remove only the IsDetecting lines and keep the rest.
//IronBarcode is stateless — there is no camera view running between button taps.

// Delete both methods if they contain only IsDetecting management.
// If they contain other logic, remove only the IsDetecting lines and keep the rest.
//IronBarcode is stateless — there is no camera view running between button taps.

' Delete both methods if they contain only IsDetecting management.
' If they contain other logic, remove only the IsDetecting lines and keep the rest.
' IronBarcode is stateless — there is no camera view running between button taps.

Windows MAUI: O mesmo código, sem compilação condicional

Com o ZXing .NET.MAUI, adicionar um alvo Windows a um projeto resultava em falha de compilação ou exigia stubs específicos da plataforma, pois a implementação para Windows nunca havia sido escrita. Com o IronBarcode, o mesmo código que roda no iOS e no Android compila e roda no Windows sem modificações.

Abordagem ZXing .NET.MAUI:

// Windows MAUI: either fails to compile or requires a platform-specific stub
// There is no documented path to Windows support
#if ANDROID || IOS
    // ZXing.Net.MAUI scanning — Windows has no implementation
#endif

// Windows MAUI: either fails to compile or requires a platform-specific stub
// There is no documented path to Windows support
#if ANDROID || IOS
    // ZXing.Net.MAUI scanning — Windows has no implementation
#endif

Abordagem do IronBarcode:

// NuGet: dotnet add package IronBarcode
// Não platform conditionals — same code runs on iOS, Android, Windows, and macOS
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());
    ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
}

// NuGet: dotnet add package IronBarcode
// Não platform conditionals — same code runs on iOS, Android, Windows, and macOS
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());
    ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
}

' NuGet: dotnet add package IronBarcode
' Não platform conditionals — same code runs on iOS, Android, Windows, and macOS
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())
            ResultLabel.Text = If(results.FirstOrDefault()?.Value, "No barcode found")
        End Using
    End Using
End Sub

No Windows, MediaPicker.CapturePhotoAsync() mapeia para o seletor de arquivos do Windows, permitindo que o usuário selecione um arquivo de imagem — comportamento apropriado para um ambiente de desktop. O guia de código de barras para desktop do MAUI aborda detalhadamente a configuração do MAUI no Windows e no macOS.

Leitura de código de barras em PDF (Nova funcionalidade)

O ZXing .NET.MAUI não possui uma API para leitura de códigos de barras em documentos PDF. Se este for um novo requisito que a migração possibilita, o seguinte padrão se aplica:

Abordagem ZXing .NET.MAUI:

// ZXing.Net.MAUI: no API for PDF or file-based barcode reading
// Cannot fulfill this requirement — a separate library is required

// ZXing.Net.MAUI: no API for PDF or file-based barcode reading
// Cannot fulfill this requirement — a separate library is required

' ZXing.Net.MAUI: no API for PDF or file-based barcode reading
' Cannot fulfill this requirement — a separate library is required

Abordagem do IronBarcode:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Read from a user-selected file using MAUI FilePicker
private async void ReadFileButton_Clicked(object sender, EventArgs e)
{
    var file = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select image or PDF"
    });
    if (file == null) return;

    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 all barcodes from all pages of a PDF
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in pdfResults)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
private async void ReadFileButton_Clicked(object sender, EventArgs e)
{
    var file = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select image or PDF"
    });
    if (file == null) return;

    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

Imports IronBarCode

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

' Read from a user-selected file using MAUI FilePicker
Private Async Sub ReadFileButton_Clicked(sender As Object, e As EventArgs)
    Dim file = Await FilePicker.PickAsync(New PickOptions With {
        .PickerTitle = "Select image or PDF"
    })
    If file Is Nothing Then Return

    Dim fileResults = BarcodeReader.Read(file.FullPath)
    For Each result In fileResults
        ResultLabel.Text &= $"\n{result.Format}: {result.Value}"
    Next
End Sub

O fluxo de trabalho completo de leitura de códigos de barras em PDF — incluindo documentos com várias páginas, metadados de número de página e documentos com formatos mistos — está documentado no guia de leitura de códigos de barras em PDF .

Problema 1: Não existe equivalente ao visor eletrônico

ZXing.Net.MAUI: O CameraBarcodeReaderView exibe um feed contínuo de câmera no layout da página, mostrando ao usuário uma pré-visualização ao vivo com feedback de escaneamento sobreposto.

Solução: O IronBarcode não oferece um controle de visualização em tempo real. O padrão de substituição usa MediaPicker.CapturePhotoAsync(), que abre a IU da câmera de sistema da plataforma. A câmera do sistema oferece sua própria pré-visualização ao vivo e indicador de foco. Depois que o usuário captura a imagem e confirma, o resultado é passado para BarcodeReader.Read(). Se um observador persistente no aplicativo for um elemento de UX necessário que não pode ser substituído pela IU da câmera do sistema, a camada de integração da câmera deve ser construída separadamente usando Microsoft.Maui.Media ou APIs de câmera da plataforma, com IronBarcode lidando com a etapa de decodificação.

Questão 2: Declarações de permissão para uso da câmera

ZXing .NET.MAUI: As permissões da câmera podem ter sido declaradas no projeto como parte das instruções de configuração do ZXing .NET.MAUI.

Solução: Permissões de câmera permanecem necessárias para a chamada MediaPicker.CapturePhotoAsync() que o padrão MAUI do IronBarcode usa. Verifique se NSCameraUsageDescription está presente em Info.plist para iOS e se <uses-permission android:name="android.permission.CAMERA" /> está presente em AndroidManifest.xml para Android. O próprio IronBarcode não acessa a câmera diretamente — ele processa imagens — mas a chamada MediaPicker que fornece imagens requer permissão da câmera. A configuração de permissões é abordada no tutorial do leitor de código de barras .NET MAUI .

Problema 3: A compilação para Windows agora é bem-sucedida onde antes falhava.

ZXing .NET.MAUI: Projetos que tentavam incluir um alvo Windows com ZXing .NET.MAUI normalmente encontravam erros de compilação ou exigiam que a biblioteca fosse excluída da compilação do Windows por meio de lógica condicional do MSBuild.

Solução: Após remover o ZXing .NET.MAUI e instalar o IronBarcode, a compilação do MAUI para Windows é bem-sucedida sem quaisquer condições de plataforma. Remova qualquer #if ANDROID || As proteções do iOS foram colocadas em torno das chamadas .NET.MAUI do ZXing para excluí-las da compilação do Windows. A chamada BarcodeReader.Read() do IronBarcode compila e roda em todas as estruturas alvo. Se MediaPicker.CapturePhotoAsync() foi excluído das construções do Windows, essa exclusão também pode ser removida — o método é suportado noWindows MAUIe mapeia para o seletor de arquivos. Verifique se a solução completa é compilada sem erros para todas as estruturas de destino após a remoção das condições.

Edição 4: Referências da enumeração BarcodeFormats

ZXing.Net.MAUI: O enum BarcodeFormats de ZXing.Net.Maui é extensivamente utilizado em configurações BarcodeReaderOptions. Após a remoção do pacote, quaisquer referências restantes geram erros de compilação.

Solução: Delete todos os blocos de inicialização BarcodeReaderOptions que foram usados para configurar listas de formatos. O IronBarcode não exige especificação de formato para funcionar corretamente. Se algum código restante faz referência aos valores BarcodeFormats para fins de log, exibição ou comparação, substitua-os por valores BarcodeEncoding do namespace IronBarCode. Execute grep -rn "BarcodeFormats\." --include="*.cs" . para encontrar todas as referências restantes após a remoção do pacote.

Tarefas pré-migração

Antes de fazer alterações, verifique toda a utilização do .NET.MAUI do ZXing no código-fonte:

grep -rn "ZXing.Net.Maui" --include="*.cs" --include="*.xaml" .
grep -rn "CameraBarcodeReaderView" --include="*.cs" --include="*.xaml" .
grep -rn "BarcodeDetectionEventArgs" --include="*.cs" .
grep -rn "BarcodeReaderOptions" --include="*.cs" .
grep -rn "BarcodeFormats\." --include="*.cs" .
grep -rn "IsDetecting" --include="*.cs" .
grep -rn "UseBarcodeReader" --include="*.cs" .
grep -rn "zxing:" --include="*.xaml" .
grep -rn "e\.Results" --include="*.cs" .

grep -rn "ZXing.Net.Maui" --include="*.cs" --include="*.xaml" .
grep -rn "CameraBarcodeReaderView" --include="*.cs" --include="*.xaml" .
grep -rn "BarcodeDetectionEventArgs" --include="*.cs" .
grep -rn "BarcodeReaderOptions" --include="*.cs" .
grep -rn "BarcodeFormats\." --include="*.cs" .
grep -rn "IsDetecting" --include="*.cs" .
grep -rn "UseBarcodeReader" --include="*.cs" .
grep -rn "zxing:" --include="*.xaml" .
grep -rn "e\.Results" --include="*.cs" .

Documente todas as páginas digitalizadas identificadas pela auditoria. Note quais substituições OnAppearing e OnDisappearing contêm apenas gerenciamento IsDetecting (a serem deletadas) versus aquelas que contêm outras lógicas (a serem parcialmente modificadas). Note quaisquer instâncias de BarcodeReaderOptions que possam conter listas de formatos usadas de formas além da configuração de detecção.

Tarefas de atualização de código

1. Remova o pacote NuGet ZXing.Net.Maui.Controls do arquivo de projeto
2. Remova builder.UseBarcodeReader() de MauiProgram.cs
3. Remova as importações de namespaces using ZXing.Net.Maui; e using ZXing.Net.Maui.Controls; de todos os arquivos
4. Instale o pacote NuGet IronBarcode
5. Adicione using IronBarCode; a todos os arquivos que irão utilizar leitura de código de barras
6. Adicione IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; no início do aplicativo
7. Remova a declaração do namespace xmlns:zxing de todos os arquivos XAML
8. Remova todos os elementos <zxing:CameraBarcodeReaderView> dos arquivos XAML
9. Substitua a visualização da câmera removida por um controle <Button> em cada arquivo XAML
10. Adicione Clicked="ScanButton_Clicked" a cada botão de escaneamento
11. Exclua os métodos do manipulador de eventos OnBarcodesDetected de todos os arquivos de código-behind
12. Adicione métodos async void ScanButton_Clicked implementando MediaPicker.CapturePhotoAsync() + BarcodeReader.Read() a cada página
13. Apague todos os blocos de inicialização BarcodeReaderOptions
14. Apague todas as substituições OnDisappearing e OnAppearing que existem apenas para gerenciamento IsDetecting
15. Remova as linhas IsDetecting de qualquer substituição OnDisappearing e OnAppearing que contenham outras lógicas
16. Remova qualquer #if ANDROID || Mecanismos de proteção de compilação condicional do iOS que isolavam a compilação do .NET.MAUI do ZX das compilações do Windows.
17. Substitua qualquer referência restante ao enum BarcodeFormats.X por equivalentes BarcodeEncoding.X

Testes pós-migração

Após a migração ser compilada sem erros, verifique o seguinte:

• Android MAUI: o botão de leitura abre a câmera do sistema, captura uma foto e retorna o código de barras correto — confirme com o guia de leitura do Android.
• iOS MAUI: o mesmo fluxo funciona no iOS, inclusive no hardware do iPhone 15 Pro, onde o problema de foco automático ocorria anteriormente.
• Windows MAUI: a versão para Windows compila sem erros e o botão de digitalização abre o seletor de arquivos e retorna um resultado correto da imagem selecionada.
• Formatos: teste a leitura de códigos de barras em formatos que não foram incluídos na lista antiga BarcodeFormats para confirmar a autodetecção
• Navegação entre páginas: navegue até a página de digitalização e retorne a ela várias vezes e verifique se não ocorrem falhas no crescimento da memória ou na inicialização da câmera.
• Leitura de PDF: se a migração adicionar a leitura de código de barras em PDF como uma nova funcionalidade, verifique se os PDFs com várias páginas retornam resultados com os metadados de número de página corretos.