El problema fundamental

La arquitectura de BarcodeLib, que solo permite la generación de código fuente, implica que añadir cualquier capacidad de escaneo obliga a incorporar una segunda biblioteca:

// BarcodeLib: generation only — reading requires a completely separate library
using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
SKImage img = b.Encode(Type.Code128, "PRODUCT-12345", 300, 100);
using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

// To read it back, a separate scanning library such as ZXing.Net is required —
// separate API, separate dependency graph to maintain alongside BarcodeLib.

// BarcodeLib: generation only — reading requires a completely separate library
using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
SKImage img = b.Encode(Type.Code128, "PRODUCT-12345", 300, 100);
using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

// To read it back, a separate scanning library such as ZXing.Net is required —
// separate API, separate dependency graph to maintain alongside BarcodeLib.

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()
Dim img As SKImage = b.Encode(Type.Code128, "PRODUCT-12345", 300, 100)
Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

IronBarcode maneja ambos en el mismo paquete con la misma declaración de using:

// IronBarcode: generation and reading — no second library needed
using IronBarCode;

// Generate
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("barcode.png");

// Read back — same package, same namespace
var result = BarcodeReader.Read("barcode.png").First().Value;
Console.WriteLine(result);  // "PRODUCT-12345"

// IronBarcode: generation and reading — no second library needed
using IronBarCode;

// Generate
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .SaveAsPng("barcode.png");

// Read back — same package, same namespace
var result = BarcodeReader.Read("barcode.png").First().Value;
Console.WriteLine(result);  // "PRODUCT-12345"

Imports IronBarCode

' Generate
BarcodeWriter.CreateBarcode("PRODUCT-12345", BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .SaveAsPng("barcode.png")

' Read back — same package, same namespace
Dim result = BarcodeReader.Read("barcode.png").First().Value
Console.WriteLine(result)  ' "PRODUCT-12345"

Paso 1: Sustituir el paquete NuGet

Eliminar primero el paquete de BarcodeLib:

dotnet remove package BarcodeLib

dotnet remove package BarcodeLib

Si no está seguro de cómo se hace referencia, verifique el archivo .csproj:

grep -n "BarcodeLib" YourProject.csproj

grep -n "BarcodeLib" YourProject.csproj

Elimine todas las entradas de <PackageReference> relacionadas con BarcodeLib. Si agregó anulaciones explícitas de <PackageReference Include="SkiaSharp"> para solucionar las advertencias NU1608 de BarcodeLib, elimínelas también. Después de instalar IronBarcode, evalúe si SkiaSharp todavía se necesita por otras razones. Luego instala IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

Paso 2: Actualizar los espacios de nombres

Reemplace las directivas using de BarcodeLiben cada archivo que las refiera:

// Before
using BarcodeStandard;
using SkiaSharp;

// After
using IronBarCode;

// Before
using BarcodeStandard;
using SkiaSharp;

// After
using IronBarCode;

Imports IronBarCode
Imports SkiaSharp

Paso 3: Inicializar licencia

Añadir inicialización de licencia al inicio de la aplicación:

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

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

Imports IronBarCode

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

Para aplicaciones ASP.NET Core, coloque esto en Program.cs antes de builder.Build(). Para aplicaciones de consola, colóquelo en la parte superior de Main(). Para las bibliotecas de clases a las que se llama desde otras aplicaciones, inicialícelas dondequiera que se inicie la aplicación anfitriona.

Generación de código básico128

El patrón más común de BarcodeLib: crear una instancia, establecer propiedades, llamar a Encode().

Enfoque de BarcodeLib:

using BarcodeStandard;
using SkiaSharp;

public void GenerateShippingLabel(string trackingNumber, string outputPath)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(Type.Code128, trackingNumber, 400, 120);
    using var stream = File.OpenWrite(outputPath);
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);
}

using BarcodeStandard;
using SkiaSharp;

public void GenerateShippingLabel(string trackingNumber, string outputPath)
{
    var b = new Barcode();
    b.IncludeLabel = true;
    SKImage img = b.Encode(Type.Code128, trackingNumber, 400, 120);
    using var stream = File.OpenWrite(outputPath);
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);
}

Imports BarcodeStandard
Imports SkiaSharp

Public Sub GenerateShippingLabel(trackingNumber As String, outputPath As String)
    Dim b As New Barcode()
    b.IncludeLabel = True
    Dim img As SKImage = b.Encode(Type.Code128, trackingNumber, 400, 120)
    Using stream = File.OpenWrite(outputPath)
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
    End Using
End Sub

Enfoque de IronBarcode :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public void GenerateShippingLabel(string trackingNumber, string outputPath)
{
    BarcodeWriter.CreateBarcode(trackingNumber, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .AddAnnotationTextBelowBarcode(trackingNumber)
        .SaveAsPng(outputPath);
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public void GenerateShippingLabel(string trackingNumber, string outputPath)
{
    BarcodeWriter.CreateBarcode(trackingNumber, BarcodeEncoding.Code128)
        .ResizeTo(400, 120)
        .AddAnnotationTextBelowBarcode(trackingNumber)
        .SaveAsPng(outputPath);
}

Imports IronBarCode

Public Sub GenerateShippingLabel(trackingNumber As String, outputPath As String)
    BarcodeWriter.CreateBarcode(trackingNumber, BarcodeEncoding.Code128) _
        .ResizeTo(400, 120) _
        .AddAnnotationTextBelowBarcode(trackingNumber) _
        .SaveAsPng(outputPath)
End Sub

El bloque de configuración de propiedades se transforma en una cadena fluida. .AddAnnotationTextBelowBarcode() reemplaza a b.IncludeLabel = true — acepta la cadena de etiqueta explícitamente para que controle qué texto aparece debajo de las barras. .ResizeTo() reemplaza los argumentos de ancho/altura. Para opciones de generación avanzadas, consulte la documentación de generación de códigos de barras de IronBarcode .

Devolver byte[] — el patrón común de API web

BarcodeLib 3.x devuelve un SKImage. Obtener bytes de él requiere codificación a través de SkiaSharp en un MemoryStream. IronBarcode ofrece .ToPngBinaryData() directamente.

Enfoque de BarcodeLib:

using BarcodeStandard;
using SkiaSharp;
using System.IO;

public byte[] GetBarcodeBytes(string data)
{
    var b = new Barcode();
    SKImage img = b.Encode(Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

using BarcodeStandard;
using SkiaSharp;
using System.IO;

public byte[] GetBarcodeBytes(string data)
{
    var b = new Barcode();
    SKImage img = b.Encode(Type.Code128, data, 300, 100);

    using var ms = new MemoryStream();
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
    return ms.ToArray();
}

Imports BarcodeStandard
Imports SkiaSharp
Imports System.IO

Public Function GetBarcodeBytes(data As String) As Byte()
    Dim b As New Barcode()
    Dim img As SKImage = b.Encode(Type.Code128, data, 300, 100)

    Using ms As New MemoryStream()
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
        Return ms.ToArray()
    End Using
End Function

Enfoque de IronBarcode :

using IronBarCode;

public byte[] GetBarcodeBytes(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .ToPngBinaryData();
}

using IronBarCode;

public byte[] GetBarcodeBytes(string data)
{
    return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
        .ResizeTo(300, 100)
        .ToPngBinaryData();
}

Imports IronBarCode

Public Function GetBarcodeBytes(data As String) As Byte()
    Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
        .ResizeTo(300, 100) _
        .ToPngBinaryData()
End Function

El paso intermedio de MemoryStream se ha eliminado. .ToPngBinaryData() devuelve el byte[] directamente, que es lo que los cuerpos de respuestas HTTP, las columnas BLOB de bases de datos y los escritores de archivos realmente quieren.

Acción del controlador de la API web

Enfoque de BarcodeLib:

using BarcodeStandard;
using SkiaSharp;
using Microsoft.AspNetCore.Mvc;
using System.IO;

[ApiController]
[Route("api/labels")]
public class LabelsController : ControllerBase
{
    [HttpGet("{sku}")]
    public IActionResult GetLabel(string sku)
    {
        var b = new Barcode();
        SKImage img = b.Encode(Type.Code128, sku, 400, 120);

        using var ms = new MemoryStream();
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
        return File(ms.ToArray(), "image/png");
    }
}

using BarcodeStandard;
using SkiaSharp;
using Microsoft.AspNetCore.Mvc;
using System.IO;

[ApiController]
[Route("api/labels")]
public class LabelsController : ControllerBase
{
    [HttpGet("{sku}")]
    public IActionResult GetLabel(string sku)
    {
        var b = new Barcode();
        SKImage img = b.Encode(Type.Code128, sku, 400, 120);

        using var ms = new MemoryStream();
        img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
        return File(ms.ToArray(), "image/png");
    }
}

Imports BarcodeStandard
Imports SkiaSharp
Imports Microsoft.AspNetCore.Mvc
Imports System.IO

<ApiController>
<Route("api/labels")>
Public Class LabelsController
    Inherits ControllerBase

    <HttpGet("{sku}")>
    Public Function GetLabel(sku As String) As IActionResult
        Dim b As New Barcode()
        Dim img As SKImage = b.Encode(Type.Code128, sku, 400, 120)

        Using ms As New MemoryStream()
            img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
            Return File(ms.ToArray(), "image/png")
        End Using
    End Function
End Class

Enfoque de IronBarcode :

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/labels")]
public class LabelsController : ControllerBase
{
    [HttpGet("{sku}")]
    public IActionResult GetLabel(string sku)
    {
        byte[] pngBytes = BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
            .ResizeTo(400, 120)
            .ToPngBinaryData();

        return File(pngBytes, "image/png");
    }
}

using IronBarCode;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/labels")]
public class LabelsController : ControllerBase
{
    [HttpGet("{sku}")]
    public IActionResult GetLabel(string sku)
    {
        byte[] pngBytes = BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128)
            .ResizeTo(400, 120)
            .ToPngBinaryData();

        return File(pngBytes, "image/png");
    }
}

Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/labels")>
Public Class LabelsController
    Inherits ControllerBase

    <HttpGet("{sku}")>
    Public Function GetLabel(sku As String) As IActionResult
        Dim pngBytes As Byte() = BarcodeWriter.CreateBarcode(sku, BarcodeEncoding.Code128) _
            .ResizeTo(400, 120) _
            .ToPngBinaryData()

        Return File(pngBytes, "image/png")
    End Function
End Class

La acción del controlador se reduce eliminando el bloque MemoryStream y el paso de codificación SkiaSharp. La matriz de bytes fluye directamente de .ToPngBinaryData() a File().

Generación de códigos QR

BarcodeLib 3.x no genera códigos QR; el enum BarcodeStandard.Type no contiene entradas 2D. Los proyectos que necesitaban QR junto a BarcodeLibtípicamente agregaban una segunda biblioteca como QRCoder. IronBarcode utiliza una clase QRCodeWriter dedicada con opciones adicionales para la incrustación de logotipos y estilo.

Enfoque de BarcodeLib:

// BarcodeLibhas no QR Code (or any 2D) support.
// Generating a QR code from a BarcodeLibproject required adding a
// second library such as QRCoder:
//
// using QRCoder;
// var qrGen = new QRCodeGenerator();
// var data = qrGen.CreateQrCode("https://example.com/product/42", QRCodeGenerator.ECCLevel.Q);
// // ... separate API, separate dependency to maintain.

// BarcodeLibhas no QR Code (or any 2D) support.
// Generating a QR code from a BarcodeLibproject required adding a
// second library such as QRCoder:
//
// using QRCoder;
// var qrGen = new QRCodeGenerator();
// var data = qrGen.CreateQrCode("https://example.com/product/42", QRCodeGenerator.ECCLevel.Q);
// // ... separate API, separate dependency to maintain.

' BarcodeLib has no QR Code (or any 2D) support.
' Generating a QR code from a BarcodeLib project required adding a
' second library such as QRCoder:
'
' Imports QRCoder
' Dim qrGen As New QRCodeGenerator()
' Dim data = qrGen.CreateQrCode("https://example.com/product/42", QRCodeGenerator.ECCLevel.Q)
' ' ... separate API, separate dependency to maintain.

Enfoque de IronBarcode :

using IronBarCode;

// Basic QR code
QRCodeWriter.CreateQrCode("https://example.com/product/42", 300)
    .SaveAsPng("qr.png");

// QR code with embedded brand logo (not possible with BarcodeLib)
QRCodeWriter.CreateQrCode("https://example.com/product/42", 300)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

using IronBarCode;

// Basic QR code
QRCodeWriter.CreateQrCode("https://example.com/product/42", 300)
    .SaveAsPng("qr.png");

// QR code with embedded brand logo (not possible with BarcodeLib)
QRCodeWriter.CreateQrCode("https://example.com/product/42", 300)
    .AddBrandLogo("logo.png")
    .SaveAsPng("qr-branded.png");

Imports IronBarCode

' Basic QR code
QRCodeWriter.CreateQrCode("https://example.com/product/42", 300) _
    .SaveAsPng("qr.png")

' QR code with embedded brand logo (not possible with BarcodeLib)
QRCodeWriter.CreateQrCode("https://example.com/product/42", 300) _
    .AddBrandLogo("logo.png") _
    .SaveAsPng("qr-branded.png")

QRCodeWriter.CreateQrCode() toma la cadena de datos y el tamaño de píxel como parámetros. La incrustación del logotipo, la personalización del color y el nivel de corrección de errores están disponibles mediante métodos encadenados. Para conocer las opciones de estilo del código QR, consulte la documentación de códigos QR de IronBarcode .

EAN-13 y UPC-A

Son habituales en los sistemas de inventario de las tiendas minoristas. Los nombres de las enumeraciones cambian, pero los valores son equivalentes directos.

Enfoque de BarcodeLib:

using BarcodeStandard;
using SkiaSharp;

// EAN-13 product barcode
var b = new Barcode();
SKImage ean = b.Encode(Type.Ean13, "5901234123457", 250, 100);
using (var s = File.OpenWrite("product-ean.png"))
    ean.Encode(SKEncodedImageFormat.Png, 100).SaveTo(s);

// UPC-A for US retail
SKImage upc = b.Encode(Type.UpcA, "012345678905", 250, 100);
using (var s = File.OpenWrite("product-upc.png"))
    upc.Encode(SKEncodedImageFormat.Png, 100).SaveTo(s);

using BarcodeStandard;
using SkiaSharp;

// EAN-13 product barcode
var b = new Barcode();
SKImage ean = b.Encode(Type.Ean13, "5901234123457", 250, 100);
using (var s = File.OpenWrite("product-ean.png"))
    ean.Encode(SKEncodedImageFormat.Png, 100).SaveTo(s);

// UPC-A for US retail
SKImage upc = b.Encode(Type.UpcA, "012345678905", 250, 100);
using (var s = File.OpenWrite("product-upc.png"))
    upc.Encode(SKEncodedImageFormat.Png, 100).SaveTo(s);

Imports BarcodeStandard
Imports SkiaSharp
Imports System.IO

' EAN-13 product barcode
Dim b As New Barcode()
Dim ean As SKImage = b.Encode(Type.Ean13, "5901234123457", 250, 100)
Using s = File.OpenWrite("product-ean.png")
    ean.Encode(SKEncodedImageFormat.Png, 100).SaveTo(s)
End Using

' UPC-A for US retail
Dim upc As SKImage = b.Encode(Type.UpcA, "012345678905", 250, 100)
Using s = File.OpenWrite("product-upc.png")
    upc.Encode(SKEncodedImageFormat.Png, 100).SaveTo(s)
End Using

Enfoque de IronBarcode :

using IronBarCode;

// EAN-13 product barcode
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .ResizeTo(250, 100)
    .SaveAsPng("product-ean.png");

// UPC-A for US retail
BarcodeWriter.CreateBarcode("012345678905", BarcodeEncoding.UPCA)
    .ResizeTo(250, 100)
    .SaveAsPng("product-upc.png");

using IronBarCode;

// EAN-13 product barcode
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .ResizeTo(250, 100)
    .SaveAsPng("product-ean.png");

// UPC-A for US retail
BarcodeWriter.CreateBarcode("012345678905", BarcodeEncoding.UPCA)
    .ResizeTo(250, 100)
    .SaveAsPng("product-upc.png");

Imports IronBarCode

' EAN-13 product barcode
BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .ResizeTo(250, 100) _
    .SaveAsPng("product-ean.png")

' UPC-A for US retail
BarcodeWriter.CreateBarcode("012345678905", BarcodeEncoding.UPCA) _
    .ResizeTo(250, 100) _
    .SaveAsPng("product-upc.png")

Incorporación de la lectura de códigos de barras (nueva funcionalidad)

BarcodeLib no tiene una API de lectura. Si su migración se debe a un nuevo requisito para escanear códigos de barras (desde imágenes cargadas, escáneres de almacén o documentos PDF escaneados), agregue esto sin una segunda biblioteca:

Enfoque de BarcodeLib:

// BarcodeLib— no reading API exists
// Adding reading requires a separate library such as ZXing.Net:
// dotnet add package ZXing.Net
// using ZXing;
// var reader = new BarcodeReader();
// // ... separate API, separate dependency graph to manage

// BarcodeLib— no reading API exists
// Adding reading requires a separate library such as ZXing.Net:
// dotnet add package ZXing.Net
// using ZXing;
// var reader = new BarcodeReader();
// // ... separate API, separate dependency graph to manage

' BarcodeLib— no reading API exists
' Adding reading requires a separate library such as ZXing.Net:
' dotnet add package ZXing.Net
' Imports ZXing
' Dim reader As New BarcodeReader()
' ' ... separate API, separate dependency graph to manage

Enfoque de IronBarcode :

using IronBarCode;

// Read a barcode from an image file
var results = BarcodeReader.Read("incoming-label.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read all barcodes from a multi-page PDF — no PDF library required
var pdfResults = BarcodeReader.Read("supplier-invoice.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Configure for high-volume scanning with multiple barcodes per image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var warehouseResults = BarcodeReader.Read("dock-scan.png", options);

using IronBarCode;

// Read a barcode from an image file
var results = BarcodeReader.Read("incoming-label.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
}

// Read all barcodes from a multi-page PDF — no PDF library required
var pdfResults = BarcodeReader.Read("supplier-invoice.pdf");
foreach (var result in pdfResults)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");
}

// Configure for high-volume scanning with multiple barcodes per image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var warehouseResults = BarcodeReader.Read("dock-scan.png", options);

Imports IronBarCode

' Read a barcode from an image file
Dim results = BarcodeReader.Read("incoming-label.png")
For Each result In results
    Console.WriteLine($"Value: {result.Value}")
    Console.WriteLine($"Format: {result.Format}")
Next

' Read all barcodes from a multi-page PDF — no PDF library required
Dim pdfResults = BarcodeReader.Read("supplier-invoice.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' Configure for high-volume scanning with multiple barcodes per image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim warehouseResults = BarcodeReader.Read("dock-scan.png", options)

BarcodeReader.Read() acepta archivos de imagen, archivos PDF, flujos y objetos System.Drawing.Bitmap. El enum ReadingSpeed le permite intercambiar exhaustividad por rendimiento al escanear en volumen. Para leer las opciones de configuración, consulte la documentación de lectura de IronBarcode .

Resolución del conflicto de SkiaSharp

Si la migración se debe a las advertencias de NU1608, verifique que el conflicto se haya resuelto después de cambiar de paquete. Después de ejecutar dotnet remove package BarcodeLib y dotnet add package IronBarcode, reconstruya y verifique la salida:

dotnet build 2>&1 | grep -i "NU1608\|SkiaSharp"

dotnet build 2>&1 | grep -i "NU1608\|SkiaSharp"

Si no aparece ninguna salida, el conflicto se ha resuelto. Si las advertencias de SkiaSharp persisten, provienen de un paquete diferente en su gráfico de dependencias; IronBarcode no es la fuente.

Enfoque de BarcodeLib:

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="BarcodeLib" Version="3.1.5" />

  <PackageReference Include="SkiaSharp" Version="3.116.1" />
</ItemGroup>

Enfoque de IronBarcode :

<ItemGroup>
  <PackageReference Include="IronBarcode" Version="*" />

  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="IronBarcode" Version="*" />

  <PackageReference Include="SkiaSharp.Views.Maui.Controls" Version="3.116.1" />
</ItemGroup>

Problema 1: Cambio de Namespace de Enum de Tipo

BarcodeLib 3.x: Usa BarcodeStandard.Type.Code128 (PascalCase, en el espacio de nombres BarcodeStandard). El código de la versión 2.x más antiguo puede usar BarcodeLib.TYPE.CODE128 (constantes en mayúsculas, espacio de nombres BarcodeLib) — ambas formas aparecen en bases de código reales durante la migración.

Solución: Reemplace con BarcodeEncoding.Code128. Un grep a través de los archivos .cs identifica todas las ocurrencias:

grep -rn "Type\.\|TYPE\." --include="*.cs" .

grep -rn "Type\.\|TYPE\." --include="*.cs" .

Reemplazos comunes: Type.Code128 / TYPE.CODE128 → BarcodeEncoding.Code128, Type.Ean13 / TYPE.EAN13 → BarcodeEncoding.EAN13, Type.UpcA / TYPE.UPCA → BarcodeEncoding.UPCA, Type.Itf14 / TYPE.ITF14 → BarcodeEncoding.ITF14, Type.Codabar / TYPE.CO/DABAR → BarcodeEncoding.Codabar. BarcodeLibno tiene entrada para QR; cualquier TYPE.QR_Code es código muerto de una versión 2.x o un fork — reemplácelo con BarcodeEncoding.QRCode (o use QRCodeWriter para salida estilizada).

Problema 2: Tipo de Retorno SKImage / Image

BarcodeLib: b.Encode() devuelve SKImage en 3.x y System.Drawing.Image en 2.x. Cualquiera de los dos tipos no compilará contra IronBarcode.

Solución: Elimine la variable de imagen intermedia y reemplace la lógica de guardado con el método terminal adecuado en la cadena fluida:

// Before (BarcodeLib 3.x)
SKImage img = b.Encode(Type.Code128, data, 300, 100);
using var ms = new MemoryStream();
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
return ms.ToArray();

// After
return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .ToPngBinaryData();

// Before (BarcodeLib 3.x)
SKImage img = b.Encode(Type.Code128, data, 300, 100);
using var ms = new MemoryStream();
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms);
return ms.ToArray();

// After
return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .ToPngBinaryData();

Imports System.IO

' Before (BarcodeLib 3.x)
Dim img As SKImage = b.Encode(Type.Code128, data, 300, 100)
Using ms As New MemoryStream()
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(ms)
    Return ms.ToArray()
End Using

' After
Return BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .ToPngBinaryData()

Busque los patrones SKImage img = b.Encode y Image img = b.Encode para encontrar todas las ubicaciones afectadas.

Problema 3: Parámetros de Ancho y Alto

BarcodeLib: El ancho y la altura son argumentos posicionales en Encode(Type, string, int, int) en 3.x, y asignaciones de propiedades separadas b.Width / b.Height en el código 2.x más antiguo. Cualquiera de las formas necesita ser portada.

Solución: El ancho/altura se convierten en una sola llamada .ResizeTo(width, height) encadenada después de CreateBarcode(). Encuentre los sitios de llamada:

# Find Encode() calls and any Width/Height property assignments
grep -n "\.Encode(\|\.Width = \|\.Height = " --include="*.cs" -r .

# Find Encode() calls and any Width/Height property assignments
grep -n "\.Encode(\|\.Width = \|\.Height = " --include="*.cs" -r .

Luego reemplace los argumentos de tamaño o el par de propiedades con una sola llamada encadenada .ResizeTo(width, height).

Problema 4: Incluir etiqueta booleana (alternar)

BarcodeLib: b.IncludeLabel = true es un booleano que automáticamente representa la cadena de datos codificada como el texto visible debajo de las barras.

Solución: Use .AddAnnotationTextBelowBarcode("text"), que toma la cadena de etiqueta explícitamente. En la mayoría de los casos, utilice la misma cadena de datos que se codificó en el código de barras. Si el código original usaba IncludeLabel = true y dependía de BarcodeLibpara representar automáticamente los datos como la etiqueta, pase explícitamente esa misma cadena de datos:

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .AddAnnotationTextBelowBarcode(data)  // pass the same string
    .SaveAsPng(outputPath);

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .AddAnnotationTextBelowBarcode(data)  // pass the same string
    .SaveAsPng(outputPath);

Dim barcodeWriter = BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
barcodeWriter.AddAnnotationTextBelowBarcode(data) ' pass the same string
barcodeWriter.SaveAsPng(outputPath)

Problema 5: Referencias a SkiaSharp que quedan tras la eliminación de BarcodeLib

BarcodeLib: Los proyectos frecuentemente acumulaban entradas explícitas de <PackageReference Include="SkiaSharp"> específicamente para anular la restricción de versión de BarcodeLib. Estos elementos quedan huérfanos después de que se elimina BarcodeLib.

Solución: Después de cambiar a IronBarcode, verifique si SkiaSharp todavía es necesario para algún otro paquete antes de eliminar la referencia explícita:

# Check if SkiaSharp is still referenced by anything other than the explicit override
dotnet list package --include-transitive 2>&1 | grep -i skia

# Check if SkiaSharp is still referenced by anything other than the explicit override
dotnet list package --include-transitive 2>&1 | grep -i skia

Si SkiaSharp solo aparece debido a la ahora eliminada <PackageReference> explícita, elimine esa entrada. Si MAUI u otra dependencia aún lo requiere, déjelo; IronBarcode no entrará en conflicto con él.

Tareas previas a la migración

Realice estas búsquedas antes de comenzar a comprender el alcance de los cambios necesarios:

# Find all BarcodeLibusing directives (both 3.x BarcodeStandard and older BarcodeLib)
grep -rn "using BarcodeStandard\|using BarcodeLib" --include="*.cs" .

# Find Barcode object instantiation
grep -rn "new Barcode()" --include="*.cs" .

# Find Encode calls
grep -rn "\.Encode(" --include="*.cs" .

# Find Type enum usage (3.x PascalCase and 2.x uppercase)
grep -rn "Type\.Code128\|Type\.Ean13\|Type\.UpcA\|TYPE\.CODE128\|TYPE\.EAN13\|TYPE\.UPCA" --include="*.cs" .

# Find IncludeLabel usage
grep -rn "IncludeLabel" --include="*.cs" .

# Find the package references in project files
grep -rn "BarcodeLib" --include="*.csproj" .

# Find NU1608 evidence in lock files
grep -rn "NU1608" .

# Find all BarcodeLibusing directives (both 3.x BarcodeStandard and older BarcodeLib)
grep -rn "using BarcodeStandard\|using BarcodeLib" --include="*.cs" .

# Find Barcode object instantiation
grep -rn "new Barcode()" --include="*.cs" .

# Find Encode calls
grep -rn "\.Encode(" --include="*.cs" .

# Find Type enum usage (3.x PascalCase and 2.x uppercase)
grep -rn "Type\.Code128\|Type\.Ean13\|Type\.UpcA\|TYPE\.CODE128\|TYPE\.EAN13\|TYPE\.UPCA" --include="*.cs" .

# Find IncludeLabel usage
grep -rn "IncludeLabel" --include="*.cs" .

# Find the package references in project files
grep -rn "BarcodeLib" --include="*.csproj" .

# Find NU1608 evidence in lock files
grep -rn "NU1608" .

Documente todos los archivos afectados por cada búsqueda. Observe qué proyectos hacen referencia a BarcodeLibdirectamente y cuáles lo heredan de forma transitiva. Identifique cualquier modificación explícita de la versión de SkiaSharp que se haya agregado únicamente para resolver conflictos de BarcodeLib.

Tareas de actualización de código

1. Ejecute dotnet remove package BarcodeLib para cada proyecto
2. Elimine cualquier referencia explícita a la anulación de la versión de SkiaSharp que se haya agregado únicamente para solucionar conflictos con BarcodeLib.
3. Ejecute dotnet add package IronBarcode para cada proyecto
4. Agregue IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; al inicio de la aplicación en cada proyecto
5. Reemplace using BarcodeStandard; (o using BarcodeLib; en el código más antiguo) y using SkiaSharp; con using IronBarCode; en todos los archivos .cs
6. Elimine las importaciones de using System.Drawing.Imaging; sobrantes del uso ImageFormat.Png de 2.x
7. Reemplace las llamadas new Barcode() + Encode() con cadenas fluidas BarcodeWriter.CreateBarcode()
8. Reemplace Type.Code128 / TYPE.CODE128 → BarcodeEncoding.Code128 y todos los demás valores del enum
9. Reemplace los argumentos de ancho/alto (o b.Width = N; de 2.x b.Height = M;) with .ResizeTo(N, M) cadenas de llamadas
10. Reemplace b.IncludeLabel = true; con .AddAnnotationTextBelowBarcode(data)
11. Reemplace img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(...) con .SaveAsPng(path) o .ToPngBinaryData()
12. Elimine variables intermedias SKImage / Image y bloques MemoryStream donde .ToPngBinaryData() los reemplace
13. Agregue código de lectura de códigos de barras donde sea necesario (BarcodeReader.Read())

Pruebas posteriores a la migración

• Compile el proyecto y confirme que no quedan advertencias NU1608 en la salida de restauración.
• Ejecutar dotnet build 2>&1 | grep -i "NU1608|SkiaSharp"` para verificar que el conflicto de SkiaSharp esté completamente resuelto.
• Compare la salida visual de los códigos de barras generados con muestras válidas conocidas de BarcodeLib.
• Verifique que los códigos QR se decodifiquen correctamente usando un escáner móvil o el método BarcodeReader.Read()
• Pruebe los códigos de barras EAN-13 y UPC-A con el hardware del escáner de la tienda, si corresponde.
• Verificar que las imágenes se muestren correctamente en todos los destinos de salida: sistema de archivos, respuesta HTTP, almacenamiento de base de datos.
• Pruebe cualquier escenario de lectura de códigos de barras PDF usando BarcodeReader.Read("file.pdf") en documentos reales
• Confirma que las compilaciones multiplataforma se realicen correctamente si el proyecto está dirigido a Linux o macOS.
• Verificar que las compilaciones de MAUI se completen sin errores de enlace de SkiaSharp en dispositivos Android e iOS.