BarcodeScanning.MAUI vs IronBarcode: Comparación de bibliotecas de códigos de barras C#

Patrón de escaneo de la cámara en vivo

El patrón completo de la API BarcodeScanning.Native.Maui consiste en un control XAML combinado con un controlador 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 control proporciona a los usuarios un visor en tiempo real integrado en la página de MAUI. La detección de códigos de barras se activa continuamente mientras la cámara está en funcionamiento. La experiencia de usuario es realmente buena para aplicaciones de consumo donde la interacción principal consiste en "apuntar y escanear". La limitación es que esta es la única interacción que admite la biblioteca; en el momento en que los requisitos van más allá de la detección de cámara en tiempo real en iOS o Android, BarcodeScanning.Native.Maui no tiene nada que ofrecer.

Comparación detallada de características

Escaneo de códigos de barras. Enfoque MAUI

BarcodeScanning.Native.Maui encapsula el sistema nativo de detección de cámaras en cada plataforma. En Android, ML Kit procesa los fotogramas. En iOS, el marco de trabajo Vision de Apple procesa los fotogramas. La biblioteca muestra esto como un control MAUI CameraView con un evento OnDetectionFinished. El código de la aplicación nunca procesa directamente los bytes de la imagen; solo procesa los valores del código de barras detectados que surgen del 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

La consecuencia de este diseño es que no existe otro punto de entrada. La cámara no es opcional; es la única entrada que reconoce la biblioteca. Un servidor, un archivo, un PDF, una máquina Windows: ninguno de ellos tiene una cámara en el sentido que esta biblioteca espera.

Enfoque IronBarcode

IronBarcode recibe datos de imagen a través de su método estático BarcodeReader.Read(). Quien realiza la llamada proporciona los datos —desde cualquier fuente— y la biblioteca los decodifica. En MAUI, los datos proceden de MediaPicker; En un servidor, proviene de la carga de un formulario; En una aplicación de escritorio, proviene de un cuadro de diálogo de archivos.

// IronBarcode in 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;
}

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

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 se ejecuta de forma idéntica en iOS, Android y Windows MAUI. Para el uso del lado del servidor, el mismo método BarcodeReader.Read() acepta una matriz de bytes de un archivo cargado o una ruta PDF. La documentación de IronBarcode abarca todos los tipos de entrada compatibles.

Escaneo de códigos de barras. Enfoque MAUI

BarcodeScanning.Native.Maui no es compatible con el destino Windows en MAUI. No se trata de una deficiencia temporal, sino de una consecuencia estructural de la arquitectura de la biblioteca. La biblioteca encapsula las API nativas específicas de iOS (marco Vision) y de Android (ML Kit). Windows no dispone de ninguna de ellas. Los equipos que desarrollan una aplicación MAUI para iOS, Android y Windows (un escenario estándar de múltiples plataformas) no pueden usar BarcodeScanning.Native.Maui como solución de código de barras para las tres plataformas. Deben implementar por separado el código específico para la plataforma Windows o reemplazar la biblioteca por completo.

Enfoque IronBarcode

La llamada BarcodeReader.Read() de IronBarcode funciona en objetivos MAUI de Windows, iOS, Android y macOS sin ningún código específico de la plataforma. No hay bloques #if WINDOWS, ni carga condicional de dependencias, ni se necesitan implementaciones stub. Para archivos y PDF de entrada, el patrón también es 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")

La guía de integración de IronBarcode para MAUI proporciona instrucciones de configuración completas para todos los dispositivos compatibles con MAUI. IronBarcode también admite la implementación del lado del servidor en entornos ASP.NET, Docker, Azure Functions y AWS Lambda, donde BarcodeScanning.Native.Maui no tiene ninguna ruta.

Escaneo de códigos de barras. Enfoque MAUI

En iOS, la detección subyacente de BarcodeScanning.Native.Maui (Apple Vision) devuelve 13 dígitos para los códigos de barras UPC-A. El código UPC-A tiene un formato de 12 dígitos; El cero inicial adicional coincide con la codificación EAN-13. La biblioteca transmite este valor sin corregir. Las aplicaciones que almacenan códigos UPC-A en una base de datos pueden acumular registros con un cero inicial que no debería estar allí.

La solución alternativa documentada requiere comprobar el formato y recortar el 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

Esta solución alternativa invalida silenciosamente los códigos de barras EAN-13 que comienzan con 0 si se omite la comprobación de formato. El problema PDF417 está documentado por separado en los problemas de GitHub como "muy problemático: la mayoría de los escaneos nunca se realizan", y afecta a etiquetas de envío, permisos de conducir y tarjetas de embarque.

Enfoque IronBarcode

IronBarcode devuelve el valor UPC-A correcto de 12 dígitos sin necesidad de normalización manual. PDF417 es un formato compatible que se lee de forma fiable. La generación de código también está disponible a través de la API de 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")

En aplicaciones donde la precisión de los datos de códigos de barras afecta directamente a las consultas de inventario, las transacciones en puntos de venta o las integraciones de la cadena de suministro, el manejo correcto del formato de IronBarcode elimina una categoría de errores de producción que BarcodeScanning.Native.Maui deja en el código de la aplicación. La documentación de IronBarcode sobre la lectura de códigos de barras describe en detalle el comportamiento específico de cada formato.

Se agregó el destino MAUI de Windows a la compilación.

Las aplicaciones MAUI suelen comenzar con un objetivo para iOS y Android, y posteriormente añaden Windows a medida que la aplicación madura o a medida que se amplían los requisitos de distribución Enterprise . Cuando se agrega el destino Windows, BarcodeScanning.Native.Maui se convierte en un obstáculo inmediato: no hay implementación para Windows ni solución alternativa dentro de la biblioteca. En esta situación, los equipos deben mantener una implementación de código de barras independiente para Windows utilizando una biblioteca diferente, o bien migrar toda la capa de código de barras a una biblioteca que funcione de forma consistente en todos los sistemas MAUI. La segunda opción es operativamente más sencilla y elimina la sobrecarga de mantenimiento que supone la ramificación específica de la plataforma.

Se han añadido requisitos para la carga de archivos o el procesamiento de PDF.

Las aplicaciones móviles suelen comenzar utilizando el escaneo de la cámara en tiempo real como único método de entrada y, posteriormente, se amplían para aceptar imágenes o documentos subidos a la aplicación. Cuando un usuario necesita escanear un código de barras de una foto en su galería, de una imagen recibida por correo electrónico o de un PDF que contiene manifiestos de envío o tarjetas de embarque, BarcodeScanning.Native.Maui no tiene ninguna ruta de código que ofrecer. Los equipos que alcanzan este límite de requisitos se enfrentan a una disyuntiva: añadir una segunda biblioteca de códigos de barras junto con BarcodeScanning.Native.Maui para la entrada de archivos y PDF, o migrar a una única biblioteca que gestione todos los tipos de entrada. Gestionar dos paquetes de códigos de barras con API, tipos de resultados y tablas de compatibilidad de formatos diferentes añade una complejidad a largo plazo que una solución de un solo paquete evita.

Se introduce el procesamiento de códigos de barras del lado del servidor.

Las aplicaciones que escanean códigos de barras en dispositivos móviles suelen desarrollar un componente del lado del servidor: un punto final de API de ASP.NET que valida los códigos de barras, un proceso en segundo plano que procesa archivos PDF o una función en la nube que extrae los números de seguimiento de los documentos cargados. BarcodeScanning.Native.Maui es una biblioteca de control de interfaz de usuario que depende del contexto del hardware de la cámara; No puede ejecutarse en un proceso de servidor. Un equipo que necesita la misma lógica de lectura de códigos de barras tanto en dispositivos móviles como en servidores debe usar una biblioteca diferente para el lado del servidor. Cuando surge el requisito del lado del servidor, los equipos suelen evaluar si es preferible consolidar una única biblioteca que abarque tanto dispositivos móviles como servidores, en lugar de mantener dos implementaciones separadas.

La precisión de los datos UPC-A se convierte en un problema de producción.

El comportamiento del código UPC-A de 13 dígitos en iOS no siempre se detecta durante el desarrollo. Los códigos de barras UPC-A escaneados durante el desarrollo pueden parecer que funcionan correctamente, pero el cero inicial introducido por el marco Vision de Apple aparece en la base de datos. Los equipos que descubren códigos UPC-A de 13 dígitos en registros de inventario, sistemas de punto de venta o integraciones de la cadena de suministro se enfrentan a un problema de corrección de datos, además de un problema de código. La solución alternativa documentada en los problemas de GitHub de BarcodeScanning.Native.Maui corrige los escaneos nuevos, pero no soluciona los problemas con los datos históricos. Cuando se hace evidente el alcance del problema de calidad de los datos, migrar a una biblioteca que devuelva valores UPC-A correctos sin normalización a nivel de aplicación suele ser la solución a largo plazo más limpia.

PDF417 Se requiere escanear el documento

PDF417 es el formato de código de barras que se utiliza en las etiquetas de envío, los permisos de conducir y las tarjetas de embarque en Norteamérica. Estos son objetivos de escaneo comunes para aplicaciones de logística, verificación de identidad y viajes. El sistema de seguimiento de incidencias de BarcodeScanning.Native.Maui en GitHub documenta que PDF417 es "muy problemático: la mayoría de los escaneos nunca se realizan". Para cualquier aplicación donde la fiabilidad de PDF417 sea un requisito funcional y no una característica deseable, este problema conocido supone un obstáculo directo que obliga a evaluar bibliotecas alternativas.

Evento de cámara a MediaPicker y lectura estática

El principal cambio estructural en la migración es la sustitución del patrón de eventos de cámara continua por una captura MediaPicker seguida de BarcodeReader.Read(). Se eliminan el manejador de eventos OnDetectionFinished, el control XAML CameraView y la declaración de espacio de nombres XML scanner:. En su lugar, un botón activa MediaPicker.CapturePhotoAsync(), y los bytes de foto resultantes se pasan a BarcodeReader.Read(). Esto cambia la experiencia del usuario, pasando de un visor continuo en tiempo real a la pantalla de una cámara de sistema, lo cual resulta apropiado para la mayoría de las aplicaciones empresariales.

Cambios en la serialización de hilos

BarcodeScanning.Native.Maui dispara OnDetectionFinished en un subproceso en segundo plano, por lo que todos los controladores existentes que actualizan los elementos de la interfaz de usuario envuelven sus actualizaciones en MainThread.BeginInvokeOnMainThread(). Con el patrón MediaPicker + async utilizado por IronBarcode, la continuación después de await vuelve al contexto de llamada, que suele ser el hilo principal. En la mayoría de los casos se pueden eliminar las envolturas MainThread.BeginInvokeOnMainThread(), simplificando el código del manejador de eventos.

Eliminación de la solución alternativa UPC-A

Cualquier código base que maneje el comportamiento iOS UPC-A de 13 dígitos de BarcodeScanning.Native.Maui tendrá código que compruebe BarcodeFormat.UPC_A y llame a Substring(1) para eliminar el cero inicial. Este código debe eliminarse después de la migración: IronBarcode devuelve el valor correcto de 12 dígitos, y dejar la solución alternativa eliminaría incorrectamente el primer dígito de las lecturas UPC-A válidas.

Permisos de MAUI

BarcodeScanning.Native.Maui añade automáticamente permisos de cámara a los manifiestos de Android e iOS como parte de la configuración del paquete. Con IronBarcode utilizando MediaPicker, se requieren los permisos de cámara MAUI estándar en AndroidManifest.xml y Info.plist - los mismos permisos que cualquier aplicación MAUI necesita para MediaPicker.CapturePhotoAsync(). Estos permisos suelen estar ya presentes en los proyectos de MAUI que utilizan la cámara para cualquier propósito.