A arquitetura do SDK dividido

Um projeto que adquire ambos os SDKs Neodynamic deve configurar dois blocos de licença separados na inicialização. As atribuições duplas LicenseOwner e LicenseKey usam diferentes namespaces e nomes de classe diferentes, e nenhum bloco está ciente do outro:

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

// Neodynamic: two products, two license configurations
using Neodynamic.SDK.Barcode;
using Neodynamic.SDK.BarcodeReader;

// Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company";
BarcodeProfessional.LicenseKey = "GEN-KEY";

// Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company";
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY";

Imports Neodynamic.SDK.Barcode
Imports Neodynamic.SDK.BarcodeReader

' Neodynamic: two products, two license configurations

' Generation license (Barcode Professional SDK)
BarcodeProfessional.LicenseOwner = "Company"
BarcodeProfessional.LicenseKey = "GEN-KEY"

' Reader license — separate purchase, separate key
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseOwner = "Company"
Neodynamic.SDK.BarcodeReader.BarcodeReader.LicenseKey = "READ-KEY"

Esse padrão se repete em todos os ambientes — desenvolvimento, teste e produção — e deve ser mantido sempre que qualquer um dos produtos for atualizado ou renovado.

Comparação Detalhada de Recursos

Abordagem Neodinâmica para Leitor de Código de Barras

O leitor de código de barras Neodynamic suporta apenas códigos de barras lineares. Quando um código de barras 2D é enviado ao leitor, o SDK retorna um conjunto de resultados vazio ou nulo. Nenhuma exceção é lançada e nenhuma mensagem de erro indica o que aconteceu. As equipes que trabalham com este SDK normalmente descobrem a limitação após implantar um código que chama o leitor para imagens de código QR e observar que a coleção de resultados está sempre vazia.

Um padrão defensivo comum em bases de código que utilizam o Neodynamic Reader é uma verificação explícita que gera uma exceção quando um formato 2D é esperado:

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.Read(bitmap);

    // Results will be null or empty — QR codes are not recognised by this SDK
    if (results == null || !results.Any())
    {
        throw new NotSupportedException(
            "Neodynamic Barcode Reader does not support QR codes");
    }

    return results.First().Value;
}

Imports Neodynamic.SDK.BarcodeReader
Imports System.Drawing

Public Function ReadQrCode(imagePath As String) As String
    Using bitmap As New Bitmap(imagePath)
        Dim reader As New BarcodeReader()
        Dim results = reader.Read(bitmap)

        ' Results will be null or empty — QR codes are not recognised by this SDK
        If results Is Nothing OrElse Not results.Any() Then
            Throw New NotSupportedException("Neodynamic Barcode Reader does not support QR codes")
        End If

        Return results.First().Value
    End Using
End Function

Este método não pode ser concluído apenas com o SDK do Neodynamic Reader. O NotSupportedException não é uma solução alternativa — ele reflete o limite de capacidade real do leitor para entrada 2D.

Abordagem do IronBarcode

IronBarcode lê todas as simbologias suportadas através da mesma chamada BarcodeReader.Read(). O formato é detectado automaticamente a partir do conteúdo da imagem. Um código QR, um código Code 128 e um código de barras DataMatrix usam o mesmo código de chamada:

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

using IronBarCode;

public string ReadQrCode(string imagePath)
{
    // QR codes, DataMatrix, PDF417 — all handled automatically
    var result = BarcodeReader.Read(imagePath).FirstOrDefault();
    return result?.Value;
}

Imports IronBarCode

Public Function ReadQrCode(imagePath As String) As String
    ' QR codes, DataMatrix, PDF417 — all handled automatically
    Dim result = BarcodeReader.Read(imagePath).FirstOrDefault()
    Return If(result?.Value, Nothing)
End Function

Quem fez a chamada não especificou um formato esperado. O IronBarcode identifica a simbologia e retorna o valor. Para obter detalhes completos sobre as opções de leitura de imagens, incluindo detecção de múltiplos códigos de barras e pré-processamento de imagens, consulte o guia de leitura de códigos de barras a partir de imagens .

Abordagem Professional de código de barras neodinâmico

A API de geração do Neodynamic é baseada em instâncias. Um objeto BarcodeProfessional é construído, suas propriedades são atribuídas individualmente, e GetBarcodeImage() é chamado para retornar um System.Drawing.Image. A imagem é então salva usando a enumeração System.Drawing.Imaging.ImageFormat:

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

using Neodynamic.SDK.Barcode;

// Configure license first
BarcodeProfessional.LicenseOwner = "Your Company";
BarcodeProfessional.LicenseKey = "YOUR-KEY";

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

// Get image and save via System.Drawing
System.Drawing.Image image = barcode.GetBarcodeImage();
image.Save("output.png", System.Drawing.Imaging.ImageFormat.Png);

Imports Neodynamic.SDK.Barcode
Imports System.Drawing

' Configure license first
BarcodeProfessional.LicenseOwner = "Your Company"
BarcodeProfessional.LicenseKey = "YOUR-KEY"

' Build the barcode through property assignment
Dim barcode As New BarcodeProfessional()
barcode.Code = "12345678"
barcode.Symbology = Symbology.Code128
barcode.BarcodeUnit = BarcodeUnit.Pixel

' Get image and save via System.Drawing
Dim image As Image = barcode.GetBarcodeImage()
image.Save("output.png", Imaging.ImageFormat.Png)

O SDK oferece opções legítimas de personalização, incluindo controle de DPI, alinhamento de texto, configurações de cores e dimensionamento da zona silenciosa. São úteis para fluxos de trabalho de impressão onde as dimensões físicas precisas são importantes. A capacidade de geração em si está completa; As limitações que motivam a migração estão no lado da leitura, não no lado da geração.

Abordagem do IronBarcode

IronBarcode utiliza uma abordagem estática fluente. A codificação e os dados são passados como parâmetros para BarcodeWriter.CreateBarcode(), e o formato de saída é expresso como um nome de método no objeto retornado. Não é necessária a importação de System.Drawing:

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("output.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("output.png")

Para a geração de códigos de barras 2D, a classe dedicada QRCodeWriter oferece opções adicionais específicas para códigos QR:

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .SaveAsPng("qrcode.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .SaveAsPng("qrcode.png")

Para obter orientações sobre como gerar simbologias 1D com opções de dimensionamento e anotação, consulte o guia de criação de códigos de barras 1D . Para a criação de códigos de barras 2D, incluindo DataMatrix e PDF417, consulte o guia de criação de códigos de barras 2D .

Abordagem Neodinâmica

A funcionalidade de código de barras da Neodynamic está dividida em dois produtos licenciados separadamente. O SDK Barcode Professional abrange a geração de código de barras e o SDK Barcode Reader abrange a leitura. Cada produto requer uma compra separada e possui uma chave de licença individual. Uma equipe que adquire ambos os produtos deve manter dois blocos de configuração LicenseOwner / LicenseKey, acompanhar duas datas de renovação separadas e lidar com dois canais de suporte separados quando surgirem problemas.

O SDK Barcode Professional tem preços a partir de aproximadamente $352 por uma licença de desenvolvedor único na edição Básica e a partir de aproximadamente $705 na edição Ultimate (licenças de desenvolvedor via ComponentSource). O SDK Barcode Reader tem um custo separado e é fornecido sob preços legados — o produto foi marcado como fim de serviço em 31 de dezembro de 2019. Um projeto que requer leitura 2D não pode atender a esse requisito com produtos da Neodynamic a qualquer preço; uma terceira biblioteca deve ser adicionada. Consulte a página de formatos de código de barras suportados IronBarcode para obter uma lista completa do que uma única licença unificada cobre.

Abordagem do IronBarcode

O IronBarcode é vendido como um produto único que abrange todas as operações de código de barras — geração e leitura em todas as simbologias suportadas — sob uma única chave de licença. Não há licença de leitor separada, nem licença de gerador separada, e o suporte ao formato 2D não tem custo adicional. A chave de licença é definida uma única vez na inicialização do aplicativo e não requer nenhuma configuração adicional:

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

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

Imports IronBarCode

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

O IronBarcode Lite custa US$ 749 para um único desenvolvedor e abrange o conjunto completo de recursos. Para informações sobre preços e opções de volume atuais, consulte a página de licenciamento do IronBarcode .

Requisitos de leitura de código QR

O cenário mais comum que leva equipes da Neodynamic a migrarem para a IronBarcode é a descoberta de que os códigos QR gerados pelo SDK Barcode Professional não podem ser lidos pelo SDK Barcode Reader. As equipes que desenvolvem sistemas de etiquetagem de produtos, ferramentas de gestão de estoque ou fluxos de trabalho de rastreamento de documentos geralmente implementam a geração e a leitura como fases separadas de um sistema maior. Quando a geração é feita primeiro usando o Barcode Professional, a limitação do leitor só se torna aparente quando o componente de leitura é tentado. Nesse ponto, o projeto já havia se comprometido com o Neodynamic para geração de dados, e adicionar uma terceira biblioteca para cobrir a leitura 2D introduz uma complexidade de gerenciamento de versões que não existiria com um SDK unificado.

Reduzindo a complexidade do produto

Algumas equipes migram não por causa de uma diferença específica de formato, mas porque o custo de manter dois produtos separados para o que conceitualmente é uma única funcionalidade se torna um ponto de atrito recorrente. Dois pacotes no arquivo .csproj, dois ciclos de renovação de licença, dois conjuntos de notas de versão para revisar e duas potenciais fontes de incompatibilidade quando atualizações do .NET ou Windows são aplicadas — nada desse overhead entrega funcionalidade além do que um único pacote unificado proporcionaria. As equipes que fazem uma auditoria de dependência como parte de uma atualização do .NET frequentemente identificam o arranjo de pacotes duplos de Neodynamic como uma oportunidade de simplificação.

Processamento de código de barras PDF

Aplicações que processam documentos PDF contendo códigos de barras representam um cenário onde ambos os SDKs da Neodynamic apresentam deficiências simultaneamente. Nem o SDK de geração nem o SDK de leitura conseguem abrir um arquivo PDF e extrair os valores dos códigos de barras de suas páginas. As equipes que trabalham com manifestos de remessa, documentos de faturas, registros médicos ou qualquer fluxo de trabalho de documentos em que códigos de barras estejam incorporados em PDFs devem implementar uma etapa intermediária de extração de imagem antes que qualquer leitura possa ocorrer. Essa etapa de extração requer uma biblioteca adicional, o que significa que o projeto já possui uma terceira dependência para contornar uma limitação que uma única instalação do IronBarcode eliminaria.

Consistência de formatação entre leitura e escrita

Equipes que operam fluxos de trabalho com código de barras em grande escala às vezes descobrem que inconsistências no suporte de formato entre a geração e a leitura criam problemas de teste e validação. Quando um sistema gera códigos QR para uma finalidade e lê diferentes tipos de formato para outra, a divergência entre o que o gerador suporta e o que o leitor suporta cria lacunas nos testes de ida e volta. Um sistema onde a geração e a leitura compartilham a mesma biblioteca e a mesma lista de formatos suportados é mais simples de validar. A verificação de que um código de barras gerado pode ser lido com sucesso passa a ser uma operação de biblioteca única, em vez de um teste de integração de múltiplas bibliotecas.

Remoção de Pacote Duplo

Migrar do Neodynamic requer a remoção de ambos os pacotes NuGet: Neodynamic.SDK.Barcode e Neodynamic.SDK.BarcodeReader. Ambos devem ser removidos do arquivo .csproj e ambas as diretivas using correspondentes devem ser removidas dos arquivos de origem. Executar dotnet remove package para cada é suficiente; Não existem dependências compartilhadas entre os dois que exijam limpeza adicional.

Limpeza da configuração de licença dupla

Os dois blocos de configuração de licença — um para BarcodeProfessional e um para Neodynamic.SDK.BarcodeReader.BarcodeReader — são ambos substituídos por uma única atribuição IronBarCode.License.LicenseKey. Esta atribuição é feita uma vez na inicialização do aplicativo, tipicamente em Program.cs ou no bootstrap de injeção de dependência do aplicativo. Qualquer arquivo de configuração ou variável de ambiente que armazene chaves de licença Neodynamic pode ser desativado após a verificação da migração.

Remoção de exceção NotSupportedException

Bases de código que encontraram a limitação de leitura 2D durante o desenvolvimento frequentemente contêm métodos de espaço reservado que lançam NotSupportedException para leitura de códigos QR ou DataMatrix. Esses métodos não são soluções alternativas — são reconhecimentos honestos de que a capacidade não existia. Após a migração para o IronBarcode, cada corpo de método é substituído por uma chamada padrão BarcodeReader.Read(imagePath). Não é necessário nenhum cuidado especial; O formato é detectado automaticamente.