Como criar um leitor de código de barras .NET MAUI em C#?

Como você cria um projeto .NET MAUI para escaneamento de código de barras?

Configurar um projeto .NET MAUI no Visual Studio é simples. Inicie o Visual Studio 2022 ou superior, selecione Criar um novo projeto, escolha o template .NET MAUI App, insira o nome do seu projeto e selecione suas plataformas de destino. Este tutorial foca na implantação no Windows, embora o mesmo projeto funcione no Android e iOS. .NET MAUI é o framework multiplataforma da Microsoft para construir aplicativos móveis e de desktop nativos com C# e XAML de uma base de código compartilhada.

Ao contrário de soluções baseadas em câmera, como ZXing.Net.MAUI, que exigem configuração de controle CameraView e registro MauiProgram.cs, o IronBarcode não necessita de configuração especial. Seu MauiProgram.cs permanece no estado de modelo padrão. Isso mantém seu código de inicialização livre de registros de handlers de terceiros e reduz a área de erro para inicializações erradas no momento do lançamento.

Para instalar o IronBarcode, execute este comando no Package Manager Console:

Install-Package BarCode

Install-Package BarCode

Este único pacote oferece escaneamento de código de barras, reconhecimento de código QR, detecção de múltiplos códigos de barras e geração de código de barras. Não são necessárias dependências adicionais.

Para ativar o IronBarcode em produção, defina sua chave de licença dentro de App.xaml.cs ou MauiProgram.cs:

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

Você pode obter uma chave na página de licenciamento do IronBarcode ou começar com uma licença de teste gratuita.

Qual Interface XAML Funciona Melhor para um Scanner de Código de Barras MAUI?

Uma interface mínima -- um botão de seleção de imagem, uma área de exibição de imagem e um rótulo de resultados -- cobre a maioria dos cenários de escaneamento de código de barras. O seguinte XAML cria esse layout para um .NET MAUI ContentPage:

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <ScrollView>
        <VerticalStackLayout Spacing="20" Padding="30">
            <Label Text="MAUI Barcode Scanner"
                   FontSize="24"
                   HorizontalOptions="Center" />
            <Button x:Name="SelectImageBtn"
                    Text="Select Image File"
                    Clicked="OnSelectImage" />
            <Image x:Name="SelectedImageDisplay"
                   HeightRequest="250" />
            <Label x:Name="ResultsLabel"
                   Text="Barcode results will appear here" />
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <ScrollView>
        <VerticalStackLayout Spacing="20" Padding="30">
            <Label Text="MAUI Barcode Scanner"
                   FontSize="24"
                   HorizontalOptions="Center" />
            <Button x:Name="SelectImageBtn"
                    Text="Select Image File"
                    Clicked="OnSelectImage" />
            <Image x:Name="SelectedImageDisplay"
                   HeightRequest="250" />
            <Label x:Name="ResultsLabel"
                   Text="Barcode results will appear here" />
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

O layout fornece um botão para acionar o seletor de arquivo, uma área de exibição para a imagem escolhida e um rótulo para os valores decodificados do código de barras. Ele é renderizado corretamente em todas as plataformas de destino do .NET MAUI sem ajustes específicos de plataforma.

Para aplicativos de produção, considere substituir ResultsLabel por um CollectionView para exibir vários resultados de códigos de barras em uma lista rolável, especialmente ao escanear documentos que contenham mais de um código de barras.

Como você escaneia códigos de barras de arquivos de imagem no .NET MAUI?

O código-behind em MainPage.xaml.cs lida com a seleção de imagens e leitura de códigos de barras. BarcodeReader.Read aceita um caminho de arquivo e retorna uma coleção BarcodeResults. Cada item na coleção expõe o Value do código de barras, BarcodeType, e coordenadas de posição.

Aqui está a implementação completa:

using IronBarCode;
namespace BarcodeScanner;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open the system file picker filtered to image types
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });

            if (result != null)
            {
                // Display the selected image in the UI
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);

                // Decode all barcodes found in the image
                var barcodes = BarcodeReader.Read(result.FullPath);

                if (barcodes.Count > 0)
                {
                    // Build a display string listing each barcode type and value
                    string output = string.Join("\n",
                        barcodes.Select(b => $"{b.BarcodeType}: {b.Value}"));
                    ResultsLabel.Text = output;
                }
                else
                {
                    ResultsLabel.Text = "No barcodes detected in image";
                }
            }
        }
        catch (Exception ex)
        {
            ResultsLabel.Text = $"Error: {ex.Message}";
        }
    }
}

using IronBarCode;
namespace BarcodeScanner;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open the system file picker filtered to image types
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });

            if (result != null)
            {
                // Display the selected image in the UI
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);

                // Decode all barcodes found in the image
                var barcodes = BarcodeReader.Read(result.FullPath);

                if (barcodes.Count > 0)
                {
                    // Build a display string listing each barcode type and value
                    string output = string.Join("\n",
                        barcodes.Select(b => $"{b.BarcodeType}: {b.Value}"));
                    ResultsLabel.Text = output;
                }
                else
                {
                    ResultsLabel.Text = "No barcodes detected in image";
                }
            }
        }
        catch (Exception ex)
        {
            ResultsLabel.Text = $"Error: {ex.Message}";
        }
    }
}

BarcodeReader.Read processa o arquivo no caminho fornecido, detecta automaticamente todas as simbologias de códigos de barras presentes e retorna os resultados imediatamente. O método suporta todos os principais formatos de códigos de barras 1D e 2D, incluindo Code 128, Code 39, Código QR, Data Matrix, PDF417 e EAN-13.

A chamada FilePicker.PickAsync limita o seletor a tipos de imagens, para que os usuários não possam selecionar acidentalmente arquivos que não são de imagem. Se result for null, o usuário cancelou -- a proteção if (result != null) lida com isso silenciosamente.

private async void ShowScanSummary(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        // Inform the user how many barcodes were detected
        string message = $"Found {barcodes.Count} barcode(s) in the image.";
        await DisplayAlert("Scan Complete", message, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

private async void ShowScanSummary(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        // Inform the user how many barcodes were detected
        string message = $"Found {barcodes.Count} barcode(s) in the image.";
        await DisplayAlert("Scan Complete", message, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

Como você escaneia múltiplos códigos de barras e ajusta a velocidade de detecção?

Quando uma imagem contém vários códigos de barras, o IronBarcode os detecta todos por padrão. Para melhor desempenho quando você sabe quais formatos esperar, configure BarcodeReaderOptions antes de chamar BarcodeReader.Read:

using IronBarCode;

// Target only QR codes and Code 128 for faster detection
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes     = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed                  = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType} | Value: {barcode.Value}");
}

using IronBarCode;

// Target only QR codes and Code 128 for faster detection
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes     = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed                  = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType} | Value: {barcode.Value}");
}

A propriedade ExpectBarcodeTypes restringe o mecanismo de detecção às simbologias especificadas. Definir Speed para ReadingSpeed.Faster é adequado para imagens de alto contraste e sem distorção. ReadingSpeed.Detailed aplica passagens adicionais de correção de imagem e lida com rotação, distorção e entradas de baixa resolução ao custo de tempo extra de processamento.

ExpectMultipleBarcodes = true instrui o leitor a continuar escaneando após a primeira correspondência em vez de retornar cedo. Em cenários de código de barras único, omitir esta opção reduz alguns milissegundos de cada escaneamento.

Esta configuração torna o scanner prático para uma variedade de aplicações: um aplicativo de varejo lendo códigos de barras de produtos, uma ferramenta de armazém processando etiquetas de código de barras impressas em fotos de remessas, ou um fluxo de trabalho de documentos extraindo códigos QR de faturas carregadas.

Como você lida com imagens desafiadoras ou de baixa qualidade?

Imagens de produção raramente são perfeitas. Fotos de armazém tiradas sob iluminação intensa, capturas de tela de clientes de email e documentos escaneados introduzem ruído, artefatos de compressão e distorção geométrica. O IronBarcode expõe ImageFilterCollection para pré-processar imagens antes da decodificação:

using IronBarCode;
using IronSoftware.Drawing;

// Apply corrections for a low-quality warehouse photo
var options = new BarcodeReaderOptions
{
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f),
        new DenoiseFilter()
    },
    Speed = ReadingSpeed.Detailed
};

var barcodes = BarcodeReader.Read(imagePath, options);

using IronBarCode;
using IronSoftware.Drawing;

// Apply corrections for a low-quality warehouse photo
var options = new BarcodeReaderOptions
{
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f),
        new DenoiseFilter()
    },
    Speed = ReadingSpeed.Detailed
};

var barcodes = BarcodeReader.Read(imagePath, options);

SharpenFilter recupera a definição das bordas de capturas comprimidas ou fora de foco. ContrastFilter ajuda quando a iluminação é desigual. DenoiseFilter reduz manchas de digitalizações de baixa resolução. A combinação desses filtros com ReadingSpeed.Detailed maximiza as taxas de leitura em materiais difíceis.

Para aplicativos .NET MAUI que aceitam imagens carregadas por usuários de uma variedade de fontes, aplicar um conjunto de filtros conservador por padrão e escalar para uma correção mais agressiva em uma segunda tentativa melhora a experiência do usuário sem adicionar latência visível no caso comum. Você também pode passar um Uri ou byte[] diretamente para BarcodeReader.Read, que é útil quando a imagem chega de uma resposta de rede em vez do sistema de arquivos. Consulte os guias de como fazer do IronBarcode para exemplos adicionais de fontes de entrada.

Por que o escaneamento baseado em imagens é adequado para aplicativos .NET MAUI?

A digitalização de câmera ao vivo através de um controle CameraView requer concessões de permissão específicas de plataforma, gestão de ciclo de vida para a pré-visualização da câmera, e tratamento de eventos de foco. No iOS isso também significa configurar AVCaptureSession; no Android, CameraX. Cada plataforma adiciona seus próprios modos de falha.

O escaneamento baseado em imagem remove toda essa categoria de preocupações. A referência da API do IronBarcode mostra que BarcodeReader.Read aceita um caminho de arquivo, um Stream, um Bitmap, ou um byte[] -- qualquer representação que seu aplicativo MAUI possa produzir. Isso significa que a mesma lógica de escaneamento funciona, quer a imagem tenha vindo de FilePicker, um download de rede, uma página PDF renderizada para bitmap, ou um anexo de email.

O consumo de bateria é menor porque o hardware da câmera permanece desligado. Não há tremor da interface do usuário de uma pré-visualização ao vivo, e não há necessidade de gerenciar eventos do ciclo de vida da câmera em suspensão e retomada do aplicativo. Em formatos de tablet e desktop -- onde um visor de câmera ao vivo raramente é apropriado -- a decodificação baseada em imagem é o padrão natural em vez de um compromisso. Os usuários podem abrir arquivos de armazenamento em nuvem, pastas locais, ou rolos de câmera com a mesma chamada FilePicker, independentemente do tipo de dispositivo.

Para fluxos de trabalho onde os usuários fotografam rótulos de códigos de barras e os carregam -- comum em aplicativos web de scanner de código de barras ASP.NET -- a mesma chamada BarcodeReader.Read funciona tanto no cliente móvel quanto no servidor, eliminando a necessidade de manter duas implementações de escaneamento.

Quais são os seus próximos passos?

Criar um scanner de código de barras .NET MAUI com IronBarcode leva menos de 30 linhas de código C#. A abordagem de arquivo de imagem mantém seu código MAUI livre de lógica de permissão de câmera e inicialização específica de plataforma, e a mesma chamada de escaneamento é executada de forma idêntica no Windows, Android e iOS.

A documentação da API do IronBarcode cobre capacidades adicionais: leitura de códigos de barras em documentos PDF, processamento em lote de várias imagens, escrita de filtros de imagem personalizados, e geração de códigos de barras junto com sua leitura. A visão geral de recursos lista todas as simbologias e formatos suportados.

Comece um teste gratuito para testar o IronBarcode em seu projeto, ou compre uma licença quando estiver pronto para a implantação em produção.

!{--010011000100100101000010010100100100000101010010010110010101111101000111010001010101010100010111110101001101010100010000010101001001010100010001010100010001011111010101110100100 101010100010010000101111101010000010100100111101000100010101010100001101010100010111110101010001010010010010010010010100000101001100010111110100001001001100010011110100001101001011--}