sDK de escáner de código de barras .NET MAUI: Cree un escáner multiplataforma en minutos

Crear el proyecto .NET MAUI

Abre Visual Studio y crea un nuevo proyecto .NET MAUI App. Nombra tu proyecto MAUI con algo descriptivo como "BarcodeScanner" y selecciona .NET 8 o posterior como marco de destino. Visual Studio generará la estructura de proyecto predeterminada con carpetas específicas de la plataforma para Android e iOS.

Instalar IronBarcode

Instale el paquete NuGet de IronBarcode mediante la consola del gestor de paquetes:

Install-Package BarCode

Este comando descarga e instala el SDK del escáner de código de barras junto con todas las dependencias necesarias para su aplicación .NET MAUI.

Configurar permisos de plataforma

Incluso cuando se escanea desde archivos de imagen en lugar de una cámara en vivo, es una buena práctica para configurar los siguientes permisos para su aplicación .NET MAUI escáner de código de barras.

Para Android, añada lo siguiente a Platforms/Android/AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

Para iOS, añada estas entradas a Platforms/iOS/Info.plist:

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

Iniciar el SDK

Configure IronBarcode en su archivo MauiProgram.cs:

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });
        return builder.Build();
    }
}

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });
        return builder.Build();
    }
}

Establezca su clave de licencia en el código de inicialización de su aplicación para habilitar la funcionalidad completa. IronBarcode ofrece una licencia de prueba gratuita para desarrollo y pruebas.

Diseñar la interfaz de usuario

Crear una interfaz limpia en MainPage.xaml que permita a los usuarios seleccionar un archivo de imagen y ver los datos del código de barras escaneado:

<?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">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</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">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

Implementar el escaneado de códigos de barras

Añada la lógica de exploración a MainPage.xaml.cs. Este código gestiona la selección de imágenes y la detección de códigos de barras:

using IronBarCode;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });
        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);
            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);
            if (barcodes.Any())
            {
                ResultLabel.Text = $"Found: {barcodes.First().Value}";
            }
            else
            {
                ResultLabel.Text = "No barcodes detected in selected image.";
            }
        }
    }
}

using IronBarCode;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });
        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);
            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);
            if (barcodes.Any())
            {
                ResultLabel.Text = $"Found: {barcodes.First().Value}";
            }
            else
            {
                ResultLabel.Text = "No barcodes detected in selected image.";
            }
        }
    }
}

Resultado

.NET MAUI Barcode Scanner SDK: Cree un escáner multiplataforma en cuestión de minutos: Imagen 1 - Código de barras escaneado

El método BarcodeReader.Read() analiza la imagen seleccionada y devuelve todos los códigos de barras detectados. IronBarcode reconoce automáticamente múltiples simbologías de códigos de barras, incluidos códigos QR, Código 128, Código 39, EAN-13 y muchos otros formatos.

Resultado

.NET MAUI Barcode Scanner SDK: Cree un escáner multiplataforma en cuestión de minutos: Imagen 2 - Salida para escanear un PDF con códigos QR en su interior

El método ReadPdf() escanea todas las páginas de un PDF y devuelve los datos del código de barras junto con los números de página, lo que facilita el procesamiento de documentos que contienen varios códigos de barras.