Padrão de geração do núcleo do BarcodeLib

O fluxo de trabalho padrão de geração do Biblioteca de código de barras requer criar uma instância, configurar propriedades e chamar Encode() com dimensões:

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();
b.IncludeLabel = true;
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using var stream = File.OpenWrite("barcode.png");
img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream);

Imports BarcodeStandard
Imports SkiaSharp

Dim b As New Barcode()
b.IncludeLabel = True
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Using stream = File.OpenWrite("barcode.png")
    img.Encode(SKEncodedImageFormat.Png, 100).SaveTo(stream)
End Using

Este é o fluxo de trabalho completo de geração. O padrão setter de propriedades é o design: a configuração acontece na instância antes da chamada Encode(), e o valor de retorno é um SKImage que deve ser codificado e escrito em um fluxo.

Comparação Detalhada de Recursos

Abordagem BarcodeLib

BarcodeLib requer construir uma instância e definir propriedades antes de chamar Encode() com dimensões. A saída é um SKImage:

using BarcodeStandard;
using SkiaSharp;

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

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

using BarcodeStandard;
using SkiaSharp;

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

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

Imports BarcodeStandard
Imports SkiaSharp

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

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

O tipo de retorno SKImage significa que a saída de matriz de bytes requer uma chamada de codificação SKEncodedImageFormat e um MemoryStream. A propriedade IncludeLabel é uma alternância booleana — Biblioteca de código de barras renderiza a string de dados codificada como a etiqueta visível sob as barras.

Abordagem do IronBarcode

A geração do IronBarcode é totalmente estática. Cadeias de configuração após CreateBarcode(), e métodos de saída terminam a cadeia diretamente:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

Imports IronBarCode

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

.ToPngBinaryData() retorna a matriz de bytes diretamente — sem objeto intermediário Image ou MemoryStream. .AddBarcodeValueTextBelowBarcode() renderiza a string de dados codificada como uma etiqueta abaixo das barras. Para cenários de geração avançados, consulte a documentação de geração de código de barras do IronBarcode .

Abordagem BarcodeLib

BarcodeLib não possui uma API de leitura. Não há método Decode(), Scan() ou ReadBarcode(). A leitura nunca fez parte do design da biblioteca. Qualquer tentativa de chamar um método de decodificação resulta em um erro de compilação:

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

using BarcodeStandard;
using SkiaSharp;

var b = new Barcode();

// There is no Decode, Scan, or Read method on Barcode.
// b.Decode("barcode.png");      // does not exist
// b.Scan("barcode.png");        // does not exist
// b.ReadBarcode("barcode.png"); // does not exist

// The only public operation is generation:
SKImage img = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100);

Imports BarcodeStandard
Imports SkiaSharp

Dim b = New Barcode()

' There is no Decode, Scan, or Read method on Barcode.
' b.Decode("barcode.png")      ' does not exist
' b.Scan("barcode.png")        ' does not exist
' b.ReadBarcode("barcode.png") ' does not exist

' The only public operation is generation:
Dim img As SKImage = b.Encode(BarcodeStandard.Type.Code128, "PRODUCT-12345", 300, 100)

Equipes que precisam tanto da geração quanto da leitura de código de barras em conjunto com o Biblioteca de código de barras devem adicionar uma segunda biblioteca — normalmente o ZXing .NET — o que introduz sua própria carga de gerenciamento de dependências e uma segunda superfície de API para manter.

Abordagem do IronBarcode

BarcodeReader.Read() aceita arquivos de imagem, arquivos PDF, fluxos e objetos System.Drawing.Bitmap. A leitura de um PDF não requer nenhuma biblioteca adicional:

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

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

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

using IronBarCode;

// Read from an image
var results = BarcodeReader.Read("barcode.png");
Console.WriteLine(results.First().Value);  // "PRODUCT-12345"

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

// Tune reading for speed vs. thoroughness
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var multiResults = BarcodeReader.Read("warehouse-scan.png", options);

Imports IronBarCode

' Read from an image
Dim results = BarcodeReader.Read("barcode.png")
Console.WriteLine(results.First().Value)  ' "PRODUCT-12345"

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

' Tune reading for speed vs. thoroughness
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}
Dim multiResults = BarcodeReader.Read("warehouse-scan.png", options)

O enum ReadingSpeed permite ajustar o desempenho da varredura para cenários de alto volume. Para obter orientações sobre a configuração de leitura, consulte a documentação de leitura do IronBarcode .

Abordagem BarcodeLib

Começando com Biblioteca de código de barras 3.x, a biblioteca introduziu o SkiaSharp como um backend gráfico para substituir System.Drawing.Common, que se tornou exclusivo doWindowsapós .NET 6. O Biblioteca de código de barras 3.1.5 declara SkiaSharp >= 2.88.8. Se um projeto já usa SkiaSharp através de outra dependência — comum em projetos MAUI usando SkiaSharp.Views.Maui e Microsoft.Maui.Graphics, que tendem para o SkiaSharp 3.x — as versões resolvidas podem não convergir. O resultado é, no mínimo, um aviso NU1608 e, na pior das hipóteses, uma falha na vinculação do assembly em tempo de execução:

warning NU1608: Detected package version outside of dependency constraint:
BarcodeLib 3.1.5 requires SkiaSharp (>= 2.88.8) but
version SkiaSharp 3.116.1 was resolved.

Forçar uma resolução por referências explícitas de pacotes é uma rota, embora não garanta compatibilidade em tempo de execução:

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

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

Mesmo com substituições explícitas, a compatibilidade depende das chamadas de API internas do Biblioteca de código de barras coincidirem com o que a versão do SkiaSharp resolvida expõe. Como um projeto mantido pela comunidade, o Biblioteca de código de barras não possui contrato de suporte comercial vinculado ao seu ritmo de lançamento.

Abordagem do IronBarcode

O IronBarcode não compartilha o gráfico de dependências do SkiaSharp com o código do aplicativo. Não há negociação de versões para gerenciar, nenhum erro NU1608 para diagnosticar e nenhum risco de vinculação de assembly em tempo de execução relacionado à resolução de versão do SkiaSharp. Projetos MAUI, projetos Blazor e qualquer outro aplicativo que dependa do SkiaSharp podem instalar o IronBarcode sem qualquer conflito de versão. Para padrões de integração específicos do MAUI, consulte a documentação do IronBarcode MAUI .

A exigência de leitura aparece.

Um sistema que gera etiquetas de envio há meses recebe um novo requisito: o aplicativo também deve processar etiquetas devolvidas pelos fornecedores. A integração com o armazém precisa analisar os códigos de barras presentes nos manifestos de remessas de entrada. Um sistema de gerenciamento de documentos precisa indexar códigos de barras em PDFs digitalizados. A Biblioteca de código de barras não consegue atender a nenhum desses requisitos — a API de leitura não existe. A equipe avalia a possibilidade de adicionar o ZXing .NET junto com a BarcodeLib, pondera o ônus de manutenção de duas bibliotecas e os dois grafos de dependência separados, e decide que o caminho mais limpo é uma biblioteca que lide com a geração e a leitura em uma única instalação do NuGet .

Conflito SkiaSharp em um projeto MAUI

Uma equipe adiciona a biblioteca Biblioteca de código de barras a um aplicativo MAUI existente e imediatamente se depara com avisos NU1608 durante a restauração. Eles investigam, identificam a incompatibilidade de versão entre o intervalo esperado de SkiaSharp do Biblioteca de código de barras e a versão necessária pelo MAUI, adicionam substituições explícitas <PackageReference> para forçar uma resolução, e consequem que a compilação passe. Em seguida, ocorre uma falha de execução no dispositivo quando os binários nativos do SkiaSharp carregam a versão errada. A correção requer uma investigação mais aprofundada do registro de vinculação do assembly. A mudança para o IronBarcode resolve o conflito pela raiz — não encontrando uma versão compatível do SkiaSharp, mas eliminando completamente a dependência compartilhada.

Processamento de código de barras em PDF necessário

Aplicações que geram documentos PDF com códigos de barras incorporados — faturas, ordens de serviço, manifestos de envio — às vezes precisam ler esses códigos de barras novamente durante o processamento subsequente. O Biblioteca de código de barras gera imagens de código de barras, mas não oferece suporte a PDF em nenhuma das extremidades. A leitura de códigos de barras de um PDF com o Biblioteca de código de barras requer primeiro a renderização do PDF em imagens usando uma biblioteca PDF separada e, em seguida, a passagem dessas imagens para uma biblioteca de leitura também separada. O IronBarcode lida com toda a cadeia nativamente: BarcodeReader.Read("file.pdf") percorre cada página e retorna todos os códigos de barras detectados sem uma etapa de renderização intermediária.

Surgimento da Necessidade de Código QR ou Outra Simbologia 2D

Projetos que inicialmente requeriam apenas códigos de barras lineares muitas vezes evoluem para precisar de saída de Código QR, Data Matrix, PDF417 ou Aztec. O Biblioteca de código de barras não gera simbologia 2D em sua série 3.x — o enum BarcodeStandard.Type não contém QR Code ou outras entradas 2D — então qualquer requisito 2D significa adicionar uma segunda biblioteca ou substituir o Biblioteca de código de barras totalmente. Os QRCodeWriter e BarcodeWriter do IronBarcode cobrem QR Code (com incorporação de logotipo, controle de cor e ajuste de correção de erro), Data Matrix, PDF417, e Aztec através da mesma API fluente. Equipes cujas necessidades de simbologia se expandem para 2D descobrem que a lacuna impulsiona a decisão de migração.

API de instância para API fluente estática

O código do Biblioteca de código de barras usa um padrão de objeto mutável: cria uma instância Barcode, define propriedades, chama Encode(). O IronBarcode usa um padrão fluente estático: chama BarcodeWriter.CreateBarcode(), encadeia métodos de configuração, termina com um método de saída. O código existente que armazena uma instância Barcode como um campo ou a passa entre métodos precisará ser reestruturado. A alteração típica consiste em substituir o bloco de configuração de propriedades por uma cadeia de métodos:

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

// The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(300, 100)
    .AddBarcodeValueTextBelowBarcode()
    .SaveAsPng(outputPath);

' The property setters on b become chained methods
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(300, 100) _
    .AddBarcodeValueTextBelowBarcode() _
    .SaveAsPng(outputPath)

SKImage para Saída Direta

O Biblioteca de código de barras 3.x retorna SKImage, que requer SKEncodedImageFormat e um fluxo para produzir bytes. Qualquer código digitado para SKImage ou passando por image.Encode(...).SaveTo(stream) precisará ser atualizado. A cadeia fluente do IronBarcode termina diretamente com o formato de saída desejado — .SaveAsPng(), .ToPngBinaryData(), .ToAnyImageData() — removendo a necessidade do objeto de imagem intermediário e da etapa de codificação para fluxo.

Enum de Tipo para Enum de Codificação de Código de Barras

O Biblioteca de código de barras 3.x usa o enum BarcodeStandard.Type com valores PascalCase, como BarcodeStandard.Type.Code128. O IronBarcode usa o enum BarcodeEncoding com valores como BarcodeEncoding.Code128. Os valores 1D mapeiam diretamente: Code128 → Code128, Ean13 → EAN13, UpcA → UPCA, Code39 → Code39. Um grep por BarcodeStandard.Type. em arquivos .cs identifica todas as ocorrências que precisam ser atualizadas.

Limpeza de referência SkiaSharp

Projetos que adicionaram entradas explícitas <PackageReference Include="SkiaSharp"> apenas para resolver os avisos NU1608 do Biblioteca de código de barras podem remover essas substituições após mudar para o IronBarcode. O comando dotnet list package --include-transitive confirma se o SkiaSharp ainda é necessário por outros pacotes no projeto antes de removê-lo.