.NET MAUI Escanear código de barras en Windows Apps con una potente biblioteca de escáner de código de barras

¿Cómo crear una aplicación .NET MAUI para escanear códigos de barras?

Configurar un proyecto .NET MAUI en Visual Studio Code o Visual Studio es sencillo, para este tutorial, utilizaremos Visual Studio. Inicie Visual Studio 2022 o posterior, seleccione Crear un nuevo proyecto y elija la plantilla .NET MAUI App. Introduzca el nombre de su proyecto y seleccione las plataformas de destino; para este tutorial, nos centraremos en la implementación de Windows.

A diferencia de soluciones como Scanbot SDK que requieren una compleja inicialización en MauiProgram.cs con configuraciones var builder y configuración de vista previa de la cámara, IronBarcode no requiere ningún registro especial. La clase pública estática MauiProgram permanece sin cambios desde la plantilla por defecto, haciendo la integración notablemente simple para aplicaciones .NET MAUI.

Para instalar el paquete NuGet de IronBarcode, puede utilizar la paleta de comandos (Ctrl+Shift+P en VS Code) o ejecutar el siguiente comando en la consola del gestor de paquetes de Visual Studio:

Install-Package BarCode

Esta única instalación del paquete NuGet proporciona todo lo necesario para el escaneado de códigos de barras, el escaneado de códigos de barras múltiples y el reconocimiento de códigos QR. La última versión es compatible con los principales formatos de códigos de barras sin dependencias adicionales, a diferencia de los escáneres basados en cámaras que a menudo requieren manejadores de permisos y configuraciones de control CameraView.

Para utilizar IronBarcode en un entorno de producción, deberá aplicar una clave de licencia. Puede establecer esto en su MauiProgram.cs o dentro del constructor App.xaml.cs:

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

IronBarCode.License.LicenseKey = "YOUR_IRONBARCODE_LICENSE_KEY";

¿Qué diseño de interfaz funciona mejor para un escáner de código de barras MAUI?

Una interfaz limpia y funcional permite a los usuarios seleccionar un archivo de imagen que contenga códigos de barras y ver los resultados del escaneado. El siguiente XAML crea una sencilla pero eficaz interfaz de usuario de escáner de código de barras para su aplicación .NET MAUI:

<?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 display 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 display here" />
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

Este diseño proporciona un botón para la selección del archivo de imagen, un área para mostrar la imagen seleccionada y una etiqueta para los resultados de la detección del código de barras. El diseño funciona en todas las plataformas de destino .NET MAUI, manteniendo el rendimiento nativo en Windows.

¿Cómo implementar la detección de códigos de barras a partir de archivos de imagen?

En su MainPage.xaml.cs, puede utilizar métodos de ciclo de vida como async void OnAppearing para inicializar la configuración o comprobar si el usuario ha proporcionado el acceso a archivos necesario.

La clase parcial pública MainPage contiene la lógica de exploración. El método BarcodeReader.Read de IronBarcode maneja toda la complejidad de la detección de códigos de barras, soportando el escaneo de códigos de barras desde formatos JPEG, PNG, GIF, TIFF y BMP. Aquí está la implementación completa:

using IronBarCode;
namespace BarcodeScanner;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open file picker for image selection
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });
            if (result != null)
            {
                // Display the selected image
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);
                // Read barcodes from the image file
                var barcodes = BarcodeReader.Read(result.FullPath);
                // Display all detected barcode values
                if (barcodes.Count > 0)
                {
                    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 occurred: {ex.Message}";
        }
    }
}

using IronBarCode;
namespace BarcodeScanner;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImage(object sender, EventArgs e)
    {
        try
        {
            // Open file picker for image selection
            var result = await FilePicker.PickAsync(new PickOptions
            {
                FileTypes = FilePickerFileType.Images,
                PickerTitle = "Select a barcode image"
            });
            if (result != null)
            {
                // Display the selected image
                var stream = await result.OpenReadAsync();
                SelectedImageDisplay.Source = ImageSource.FromStream(() => stream);
                // Read barcodes from the image file
                var barcodes = BarcodeReader.Read(result.FullPath);
                // Display all detected barcode values
                if (barcodes.Count > 0)
                {
                    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 occurred: {ex.Message}";
        }
    }
}

private async void ProcessResults(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        string msg = $"Found {barcodes.Count} barcodes.";
        // Use await DisplayAlert to show results to the user
        await DisplayAlert("Scan Success", msg, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

private async void ProcessResults(BarcodeResults barcodes)
{
    if (barcodes.Count > 0)
    {
        string msg = $"Found {barcodes.Count} barcodes.";
        // Use await DisplayAlert to show results to the user
        await DisplayAlert("Scan Success", msg, "OK");
    }
    else
    {
        await DisplayAlert("No Results", "No barcodes were found in the image.", "OK");
    }
}

¿Cómo se pueden escanear varios BarCodes y configurar las opciones de detección?

Cuando su archivo de imagen contiene varios códigos de barras, IronBarcode los detecta todos automáticamente. Para un rendimiento optimizado cuando conozca los tipos de códigos de barras esperados, utilice BarcodeReaderOptions:

using IronBarCode;
// Configure options for scanning multiple barcodes
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};
var barcodes = BarcodeReader.Read(imagePath, options);
// Process each detected barcode
foreach (var barcode in barcodes)
{
    Console.WriteLine($"Found: {barcode.Value}");
}

using IronBarCode;
// Configure options for scanning multiple barcodes
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};
var barcodes = BarcodeReader.Read(imagePath, options);
// Process each detected barcode
foreach (var barcode in barcodes)
{
    Console.WriteLine($"Found: {barcode.Value}");
}

¿Por qué elegir el escaneado de códigos de barras basado en imágenes?

El escaneado de códigos de barras basado en imágenes ofrece claras ventajas para el desarrollo de códigos de barras de escaneado MAUI en .NET. Mientras que Scanbot SDK y otras herramientas similares se centran en la funcionalidad de vista previa de la cámara en directo, el enfoque de IronBarcode ofrece una integración más directa, un comportamiento coherente en todas las plataformas y la capacidad de procesar archivos de imagen existentes de cualquier origen, incluidos documentos escaneados, archivos adjuntos de correo electrónico o cargas de usuarios.

Para implementaciones en Android e iOS, el mismo código funciona sin modificaciones, sin necesidad de permisos de cámara o configuraciones específicas de la plataforma.

Conclusión

La creación de un escáner de códigos de barras .NET MAUI con IronBarcode requiere un código mínimo, al tiempo que ofrece sólidas capacidades de detección de códigos de barras. El enfoque basado en archivos de imagen simplifica el desarrollo al eliminar los permisos de la cámara, las configuraciones específicas del dispositivo y la compleja inicialización. Usted se centra en la lógica de su aplicación mientras IronBarcode se encarga de la digitalización.

La documentación completa de la API cubre funciones adicionales, como la lectura de códigos de barras en PDF, el procesamiento por lotes y los filtros de imagen avanzados. ¿Listo para implementar la lectura de códigos de barras en su proyecto .NET MAUI multiplataforma? Compra una licencia para uso de producción, o explora el conjunto completo de características con una prueba gratuita.

Empiece con IronBarcode ahora.

Comience gratis