El problema fundamental

El bucle de adivinanza de tipo es el síntoma más visible de la restricción mandatoria BarCodeType. En un código fuente de Spire.Barcode que procesa documentos de múltiples fuentes, este patrón aparece repetidamente:

// Spire.Barcode: growing candidate loop with silent misses
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: growing candidate loop with silent misses
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

IronBarcode elimina el bucle por completo. La detección de formato está integrada en la biblioteca:

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: single call, all formats, type included in result
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarcode

' IronBarcode: single call, all formats, type included in result
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Paso 1: Sustituir el paquete NuGet

Elimine el paquete o los paquetes de Spire que esté utilizando actualmente:

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

# Remove whichever variant is installed
dotnet remove package FreeSpire.Barcode
# or
dotnet remove package Spire.Barcode

# If Spire.PDF was installed only for barcode extraction, remove it as well
dotnet remove package Spire.PDF

Si Spire.PDF se utiliza para otras operaciones con documentos más allá de la extracción de código de barras, manténgalo y elimine solo las rutas de código relacionadas con códigos de barras.

Instalar IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

Paso 2: Actualizar los espacios de nombres

Reemplace todas las importaciones del espacio de nombres de Spire con el espacio de nombres de IronBarcode:

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

// Remove:
using Spire.Barcode;
using Spire.Pdf;

// Add:
using IronBarCode;

Imports IronBarCode

Paso 3: Inicializar licencia

Sustituya la inicialización de la licencia de Spire por una única asignación de propiedad de IronBarcode al iniciar la aplicación. Consulte la página de licencias de IronBarcode para obtener información sobre los formatos clave y las opciones de implementación.

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key");

// Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key");

// Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove (FreeSpire registration):
Spire.Barcode.BarcodeSettings.ApplyKey("your-free-key")

' Remove (commercial Spire license):
Spire.License.LicenseProvider.SetLicenseKey("your-commercial-key")

' Add (IronBarcode):
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Para entornos Docker y CI, la clave de licencia se puede proporcionar desde una variable de entorno:

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

Imports System

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Lectura de un código de barras de formato conocido

Una lectura de formato único en Spire.Barcode pasa explícitamente el tipo y recibe un string[].

Enfoque Spire.Barcode:

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("shipping-label.png", BarCodeType.Code128);

if (results.Length > 0)
{
    ProcessShipment(results[0]);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("shipping-label.png", BarCodeType.Code128)

If results.Length > 0 Then
    ProcessShipment(results(0))
End If

Enfoque de IronBarcode :

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

using IronBarCode;

var results = BarcodeReader.Read("shipping-label.png");

if (results.Any())
{
    ProcessShipment(results.First().Value);
}

Imports IronBarCode

Dim results = BarcodeReader.Read("shipping-label.png")

If results.Any() Then
    ProcessShipment(results.First().Value)
End If

Se elimina el parámetro BarCodeType. Si la lógica adicional necesita confirmar el formato detectado, results.First().Format lo proporciona sin requerir una variable de estado separada.

Colapsar un bucle de tipo de formato mixto

Cuando un código fuente de Spire.Barcode gestiona documentos que pueden contener varios formatos, el bucle de adivinación de tipos se acumula con el tiempo a medida que nuevos formatos entran en el flujo de trabajo.

Enfoque Spire.Barcode:

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

using Spire.Barcode;

BarcodeScanner scanner = new BarcodeScanner();
BarCodeType[] candidates = new[]
{
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
};

List<string> allValues = new List<string>();
foreach (BarCodeType type in candidates)
{
    string[] found = scanner.Scan("document-scan.png", type);
    allValues.AddRange(found);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates As BarCodeType() = {
    BarCodeType.Code128,
    BarCodeType.QRCode,
    BarCodeType.DataMatrix,
    BarCodeType.EAN13,
    BarCodeType.PDF417
}

Dim allValues As New List(Of String)()
For Each type As BarCodeType In candidates
    Dim found As String() = scanner.Scan("document-scan.png", type)
    allValues.AddRange(found)
Next

Enfoque de IronBarcode :

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

using IronBarCode;

// The entire loop is replaced by a single call
var results = BarcodeReader.Read("document-scan.png");
List<string> allValues = results.Select(r => r.Value).ToList();

Imports IronBarCode

' The entire loop is replaced by a single call
Dim results = BarcodeReader.Read("document-scan.png")
Dim allValues As List(Of String) = results.Select(Function(r) r.Value).ToList()

El sistema de lectura de imágenes de IronBarcode procesa las más de 50 simbologías en una sola pasada. Cuando se necesita ajustar la velocidad de lectura para el procesamiento por lotes de alto volumen, BarcodeReaderOptions proporciona ese control sin agregar ramas específicas de formato:

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read("document-scan.png", options);

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim results = BarcodeReader.Read("document-scan.png", options)

Para obtener orientación sobre cómo seleccionar el valor ReadingSpeed adecuado, consulte la documentación de opciones de velocidad de lectura.

Generación de un código de barras

La generación de Spire.Barcode requiere instanciar un objeto BarcodeSettings, asignar cada propiedad individualmente, pasar la configuración a un BarCodeGenerator y luego llamar a GenerateImage() antes de escribir cualquier archivo.

Enfoque Spire.Barcode:

using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "SHIP-9842-XZ";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("shipping-label.png", ImageFormat.Png);

using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "SHIP-9842-XZ";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("shipping-label.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "SHIP-9842-XZ"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("shipping-label.png", ImageFormat.Png)

Enfoque de IronBarcode :

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-9842-XZ", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("shipping-label.png")

El objeto mutable BarcodeSettings y la instancia BarCodeGenerator separada se reemplazan por una única llamada de fábrica estática con una cadena fluida. No hay riesgo de que la configuración se comparta accidentalmente en llamadas concurrentes porque cada invocación de CreateBarcode() es independiente.

Lectura de códigos de barras desde un documento PDF

Spire.Barcode no puede leer archivos PDF directamente. El enfoque basado en Spire requiere el paquete Spire.PDF separado para abrir el archivo, iterar sus páginas, extraer imágenes rasterizadas de cada página y luego pasar esas imágenes una por una al escáner de código de barras.

Enfoque Spire.Barcode:

using Spire.Pdf;
using Spire.Barcode;

var pdf = new PdfDocument();
pdf.LoadFromFile("invoices.pdf");

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

using Spire.Pdf;
using Spire.Barcode;

var pdf = new PdfDocument();
pdf.LoadFromFile("invoices.pdf");

var scanner = new BarcodeScanner();
var extractedValues = new List<string>();

foreach (PdfPageBase page in pdf.Pages)
{
    Image[] images = page.ExtractImages();
    foreach (Image image in images)
    {
        string[] found = scanner.Scan(image, BarCodeType.QRCode);
        extractedValues.AddRange(found);
    }
}

Imports Spire.Pdf
Imports Spire.Barcode

Dim pdf As New PdfDocument()
pdf.LoadFromFile("invoices.pdf")

Dim scanner As New BarcodeScanner()
Dim extractedValues As New List(Of String)()

For Each page As PdfPageBase In pdf.Pages
    Dim images() As Image = page.ExtractImages()
    For Each image As Image In images
        Dim found() As String = scanner.Scan(image, BarCodeType.QRCode)
        extractedValues.AddRange(found)
    Next
Next

Enfoque de IronBarcode :

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

IronBarcode lee documentos PDF directamente sin requerir Spire.PDF o cualquier gestión manual de páginas. El número de página de la que se extrajo cada código de barras está disponible en el objeto de resultados. Una vez que se reemplaza el código de lectura de PDF, se puede eliminar la referencia al paquete Spire.PDF y todas las importaciones using Spire.Pdf; del proyecto.

Problema 1: Eliminación del parámetro BarCodeType

Spire.Barcode: scanner.Scan(path, BarCodeType.Code128) — el argumento de tipo es requerido por la firma del método. Eliminarlo provoca un error de compilación.

Solución: Reemplazar la llamada completa con BarcodeReader.Read(path). Buscar en el código base BarCodeType. para localizar cada ocurrencia. Los bucles de adivinanza de tipo (bloques foreach que iteran sobre una matriz de candidatos BarCodeType[]) pueden eliminarse en su totalidad; una única llamada a BarcodeReader.Read() reemplaza el bucle.

Problema 2: Tipo de retorno de string[]

Spire.Barcode: Scan() returns string[]. El código posterior que asigna esto a una variable string[] o lo pasa a un método que espera string[] fallará al compilar después de la migración.

Solución: Actualizar los sitios de llamada para trabajar con BarcodeResults. Para obtener un array de cadenas simple, utilize .Select(r => r.Value).ToArray(). Para acceder al primer resultado, utilize .First()?.Value. Si el formato detectado se necesita posteriormente, está disponible en el objeto resultado a través de .Format — no se requiere una variable de estado separada.

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

// If a plain string array is needed:
string[] texts = BarcodeReader.Read("barcode.png")
    .Select(r => r.Value)
    .ToArray();

// If only the first value is needed:
string first = BarcodeReader.Read("barcode.png").First()?.Value;

Imports System.Linq

' If a plain string array is needed:
Dim texts As String() = BarcodeReader.Read("barcode.png") _
    .Select(Function(r) r.Value) _
    .ToArray()

' If only the first value is needed:
Dim first As String = BarcodeReader.Read("barcode.png").FirstOrDefault()?.Value

Problema 3: Limpieza del paquete Spire.PDF

Spire.Barcode: Los flujos de trabajo de lectura de PDF dependen de Spire.PDF para el acceso a páginas y la extracción de imágenes. El proyecto hace referencia al paquete y contiene importaciones using Spire.Pdf; y usos de PdfDocument / PdfPageBase distribuidos en varios archivos.

Solución: Después de reemplazar todo el código de extracción de códigos de barras en PDF con BarcodeReader.Read("file.pdf"), realice una auditoría con grep para confirmar que no quedan referencias Spire.Pdf antes de eliminar el paquete:

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "Spire\.Pdf\|PdfPageBase\|ExtractImages" --include="*.cs" .

Elimine el paquete solo cuando se hayan borrado todas las referencias:

dotnet remove package Spire.PDF

dotnet remove package Spire.PDF

Problema 4: Cambios en el espacio de nombres

Spire.Barcode: El espacio de nombres Spire.Barcode contiene BarcodeScanner, BarcodeSettings, BarCodeGenerator y BarCodeType. El espacio de nombres IronBarCode contiene BarcodeReader, BarcodeWriter, BarcodeEncoding y BarcodeReaderOptions.

Solución: Reemplazar using Spire.Barcode; por using IronBarCode; globalmente. El enum BarCodeType usado en la generación es reemplazado por BarcodeEncoding. El enum BarCodeType usado en la lectura no tiene equivalente en IronBarcode — simplemente se elimina, ya que la detección de formato es automática.

Tareas previas a la migración

Antes de realizar cambios, revise el código fuente para identificar todos los usos de Spire.Barcode:

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

grep -r "using Spire.Barcode" --include="*.cs" .
grep -r "using Spire.Pdf" --include="*.cs" .
grep -r "BarcodeScanner\|BarcodeSettings\|BarCodeGenerator\|BarCodeType\." --include="*.cs" .
grep -r "ApplyKey\|SetLicenseKey" --include="*.cs" .
grep -r "ExtractImages\|PdfPageBase" --include="*.cs" .

• Documentar todos los archivos que contienen matrices de candidatos BarCodeType (bucles de adivinanza de tipo que deben eliminarse)
• Identificar cualquier variable string[] que reciba resultados de Scan() y necesite actualizaciones de tipo
• Confirmar si Spire.PDF se utiliza para operaciones distintas a la extracción de códigos de barras

Tareas de actualización de código

1. Eliminar el paquete NuGet FreeSpire.Barcode o Spire.Barcode
2. Eliminar el paquete NuGet Spire.PDF si la extracción de códigos de barras era su único uso
3. Instalar el paquete NuGet IronBarcode
4. Reemplazar todos using Spire.Barcode; con using IronBarCode;
5. Eliminar todas las importaciones using Spire.Pdf; donde ya no sean necesarias
6. Reemplazar la inicialización de licencias: ApplyKey() o SetLicenseKey() con IronBarCode.License.LicenseKey = "key"
7. Eliminar todas las instancias new BarcodeScanner()
8. Reemplazar todas las llamadas scanner.Scan(path, BarCodeType.X) con BarcodeReader.Read(path)
9. Eliminar los bucles foreach que intentan adivinar el tipo de datos; reemplazar cada uno con una única llamada BarcodeReader.Read()
10. Eliminar los bloques de iteración de página PDF y extracción de imágenes; reemplazar con BarcodeReader.Read("file.pdf")
11. Actualizar las asignaciones de resultados string[] para usar .Value o .Select(r => r.Value).ToArray()
12. Reemplazar bloques new BarcodeSettings() con cadenas BarcodeWriter.CreateBarcode(data, encoding)
13. Eliminar instancias new BarCodeGenerator(settings)
14. Reemplazar .GenerateImage() + image.Save() con .SaveAsPng() o .SaveAsJpeg()
15. Reemplazar valores del enum BarCodeType.X en la generación con BarcodeEncoding.X

Pruebas posteriores a la migración

• Confirmar que todos los formatos previamente escaneados vía el bucle de candidatos sean detectados correctamente por BarcodeReader.Read()
• Medir el rendimiento del procesamiento por lotes y confirmar que cumple con los requisitos de producción.
• Verificar que la extracción del código de barras del PDF produzca valores y números de página correctos.
• Confirme la calidad y la capacidad de escaneo del código de barras generado con un escáner físico o de software.
• Compruebe que la clave de licencia esté cargada correctamente en todos los entornos de despliegue (local, preproducción, producción, CI/CD).
• Ejecute los comandos grep audit de Tareas previas a la migración para confirmar que no queden referencias a Spire.