O problema fundamental

A configuração de licença dupla é o ponto de atrito mais imediato para qualquer projeto que necessite tanto de geração quanto de leitura de dados. OOnBarcoderequer duas chamadas separadas para dois namespaces de licença distintos na inicialização:

// OnBarcode: two products, two DLL references, no runtime key
//OnBarcodeuses pre-licensed DLLs — the purchased DLL is already activated.
// There is no runtime SetLicense() call; the license is baked into the downloaded assembly.
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// OnBarcode: two products, two DLL references, no runtime key
//OnBarcodeuses pre-licensed DLLs — the purchased DLL is already activated.
// There is no runtime SetLicense() call; the license is baked into the downloaded assembly.
using OnBarcode.Barcode;
using OnBarcode.Barcode;

Imports OnBarcode.Barcode
Imports OnBarcode.Barcode

O IronBarcode simplifica isso para uma única atribuição de propriedade que abrange todas as funcionalidades — geração, leitura, suporte a PDF e operações em lote — sob uma única chave:

// IronBarcode: one package, one key, one line
using IronBarCode;

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

// IronBarcode: one package, one key, one line
using IronBarCode;

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

Imports IronBarCode

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

Todas as operações de código de barras no aplicativo — independentemente de gerar, ler ou processar PDFs — são executadas sob essa única configuração.

Passo 1: Remova as referências ao pacote OnBarcode

Se o seu projeto utiliza pacotes NuGet , remova ambos:

dotnet remove package OnBarcode.Barcode.Generator
dotnet remove package OnBarcode.Barcode.Reader

dotnet remove package OnBarcode.Barcode.Generator
dotnet remove package OnBarcode.Barcode.Reader

Se o seu projeto utiliza a distribuição antiga baseada em DLL, também remova o bloco de referência manual do seu .csproj:

<ItemGroup>
  <Reference Include="OnBarcode.Barcode">
    <HintPath>lib\OnBarcode.Barcode.dll</HintPath>
    <Private>true</Private>
  </Reference>
</ItemGroup>

<ItemGroup>
  <Reference Include="OnBarcode.Barcode">
    <HintPath>lib\OnBarcode.Barcode.dll</HintPath>
    <Private>true</Private>
  </Reference>
</ItemGroup>

Exclua os arquivos DLL do diretório lib/ ou de onde quer que estejam armazenados. Manter os assemblies antigos junto com o novo pacote NuGet causará conflitos de namespace em tempo de compilação.

Passo 2: Adicionar IronBarcode

Um único pacote abrange geração, leitura e suporte a PDF:

dotnet add package IronBarcode

dotnet add package IronBarcode

Não é necessário um segundo pacote para leitura. Não é necessário nenhum pacote adicional para suporte a PDF.

Etapa 3: Atualize os namespaces e substitua a configuração de licença dupla.

Substitua ambas as diretivasOnBarcodeusing por uma única importação IronBarcode:

// Remove
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// Add
using IronBarCode;

// Remove
using OnBarcode.Barcode;
using OnBarcode.Barcode;

// Add
using IronBarCode;

Imports IronBarCode

Substitua as referências duplas de DLL por uma única atribuição de chave. Insira este código uma única vez, no início da inicialização do aplicativo, antes de qualquer operação de leitura de código de barras:

// Remove theOnBarcodeDLL references and using directives
// Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove theOnBarcodeDLL references and using directives
// Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove the OnBarcodeDLL references and Imports statements
' Add
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Geração de código de barras Code 128

O caso básico do Código 128 ilustra o padrão de atribuição de propriedades versus o padrão de fábrica estática.

Abordagem OnBarcode:

using OnBarcode.Barcode;

Linear barcode = new Linear();
barcode.Type = BarcodeType.CODE128;
barcode.Data = "SHIP-2024-001";
barcode.Resolution = 96;
barcode.X = 1;
barcode.BarcodeHeight = 80;
barcode.ShowText = true;
barcode.drawBarcode("shipping-label.png");

using OnBarcode.Barcode;

Linear barcode = new Linear();
barcode.Type = BarcodeType.CODE128;
barcode.Data = "SHIP-2024-001";
barcode.Resolution = 96;
barcode.X = 1;
barcode.BarcodeHeight = 80;
barcode.ShowText = true;
barcode.drawBarcode("shipping-label.png");

Imports OnBarcode.Barcode

Dim barcode As New Linear()
barcode.Type = BarcodeType.CODE128
barcode.Data = "SHIP-2024-001"
barcode.Resolution = 96
barcode.X = 1
barcode.BarcodeHeight = 80
barcode.ShowText = True
barcode.drawBarcode("shipping-label.png")

Abordagem do IronBarcode:

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-2024-001", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

O tipo de dado e de codificação são passados como argumentos para CreateBarcode. Propriedades como resolução e altura da barra não são necessárias para produzir uma saída que possa ser escaneada; As configurações padrão são adequadas para a maioria dos usos. Quando dimensões personalizadas são necessárias, elas podem ser adicionadas como chamadas encadeadas entre CreateBarcode e SaveAsPng sem introduzir estado de objeto mutável.

Geração de código QR com logotipo

QR codes com logotipo requerem que oOnBarcoderecorra ao System.Drawing para o passo de sobreposição de imagem. O IronBarcode fornece isso como uma operação integrada.

Abordagem OnBarcode:

using OnBarcode.Barcode;
using System.Drawing;

QRCode qr = new QRCode();
qr.Data = "https://example.com/product/4891";
qr.QRCodeDataMode = QRCodeDataMode.Auto;
qr.QRCodeECL = QRCodeECL.H; // H-level error correction required for logo overlay

Image qrImage = qr.drawBarcode();

using (Graphics g = Graphics.FromImage(qrImage))
{
    Image logo = Image.FromFile("brand-logo.png");
    int logoSize = qrImage.Width / 5;
    int x = (qrImage.Width - logoSize) / 2;
    int y = (qrImage.Height - logoSize) / 2;
    g.DrawImage(logo, x, y, logoSize, logoSize);
}

qrImage.Save("product-qr.png");

using OnBarcode.Barcode;
using System.Drawing;

QRCode qr = new QRCode();
qr.Data = "https://example.com/product/4891";
qr.QRCodeDataMode = QRCodeDataMode.Auto;
qr.QRCodeECL = QRCodeECL.H; // H-level error correction required for logo overlay

Image qrImage = qr.drawBarcode();

using (Graphics g = Graphics.FromImage(qrImage))
{
    Image logo = Image.FromFile("brand-logo.png");
    int logoSize = qrImage.Width / 5;
    int x = (qrImage.Width - logoSize) / 2;
    int y = (qrImage.Height - logoSize) / 2;
    g.DrawImage(logo, x, y, logoSize, logoSize);
}

qrImage.Save("product-qr.png");

Imports OnBarcode.Barcode
Imports System.Drawing

Dim qr As New QRCode()
qr.Data = "https://example.com/product/4891"
qr.QRCodeDataMode = QRCodeDataMode.Auto
qr.QRCodeECL = QRCodeECL.H ' H-level error correction required for logo overlay

Dim qrImage As Image = qr.drawBarcode()

Using g As Graphics = Graphics.FromImage(qrImage)
    Dim logo As Image = Image.FromFile("brand-logo.png")
    Dim logoSize As Integer = qrImage.Width \ 5
    Dim x As Integer = (qrImage.Width - logoSize) \ 2
    Dim y As Integer = (qrImage.Height - logoSize) \ 2
    g.DrawImage(logo, x, y, logoSize, logoSize)
End Using

qrImage.Save("product-qr.png")

Abordagem do IronBarcode:

using IronBarCode;

var qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500);
qr.SaveAsPng("product-qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500);
qr.SaveAsPng("product-qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/4891", "brand-logo.png", 500)
qr.SaveAsPng("product-qr.png")

O nível de correção de erros, o cálculo do tamanho do logotipo e a composição da imagem são tratados internamente. Nenhuma dependência System.Drawing é necessária.

Leitura de códigos de barras a partir de uma imagem

A leitura de um arquivo de imagem ilustra a consolidação do produto com maior clareza. Com o OnBarcode, a leitura requer o SDK Reader separado, uma chamada de licença separada e a especificação explícita do formato. Com o IronBarcode, trata-se de uma única chamada estática usando o mesmo pacote e a mesma chave já configurada.

Abordagem OnBarcode:

using OnBarcode.Barcode;

//OnBarcodereader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };
string[] results = scanner.Scan("received-label.png");

foreach (string value in results)
    Console.WriteLine(value);

using OnBarcode.Barcode;

//OnBarcodereader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };
string[] results = scanner.Scan("received-label.png");

foreach (string value in results)
    Console.WriteLine(value);

Imports OnBarcode.Barcode

' OnBarcodereader is distributed as a pre-licensed DLL — no runtime SetLicense() call.
Dim scanner As New BarcodeScanner()
scanner.BarcodeTypes = New BarcodeType() {BarcodeType.Code128, BarcodeType.QRCode}
Dim results As String() = scanner.Scan("received-label.png")

For Each value As String In results
    Console.WriteLine(value)
Next

Abordagem do IronBarcode:

using IronBarCode;

var results = BarcodeReader.Read("received-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

using IronBarCode;

var results = BarcodeReader.Read("received-label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

Imports IronBarCode

Dim results = BarcodeReader.Read("received-label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Sem criação de instâncias, sem matriz de formato, sem configuração de licença separada. O formato é detectado automaticamente. Cada resultado contém o valor decodificado e o formato detectado. Para obter detalhes sobre as opções de leitura e os tipos de imagem suportados, consulte o guia sobre como ler códigos de barras em imagens .

Leitura de códigos de barras em um PDF

Este exemplo de migração aplica-se a equipes que renderizavam páginas PDF em imagens usando uma biblioteca de terceiros antes de passar essas imagens para o SDK doOnBarcodeReader.

Abordagem OnBarcode:

//OnBarcodehas no native PDF support.
// A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
var pageImages = RenderPdfPagesToImages("invoices.pdf"); // external library call

using OnBarcode.Barcode;
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };

foreach (var pageImage in pageImages)
{
    string[] results = scanner.Scan(pageImage);
    foreach (string value in results)
        Console.WriteLine(value);
}

//OnBarcodehas no native PDF support.
// A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
var pageImages = RenderPdfPagesToImages("invoices.pdf"); // external library call

using OnBarcode.Barcode;
BarcodeScanner scanner = new BarcodeScanner();
scanner.BarcodeTypes = new BarcodeType[] { BarcodeType.Code128, BarcodeType.QRCode };

foreach (var pageImage in pageImages)
{
    string[] results = scanner.Scan(pageImage);
    foreach (string value in results)
        Console.WriteLine(value);
}

Imports OnBarcode.Barcode

' OnBarcode has no native PDF support.
' A separate PDF rendering library was required — for example PdfiumViewer or Aspose.PDF.
Dim pageImages = RenderPdfPagesToImages("invoices.pdf") ' external library call

Dim scanner As New BarcodeScanner()
scanner.BarcodeTypes = New BarcodeType() {BarcodeType.Code128, BarcodeType.QRCode}

For Each pageImage In pageImages
    Dim results As String() = scanner.Scan(pageImage)
    For Each value As String In results
        Console.WriteLine(value)
    Next
Next

Abordagem do IronBarcode:

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}");

using IronBarCode;

var results = BarcodeReader.Read("invoices.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}");

Imports IronBarCode

Dim results = BarcodeReader.Read("invoices.pdf")
For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Format} — {result.Value}")
Next

Sem etapa de renderização, sem biblioteca PDF externa, sem matriz de formato. A funcionalidade de leitura de código de barras em PDF processa todas as páginas automaticamente e inclui o número da página em cada resultado.

Geração em lote

A geração de códigos de barras para uma coleção de itens segue o mesmo padrão de diferenciação que a geração de um único item.

Abordagem OnBarcode:

using OnBarcode.Barcode;

foreach (var item in inventoryItems)
{
    Linear barcode = new Linear();
    barcode.Type = BarcodeType.CODE128;
    barcode.Data = item.Sku;
    barcode.Resolution = 96;
    barcode.BarWidth = 1;
    barcode.BarHeight = 80;
    barcode.ShowText = true;
    barcode.drawBarcode($"labels/{item.Id}.png");
}

using OnBarcode.Barcode;

foreach (var item in inventoryItems)
{
    Linear barcode = new Linear();
    barcode.Type = BarcodeType.CODE128;
    barcode.Data = item.Sku;
    barcode.Resolution = 96;
    barcode.BarWidth = 1;
    barcode.BarHeight = 80;
    barcode.ShowText = true;
    barcode.drawBarcode($"labels/{item.Id}.png");
}

Imports OnBarcode.Barcode

For Each item In inventoryItems
    Dim barcode As New Linear()
    barcode.Type = BarcodeType.CODE128
    barcode.Data = item.Sku
    barcode.Resolution = 96
    barcode.BarWidth = 1
    barcode.BarHeight = 80
    barcode.ShowText = True
    barcode.drawBarcode($"labels/{item.Id}.png")
Next

Abordagem do IronBarcode:

using IronBarCode;

foreach (var item in inventoryItems)
{
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128)
        .SaveAsPng($"labels/{item.Id}.png");
}

using IronBarCode;

foreach (var item in inventoryItems)
{
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128)
        .SaveAsPng($"labels/{item.Id}.png");
}

Imports IronBarCode

For Each item In inventoryItems
    BarcodeWriter.CreateBarcode(item.Sku, BarcodeEncoding.Code128) _
        .SaveAsPng($"labels/{item.Id}.png")
Next

Problema 1: Conflitos de referência de DLL

OnBarcode: Projetos na distribuição de DLL legada têm elementos <Reference> em .csproj apontando para lib\OnBarcode.Barcode.dll ou caminhos similares. Se a DLL antiga permanecer no disco quando o IronBarcode for adicionado, o compilador verá duas assemblies fornecendo os mesmos prefixos de namespace e produzirá erros de referência ambígua.

Solução: Remova o bloco de referência <ItemGroup> de .csproj antes de executar dotnet add package IronBarcode. Exclua os arquivos DLL do disco. Verifique, através de uma compilação limpa, se não restam referências de assembly obsoletas.

# Search for lingeringOnBarcodeDLL references in project files
grep -r "OnBarcode" --include="*.csproj" .
grep -r "OnBarcode" --include="*.props" .

# Search for lingeringOnBarcodeDLL references in project files
grep -r "OnBarcode" --include="*.csproj" .
grep -r "OnBarcode" --include="*.props" .

Issue 2: Conflitos de Nome de Tipo Durante a Migração Faseada

OnBarcode: O namespace do leitor exporta uma classe chamada BarcodeScanner.IronBarcode tem uma classe estática chamada BarcodeReader. Esses nomes não entram em conflito diretamente, mas qualquer arquivo que importe simultaneamente OnBarcode.Barcode.Reader e IronBarCode pode ver ambiguidade de enum BarcodeType —OnBarcodedefine BarcodeType para sua seleção de formato, e IronBarcode usa BarcodeEncoding. Manter ambos os namespaces ativos durante a migração resultará em erros de compilação em qualquer referência BarcodeType.

Solução: Complete a migração de cada arquivo atomicamente — remova a diretiva using OnBarcode.Barcode.Reader e adicione using IronBarCode na mesma edição. Não deixe ambas as diretivas using presentes em nenhum arquivo. Se uma abordagem gradual for necessária, use nomes totalmente qualificados temporariamente:

// Temporary disambiguation during phased migration
var results = IronBarCode.BarcodeReader.Read("file.png");

// Temporary disambiguation during phased migration
var results = IronBarCode.BarcodeReader.Read("file.png");

' Temporary disambiguation during phased migration
Dim results = IronBarCode.BarcodeReader.Read("file.png")

Problema 3: Remoção da matriz BarcodeType

OnBarcode: O leitor requer reader.BarcodeTypes = new BarcodeType[] { ... } para funcionar. Os desenvolvedores que migram o código do leitor às vezes têm o hábito de especificar formatos explicitamente e procuram uma configuração equivalente no IronBarcode.

Solução: Remova completamente a especificação de formato. BarcodeReader.Read realiza detecção automática em todos os formatos suportados. Nenhuma configuração é necessária, e não existe equivalente de BarcodeType[] no IronBarcode porque não é necessário.

// No format configuration required
var results = BarcodeReader.Read("label.png");

// No format configuration required
var results = BarcodeReader.Read("label.png");

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

Tarefas pré-migração

Antes de fazer alterações, faça uma auditoria no código-fonte para localizar todos os usos de OnBarcode:

# Find allOnBarcodenamespace imports
grep -rn "using OnBarcode" --include="*.cs" .

# Find all license configuration calls
grep -rn "SetLicense" --include="*.cs" .

# Find all generator usage
grep -rn "new Linear\|new QRCode\|drawBarcode\|BarcodeType\." --include="*.cs" .

# Find all reader usage
grep -rn "BarcodeScanner\|\.Scan(\|BarcodeType\[\]" --include="*.cs" .

# Find DLL references in project files
grep -rn "OnBarcode" --include="*.csproj" .
grep -rn "OnBarcode" --include="*.sln" .

# Find allOnBarcodenamespace imports
grep -rn "using OnBarcode" --include="*.cs" .

# Find all license configuration calls
grep -rn "SetLicense" --include="*.cs" .

# Find all generator usage
grep -rn "new Linear\|new QRCode\|drawBarcode\|BarcodeType\." --include="*.cs" .

# Find all reader usage
grep -rn "BarcodeScanner\|\.Scan(\|BarcodeType\[\]" --include="*.cs" .

# Find DLL references in project files
grep -rn "OnBarcode" --include="*.csproj" .
grep -rn "OnBarcode" --include="*.sln" .

Documente quais arquivos usam apenas geração, quais usam apenas leitura e quais usam ambas. Observe quaisquer arquivos que incluam o bloco DLL <Reference> manual em vez de uma referência ao pacote NuGet.

Tarefas de atualização de código

1. Remova o pacote NuGet OnBarcode.Barcode.Generator
2. Remova o pacote NuGet OnBarcode.Barcode.Reader
3. Remova qualquer entrada DLL manual <Reference> de arquivos .csproj
4. Exclua os arquivos DLLOnBarcodedo repositório.
5. Execute dotnet add package IronBarcode
6. Substitua using OnBarcode.Barcode por using IronBarCode em cada arquivo
7. Substitua using OnBarcode.Barcode.Reader por using IronBarCode em cada arquivo
8. Remova ambas as entradas de DLL <Reference> doOnBarcode(gerador e leitor) — não há chamadas de licença de tempo de execução para substituir
9. Adicione IronBarCode.License.LicenseKey = "YOUR-KEY" uma vez na inicialização da aplicação
10. Converta cada new Linear() ou new QRCode() + bloco de atribuição de propriedade para BarcodeWriter.CreateBarcode(data, encoding)
11. Substitua barcode.drawBarcode("file.png") por .SaveAsPng("file.png") (ou método de formato apropriado)
12. Substitua new BarcodeScanner() { BarcodeTypes = [...] } + .Scan(path) por BarcodeReader.Read(path)
13. Atualize o tratamento de resultados de indexação string[] para result.Value e result.Format em BarcodeResults
14. Remova qualquer código de renderização de PDF para imagem usado para contornar a limitação de PDF do OnBarcode.
15. Substitua renderização de PDF em múltiplas etapas + loops de digitalização por uma única chamada BarcodeReader.Read("file.pdf")

Testes pós-migração

• Verificar se cada tipo de código de barras usado no projeto (Code 128, QR, EAN, Data Matrix, PDF417) gera uma saída legível por scanner.
• Escaneie os códigos de barras gerados com um leitor físico ou dispositivo móvel para confirmar a legibilidade.
• Verificar se a leitura do código de barras retorna os valores corretos para as imagens de teste conhecidas.
• Confirme se a leitura de PDF retorna valores corretos e números de página corretos para documentos de teste com várias páginas. Execute a aplicação em qualquer ambiente de CI para confirmar se a configuração da chave de licença funciona corretamente no pipeline.
• Verifique se nenhuma string OnBarcode permanece em .cs, .csproj ou arquivos de configuração após a migração estar completa