Comparação entre as bibliotecas de código de barras BarcodeScanning.MAUI e IronBarcode em C#

Padrão de varredura da câmera ao vivo

O padrão completo da API BarcodeScanning.Native.Maui consiste em um controle XAML combinado com um manipulador de eventos 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

Este controle oferece aos usuários um visor em tempo real incorporado à página MAUI. A detecção de código de barras é acionada continuamente enquanto a câmera estiver ativa. A experiência do usuário é realmente boa para aplicativos voltados ao consumidor, onde "apontar e escanear" é a principal interação. A limitação é que essa é a única interação que a biblioteca suporta — no momento em que os requisitos se estendem além da detecção de câmera ao vivo no iOS ou Android, o BarcodeScanning.Native.Maui não tem nada a oferecer.

Comparação Detalhada de Recursos

Abordagem de leitura de código de barras MAUI

BarcodeScanning.Native.Maui encapsula o pipeline nativo de detecção de câmera em cada plataforma. Não Android, o ML Kit processa frames. Não iOS, o framework Vision da Apple processa os frames. A biblioteca apresenta isso como um controle MAUI CameraView com um evento OnDetectionFinished. O código do aplicativo nunca manipula bytes de imagem diretamente — ele manipula apenas os valores de código de barras detectados que emergem do evento.

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

A consequência desse projeto é que não há outro ponto de entrada. A câmera não é opcional — é a única entrada que a biblioteca reconhece. Um servidor, um arquivo, um PDF, uma máquina Windows — nenhum deles possui uma câmera no sentido que esta biblioteca espera.

Abordagem do IronBarcode

IronBarcode recebe dados de imagem através de seu método estático BarcodeReader.Read(). O solicitante fornece os dados — de qualquer fonte — e a biblioteca os decodifica. Não MAUI, os dados vêm de MediaPicker; Em um servidor, ele vem do envio de um formulário; Em um aplicativo de desktop, ele vem de uma caixa de diálogo de arquivo.

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

Este código funciona de forma idêntica no iOS, Android e Windows MAUI. Para uso no lado do servidor, o mesmo método BarcodeReader.Read() aceita um array de bytes de um arquivo carregado ou um caminho de PDF. A documentação do IronBarcode abrange todos os tipos de entrada suportados.

Abordagem de leitura de código de barras MAUI

O BarcodeScanning.Native.Maui não oferece suporte ao destino Windows no MAUI. Essa lacuna não é temporária — é uma consequência estrutural da arquitetura da biblioteca. A biblioteca encapsula APIs nativas específicas do iOS (framework Vision) e do Android (ML Kit). O Windows não possui nenhuma delas. Equipes que desenvolvem um aplicativo MAUI para iOS, Android e Windows — um cenário padrão de múltiplos alvos — não podem usar o BarcodeScanning.Native.Maui como solução de código de barras para todos os três alvos. Eles devem implementar código específico para a plataforma Windows separadamente ou substituir a biblioteca por completo.

Abordagem do IronBarcode

A chamada BarcodeReader.Read() doIronBarcodefunciona em plataformas Windows, iOS, Android e macOS MAUI sem a necessidade de código específico para cada plataforma. Não há blocos #if WINDOWS, nem carregamento condicional de dependências, e não são necessárias implementações de stub. Para entradas de arquivos e PDFs, o padrão também é consistente:

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

O guia de integraçãoIronBarcodeMAUI fornece instruções completas de configuração para todos os dispositivos MAUI. OIronBarcodetambém oferece suporte à implantação no lado do servidor em ambientes ASP.NET, Docker, Azure Functions e AWS Lambda, onde o caminho BarcodeScanning.Native.Maui não está presente.

Abordagem de leitura de código de barras MAUI

No iOS, a detecção subjacente do BarcodeScanning.Native.Maui (Apple Vision) retorna 13 dígitos para códigos de barras UPC-A. O código UPC-A tem um formato de 12 dígitos; O zero à esquerda adicional corresponde à codificação EAN-13. A biblioteca repassa esse valor bruto sem correção. Aplicações que armazenam valores UPC-A em um banco de dados podem acumular registros com um zero à esquerda que não deveria estar ali.

A solução alternativa documentada exige verificar o formato e remover os espaços em branco do valor:

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

Essa solução alternativa quebra silenciosamente os códigos de barras EAN-13 que começam com 0 se a verificação de formato for omitida. O PDF417 está documentado separadamente nos problemas do GitHub como "muito problemático — a maioria das digitalizações nunca ocorre", afetando etiquetas de envio, carteiras de motorista e cartões de embarque.

Abordagem do IronBarcode

OIronBarcoderetorna o valor UPC-A correto de 12 dígitos sem necessidade de normalização manual. O PDF417 é um formato suportado que permite a leitura de forma confiável. A parte de geração também está disponível através da API do IronBarcode:

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

Para aplicações em que a precisão dos dados de código de barras afeta diretamente as consultas de estoque, as transações em pontos de venda ou as integrações da cadeia de suprimentos, o tratamento correto de formatos doIronBarcodeelimina uma categoria de bug de produção que o BarcodeScanning.Native.Maui deixa no código da aplicação. A documentação de leitura de código de barras IronBarcode aborda detalhadamente o comportamento específico de cada formato.

Adicionado o alvo MAUI do Windows à compilação.

Geralmente, as aplicações MAUI começam com versões para iOS e Android como alvo e, posteriormente, adicionam o Windows à medida que a aplicação amadurece ou conforme os requisitos de distribuição Enterprise se expandem. Ao adicionar o alvo Windows, o BarcodeScanning.Native.Maui se torna um bloqueador imediato — não há implementação para Windows nem solução alternativa na biblioteca. Nessa situação, as equipes precisam manter uma implementação de código de barras separada para Windows usando uma biblioteca diferente ou migrar toda a camada de código de barras para uma biblioteca que funcione de forma consistente em todos os destinos MAUI. O segundo caminho é operacionalmente mais simples e elimina a sobrecarga de manutenção associada ao ramificação específica da plataforma.

Requisitos para upload de arquivos ou processamento de PDF adicionados.

Os aplicativos móveis geralmente começam com a digitalização da câmera ao vivo como único método de entrada e, posteriormente, expandem-se para aceitar imagens ou documentos carregados. Quando um usuário precisa escanear um código de barras de uma foto em sua galeria, de uma imagem recebida por e-mail ou de um PDF contendo manifestos de remessa ou cartões de embarque, o BarcodeScanning.Native.Maui não oferece nenhum caminho de código. As equipes que atingem esse limite de requisitos enfrentam uma escolha: adicionar uma segunda biblioteca de código de barras ao lado da BarcodeScanning.Native.Maui para entradas de arquivos e PDFs, ou migrar para uma única biblioteca que lide com todos os tipos de entrada. Gerenciar dois pacotes de código de barras com APIs diferentes, tipos de resultados diferentes e tabelas de suporte a formatos diferentes adiciona complexidade a longo prazo, algo que uma solução com um único pacote evita.

Processamento de código de barras no servidor introduzido

Aplicativos que leem códigos de barras em dispositivos móveis geralmente desenvolvem um componente do lado do servidor — um endpoint de API ASP.NET que valida códigos de barras, uma tarefa em segundo plano que processa PDFs ou uma função na nuvem que extrai números de rastreamento de documentos carregados. BarcodeScanning.Native.Maui é uma biblioteca de controle de interface do usuário que depende do contexto de hardware da câmera; Não pode ser executado em um processo de servidor. Uma equipe que precisa da mesma lógica de leitura de código de barras tanto em dispositivos móveis quanto em servidores deve usar uma biblioteca diferente para o lado do servidor. Quando surge a necessidade de implementar a lógica no servidor, as equipes frequentemente avaliam se consolidar tudo em uma única biblioteca que abranja ambas as versões é preferível a manter duas implementações separadas.

A precisão dos dados UPC-A torna-se um problema de produção.

O comportamento do código UPC-A de 13 dígitos do iOS nem sempre é detectado durante o desenvolvimento. Os códigos de barras UPC-A lidos em desenvolvimento podem parecer funcionar corretamente, mas o zero à esquerda introduzido pela estrutura Vision da Apple aparece no banco de dados. Equipes que descobrem valores UPC-A de 13 dígitos em registros de estoque, sistemas de ponto de venda ou integrações da cadeia de suprimentos enfrentam um problema de correção de dados, além de um problema de código. A solução alternativa documentada nos problemas relatados no GitHub do BarcodeScanning.Native.Maui corrige novas leituras, mas não corrige dados históricos. Quando o escopo do problema de qualidade dos dados fica claro, migrar para uma biblioteca que retorne valores UPC-A corretos sem normalização em nível de aplicativo costuma ser a solução mais adequada a longo prazo.

Obrigatório o uso do PDF417 (digitalização de documentos)

O PDF417 é o formato de código de barras usado em etiquetas de envio, carteiras de motorista e cartões de embarque na América do Norte. Esses são alvos de escaneamento comuns para aplicações de logística, verificação de identidade e viagens. O rastreador de problemas do GitHub do BarcodeScanning.Native.Maui documenta o PDF417 como "muito problemático — a maioria das leituras nunca ocorre". Para qualquer aplicação em que a confiabilidade do PDF417 seja um requisito funcional, e não apenas um diferencial, esse problema conhecido representa um obstáculo direto que força a avaliação de bibliotecas alternativas.

Evento da câmera para MediaPicker e leitura estática

A principal mudança estrutural na migração é a substituição do padrão de evento contínuo da câmera por uma captura MediaPicker seguida por BarcodeReader.Read(). O manipulador de eventos OnDetectionFinished, o controle XAML CameraView e a declaração de namespace XML scanner: foram todos removidos. Em seu lugar, um botão aciona MediaPicker.CapturePhotoAsync(), e os bytes da foto resultante são passados para BarcodeReader.Read(). Isso altera a experiência do usuário, passando de um visor contínuo ao vivo para uma tela de câmera do sistema — adequada para a maioria das aplicações empresariais.

Alterações na organização de threads

BarcodeScanning.Native.Maui dispara OnDetectionFinished em uma thread em segundo plano, então todos os manipuladores existentes que atualizam elementos da interface do usuário envolvem suas atualizações em MainThread.BeginInvokeOnMainThread(). Com o padrão MediaPicker + async usado pelo IronBarcode, a continuação após await retorna no contexto de chamada, que normalmente é a thread principal. Na maioria dos casos, os wrappers MainThread.BeginInvokeOnMainThread() podem ser removidos, simplificando o código do manipulador de eventos.

Remoção de solução alternativa para o código UPC-A

Qualquer base de código que tenha lidado com o comportamento de 13 dígitos do UPC-A do iOS do BarcodeScanning.Native.Maui terá código que verifica BarcodeFormat.UPC_A e chama Substring(1) para remover o zero à esquerda. Este código deve ser excluído após a migração — oIronBarcoderetorna o valor correto de 12 dígitos, e manter a solução alternativa removeria incorretamente o primeiro dígito das leituras válidas de UPC-A.

Permissões MAUI

O BarcodeScanning.Native.Maui adiciona permissões de câmera aos manifestos do Android e do iOS automaticamente como parte da configuração do pacote. Com oIronBarcodeusando MediaPicker, as permissões de câmera padrão do MAUI em AndroidManifest.xml e Info.plist são necessárias — as mesmas permissões que qualquer aplicativo MAUI precisa para MediaPicker.CapturePhotoAsync(). Essas permissões geralmente já estão presentes em projetos MAUI que utilizam a câmera para qualquer finalidade.