El contexto de la portabilidad

Al migrar de ML Kit a IronBarcode, se producen algunos cambios estructurales, no solo sintácticos:

Las devoluciones de llamada se convierten en valores de retorno. ML Kit utiliza la API Task de Android con addOnSuccessListener y addOnFailureListener. El BarcodeReader.Read() de IronBarcode devuelve una colección de manera síncrona. Lo iteras directamente. Sin registro de devolución de llamada, sin coordinación de hilos.

No hay objeto escáner. ML Kit requiere que construyas un objeto BarcodeScannerOptions, llames a BarcodeScanning.getClient(options) para obtener una instancia de escáner, luego llames a scanner.process(inputImage). IronBarcode utiliza métodos estáticos; BarcodeReader.Read() es el punto de entrada. No hay ninguna instancia que gestionar o desechar.

Sin construcción de InputImage. El InputImage de ML Kit debe construirse desde una fuente específica de Android: InputImage.fromFilePath(context, uri), InputImage.fromBitmap(bitmap, rotation), o InputImage.fromMediaImage(image, rotation). IronBarcode acepta una cadena de ruta de archivo, un Stream, un byte[], o un System.Drawing.Bitmap. Sin contexto de Android, sin URI, sin metadatos de rotación.

No hay servicios de Google Play. El modelo de ML Kit no empaquetado se ejecuta a través de Google Play Services. La variante empaquetada envía el modelo dentro del APK (agregando aproximadamente 2.4 MB) y evita la verificación de Play Services, pero ninguna variante está disponible en objetivos .NET. IronBarcode no tiene esa dependencia: funciona de forma idéntica en cualquier plataforma compatible con .NET .

Configuración rápida en .NET

Elimine cualquier paquete de enlace de Xamarin/MAUI ML Kit si existen en su proyecto, luego instale IronBarcode:

dotnet add package BarCode

Agrega la clave de licencia al inicio de la aplicación, en Program.cs, MauiProgram.cs, o Startup.cs dependiendo del tipo de aplicación:

// NuGet: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// NuGet: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

La licencia se puede establecer en cualquier momento antes de la primera llamada BarcodeReader.Read() o BarcodeWriter.CreateBarcode(). Hay disponible una prueba gratuita; El modo de prueba aplica marcas de agua a los códigos de barras generados, pero no restringe la lectura.

Lectura de códigos de barras: de Kotlin a C

// Android Kotlin — ML Kit
val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_QR_CODE)
    .build()
val scanner = BarcodeScanning.getClient(options)
val inputImage = InputImage.fromFilePath(context, imageUri)

scanner.process(inputImage)
    .addOnSuccessListener { barcodes ->
        val barcode = barcodes.firstOrNull()
        if (barcode != null) {
            Log.d("MLKit", "Value: ${barcode.rawValue}")
            Log.d("MLKit", "Format: ${barcode.format}")
        }
    }
    .addOnFailureListener { e ->
        Log.e("MLKit", "Scan failed: ${e.message}")
    }

using IronBarCode;

try
{
    var results = BarcodeReader.Read("captured-image.jpg");
    var barcode = results.FirstOrDefault();
    if (barcode != null)
    {
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Format: {barcode.Format}");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Scan failed: {ex.Message}");
}

using IronBarCode;

try
{
    var results = BarcodeReader.Read("captured-image.jpg");
    var barcode = results.FirstOrDefault();
    if (barcode != null)
    {
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Format: {barcode.Format}");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Scan failed: {ex.Message}");
}

Imports IronBarCode

Try
    Dim results = BarcodeReader.Read("captured-image.jpg")
    Dim barcode = results.FirstOrDefault()
    If barcode IsNot Nothing Then
        Console.WriteLine($"Value: {barcode.Value}")
        Console.WriteLine($"Format: {barcode.Format}")
    End If
Catch ex As Exception
    Console.WriteLine($"Scan failed: {ex.Message}")
End Try

// Android Kotlin — ML Kit, multiple barcodes
val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_ALL_FORMATS)
    .build()
val scanner = BarcodeScanning.getClient(options)
val inputImage = InputImage.fromFilePath(context, imageUri)

scanner.process(inputImage)
    .addOnSuccessListener { barcodes ->
        for (barcode in barcodes) {
            val rawValue = barcode.rawValue
            val format = barcode.format
            processBarcode(rawValue, format)
        }
    }
    .addOnFailureListener { e -> Log.e("MLKit", e.message ?: "Unknown error") }

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("warehouse-shelf.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
    ProcessBarcode(barcode.Value, barcode.Format);
}

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("warehouse-shelf.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
    ProcessBarcode(barcode.Value, barcode.Format);
}

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

Dim results = BarcodeReader.Read("warehouse-shelf.jpg", options)
For Each barcode In results
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}")
    ProcessBarcode(barcode.Value, barcode.Format)
Next

Especificación de formato: setBarcodeFormats a BarcodeReaderOptions

ML Kit requiere que especifiques qué formatos buscar a través de setBarcodeFormats(). Si lo omites, ML Kit buscará en todos los formatos. IronBarcode funciona de la misma manera: si se omiten las restricciones de formato, la búsqueda se realiza en todos los ámbitos, pero especificar los tipos esperados mejora el rendimiento.

Uso de indicadores de formato en IronBarcode:

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};

var results = BarcodeReader.Read("product-image.jpg", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};

var results = BarcodeReader.Read("product-image.jpg", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128 Or BarcodeEncoding.EAN13
}

Dim results = BarcodeReader.Read("product-image.jpg", options)

La combinación OR a nivel de bits funciona de la misma manera que la lista de formato vararg de ML Kit.

Acceso al resultado: rawValue y formato

El objeto de resultado de ML Kit expone rawValue (un String?) y format (una constante Int). El resultado de IronBarcode expone Value (un string) y Format (un valor enum BarcodeEncoding).

// Kit ML Kotlin — result fields
val rawValue: String? = barcode.rawValue
val format: Int = barcode.format
val boundingBox: Rect? = barcode.boundingBox
val displayValue: String? = barcode.displayValue

// IronBarcode C#— result fields
string value = barcode.Value;
BarcodeEncoding format = barcode.Format;
int page = barcode.PageNumber; // populated for PDF / multi-page input

// IronBarcode C#— result fields
string value = barcode.Value;
BarcodeEncoding format = barcode.Format;
int page = barcode.PageNumber; // populated for PDF / multi-page input

' IronBarcode VB.NET— result fields
Dim value As String = barcode.Value
Dim format As BarcodeEncoding = barcode.Format
Dim page As Integer = barcode.PageNumber ' populated for PDF / multi-page input

barcode.Value siempre es una cadena no nula en IronBarcode; si la lectura tuvo éxito, el valor está presente. barcode.Format es el miembro enum BarcodeEncoding, al cual puedes comparar directamente: if (barcode.Format == BarcodeEncoding.QRCode).

¿Qué diferencias hay en .NET?

API síncrona en lugar de funciones de devolución de llamada. Este es el cambio estructural más significativo. El scanner.process() de ML Kit devuelve un Task<List<Barcode>> en el sentido de Android; encadenas listeners. El BarcodeReader.Read() de IronBarcode devuelve el resultado en línea. Si necesitas ejecutarlo fuera del hilo de la interfaz de usuario en una aplicación MAUI, envuélvelo en Task.Run():

using IronBarCode;

// In a MAUI ViewModel or page code-behind
var results = await Task.Run(() => BarcodeReader.Read(imagePath));
foreach (var barcode in results)
{
    // update UI on main thread
    MainThread.BeginInvokeOnMainThread(() =>
    {
        ResultLabel.Text = barcode.Value;
    });
}

using IronBarCode;

// In a MAUI ViewModel or page code-behind
var results = await Task.Run(() => BarcodeReader.Read(imagePath));
foreach (var barcode in results)
{
    // update UI on main thread
    MainThread.BeginInvokeOnMainThread(() =>
    {
        ResultLabel.Text = barcode.Value;
    });
}

Imports IronBarCode
Imports System.Threading.Tasks
Imports Microsoft.Maui.Dispatching

' In a MAUI ViewModel or page code-behind
Dim results = Await Task.Run(Function() BarcodeReader.Read(imagePath))
For Each barcode In results
    ' update UI on main thread
    MainThread.BeginInvokeOnMainThread(Sub()
                                           ResultLabel.Text = barcode.Value
                                       End Sub)
Next

Sin parámetro de contexto. Cada llamada de ML Kit que construye un InputImage requiere un Context de Android. IronBarcode solo necesita una ruta de archivo o un flujo de datos. Eliminar el encadenamiento de contexto de la lógica de los códigos de barras simplifica considerablemente el código.

Sin servicios de Google Play. El modelo estándar de ML Kit se ejecuta a través de Play Services; BarcodeScanning.getClient() verifica la disponibilidad de Play Services en tiempo de ejecución y arroja una excepción si no está disponible. IronBarcode no tiene comprobación de servicio en tiempo de ejecución. O bien lee la imagen o bien genera una excepción estándar.

Manejo de excepciones estándar. El addOnFailureListener de ML Kit recibe una subclase de Java Exception. En .NET, las fallas aparecen como lanzamientos estándar System.Exception, capturables con try/catch de la manera normal.

Lectura de documentos PDF

ML Kit no admite archivos PDF. InputImage.fromFilePath() con una URI .pdf o falla o solo lee la primera página como una imagen rasterizada, dependiendo de la versión de Android. Si su escenario de migración implica documentos (procesamiento de facturas, manifiestos logísticos, escaneo de formularios), IronBarcode maneja archivos PDF de forma nativa:

using IronBarCode;

// Read all barcodes from all pages of a PDF
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("invoice-batch.pdf", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

using IronBarCode;

// Read all barcodes from all pages of a PDF
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("invoice-batch.pdf", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

Imports IronBarCode

' Read all barcodes from all pages of a PDF
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

Dim results = BarcodeReader.Read("invoice-batch.pdf", options)
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

Sin paso de extracción de imágenes, sin biblioteca PDF de terceros, sin bucle de iteración de página con renderizado separado. Indique la ruta del PDF y obtenga todos los valores del código de barras junto con sus números de página.

Nuevas capacidades: Generación

ML Kit no genera códigos de barras, solo los lee. Si su aplicación adaptada necesita generar etiquetas, billetes o códigos QR, IronBarcode lo incluye en el mismo paquete.

Código 128 para etiquetas de envío:

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128)
    .ResizeTo(400, 120)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128)
    .ResizeTo(400, 120)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128) _
    .ResizeTo(400, 120) _
    .SaveAsPng("shipping-label.png")

Generación de código QR:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500)
    .SaveAsPng("tracking-qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500)
    .SaveAsPng("tracking-qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500) _
    .SaveAsPng("tracking-qr.png")

Código QR con logotipo y color:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500) _
    .AddBrandLogo("company-logo.png") _
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue) _
    .SaveAsPng("product-qr.png")

Devuelve el código de barras como una matriz de bytes para una respuesta HTTP:

using IronBarCode;

// In an ASP.NET Corecontroller action
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

return File(barcodeBytes, "image/png");

using IronBarCode;

// In an ASP.NET Corecontroller action
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

return File(barcodeBytes, "image/png");

Imports IronBarCode

' In an ASP.NET Core controller action
Dim barcodeBytes As Byte() = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode).ToPngBinaryData()

Return File(barcodeBytes, "image/png")

Ninguno de estos patrones tiene equivalentes en ML Kit. Se trata de nuevas funcionalidades disponibles gracias a que se trabaja con una biblioteca completa de códigos de barras .NET en lugar de un escáner exclusivamente para dispositivos móviles.

Procesamiento por lotes del lado del servidor

ML Kit procesa una imagen por llamada, requiere un entorno de ejecución para Android/iOS y no contempla la ejecución en el servidor. IronBarcode procesa archivos en un bucle, se ejecuta en ASP.NET Corey se escala normalmente:

using IronBarCode;

// Process a folder of scanned document images
var imageFiles = Directory.GetFiles("/data/scans", "*.jpg");
var allResults = new List<(string File, string Value, BarcodeEncoding Format)>();

foreach (var file in imageFiles)
{
    var options = new BarcodeReaderOptions
    {
        Speed = ReadingSpeed.Faster,
        ExpectMultipleBarcodes = false
    };

    var results = BarcodeReader.Read(file, options);
    foreach (var barcode in results)
    {
        allResults.Add((file, barcode.Value, barcode.Format));
    }
}

// Write results to CSV, database, etc.
foreach (var (file, value, format) in allResults)
{
    Console.WriteLine($"{file}: [{format}] {value}");
}

using IronBarCode;

// Process a folder of scanned document images
var imageFiles = Directory.GetFiles("/data/scans", "*.jpg");
var allResults = new List<(string File, string Value, BarcodeEncoding Format)>();

foreach (var file in imageFiles)
{
    var options = new BarcodeReaderOptions
    {
        Speed = ReadingSpeed.Faster,
        ExpectMultipleBarcodes = false
    };

    var results = BarcodeReader.Read(file, options);
    foreach (var barcode in results)
    {
        allResults.Add((file, barcode.Value, barcode.Format));
    }
}

// Write results to CSV, database, etc.
foreach (var (file, value, format) in allResults)
{
    Console.WriteLine($"{file}: [{format}] {value}");
}

Imports IronBarCode
Imports System.IO

' Process a folder of scanned document images
Dim imageFiles = Directory.GetFiles("/data/scans", "*.jpg")
Dim allResults = New List(Of (File As String, Value As String, Format As BarcodeEncoding))()

For Each file In imageFiles
    Dim options = New BarcodeReaderOptions With {
        .Speed = ReadingSpeed.Faster,
        .ExpectMultipleBarcodes = False
    }

    Dim results = BarcodeReader.Read(file, options)
    For Each barcode In results
        allResults.Add((file, barcode.Value, barcode.Format))
    Next
Next

' Write results to CSV, database, etc.
For Each result In allResults
    Console.WriteLine($"{result.File}: [{result.Format}] {result.Value}")
Next

Este proceso —leer una carpeta de imágenes, extraer códigos de barras y agregar resultados— no es posible con ML Kit. Se trata de un flujo de trabajo estándar de IronBarcode .

Comparación de características

Lista de comprobación de la migración

Si estás adaptando un código base de Android o reemplazando un enlace no oficial de Xamarin ML Kit, busca estos patrones en tu proyecto y aplica las traducciones anteriores:

• com.google.mlkit:barcode-scanning en archivos Gradle → eliminar, agregar BarCode NuGet
• BarcodeScannerOptions.Builder() → new BarcodeReaderOptions { }
• BarcodeScanning.getClient(options) → eliminar (no hay instancia de escáner en IronBarcode)
• InputImage.fromFilePath(context, uri) → argumento de cadena de ruta del archivo
• InputImage.fromBitmap(bitmap, rotation) → BarcodeReader.Read(stream) o sobrecarga de matriz de bytes
• scanner.process(inputImage) → BarcodeReader.Read(path, options)
• .addOnSuccessListener { barcodes -> } → iterar el valor de retorno de Read()
• .addOnFailureListener { e -> } → try/catch alrededor de Read()
• barcode.rawValue → barcode.Value
• barcode.format → barcode.Format
• Barcode.FORMAT_QR_CODE → BarcodeEncoding.QRCode
• Barcode.FORMAT_CODE_128 → BarcodeEncoding.Code128
• Barcode.FORMAT_ALL_FORMATS → omitir ExpectBarcodeTypes
• using Google.MLKit.BarcodeScanning; (binding de Xamarin) → using IronBarCode;
• IronBarCode.License.LicenseKey debería establecerse en MauiProgram.cs, Program.cs, o Startup.cs

El cambio estructural de código basado en devoluciones de llamada a código síncrono es el trabajo principal. Las constantes de formato y los nombres de los campos de resultado son asignaciones directas. La compatibilidad con PDF y su generación es puramente aditiva; no requiere migración, solo código nuevo.