A arquitetura de licenciamento baseada em arquivos

A inicialização do LEADTOOLS requer aproximadamente 20 linhas de código antes que a primeira operação de leitura de código de barras possa ser executada. A sequência abrange a resolução do caminho do arquivo, a verificação de expiração e a verificação de bloqueio por recurso:

using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

RasterSupport.SetLicense("C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC", "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

Este bloco de inicialização deve ser executado com sucesso antes que qualquer operação de leitura ou gravação de código de barras funcione. Se o arquivo .LIC estiver ausente, o caminho estiver incorreto ou as permissões de arquivo estiverem erradas, a inicialização da licença falhará e será apresentada como uma exceção na inicialização.

Comparação Detalhada de Recursos

Abordagem LEADTOOLS

O licenciamento LEADTOOLS requer um arquivo .LIC presente fisicamente no sistema de arquivos em um caminho conhecido, além de uma string de chave de desenvolvedor passada para RasterSupport.SetLicense. Depois de chamar SetLicense, a aplicação deve verificar se a licença não expirou e se cada recurso de código de barras está desbloqueado individualmente. Só após todas as verificações serem aprovadas é que um BarcodeEngine pode ser criado:

using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

using Leadtools;
using Leadtools.Barcode;

RasterSupport.SetLicense(
    @"C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here");

if (RasterSupport.KernelExpired)
    throw new InvalidOperationException("LEADTOOLS license has expired");

if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

RasterSupport.SetLicense("C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC", "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

Este modelo baseado em arquivos é anterior aos modernos sistemas de gerenciamento de segredos. O arquivo .LIC deve ser provisionado em todo ambiente onde a aplicação é executada: máquinas de desenvolvedores, agentes de build CI, servidores de staging e hosts de produção.

Abordagem do IronBarcode

A inicialização da licença do IronBarcode consiste em uma única linha:

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

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

Imports IronBarCode

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

Essa chave pode vir de uma variável de ambiente, um arquivo de configuração ou um gerenciador de segredos — de qualquer lugar de onde uma string possa vir. Não há arquivo para localizar, nenhuma verificação de expiração para gravar e nenhum bloqueio de recurso para verificar. Para configuração e opções de implantação de licença, a documentação cobre todos os padrões: variáveis de ambiente, appsettings.json, Azure Key Vault, e mais.

Abordagem LEADTOOLS

A implantação Docker do LEADTOOLS requer copiar o arquivo .LIC na imagem do contêiner ou montá-lo como um volume em tempo de execução:

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

# The license file must be physically present in the container
COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC

ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
ENV LEADTOOLS_DEVELOPER_KEY=your-developer-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

Essa abordagem acarreta complicações posteriores. A rotação ou revogação de uma chave de licença requer a reconstrução da imagem ou a remontagem do volume. O pipeline CI/CD deve verificar o arquivo .LIC ou decodificá-lo de um segredo em base64 no tempo de construção. Segredos do Kubernetes projetados para pares de string chave-valor agora precisam armazenar conteúdo de arquivo. As equipes que executam contêineres efêmeros precisam resolver o problema de provisionamento de arquivos em cada novo nó.

Abordagem do IronBarcode

IronBarcode não requer nenhum arquivo no contêiner:

FROM mcr.microsoft.com/dotnet/aspnet:8.0

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

ENTRYPOINT ["dotnet", "YourApp.dll"]

O modelo de variáveis ​​de ambiente funciona nativamente com segredos do Docker, segredos do Kubernetes, AWS Secrets Manager, Azure Key Vault e HashiCorp Vault — qualquer sistema que possa injetar uma string no ambiente de um contêiner. Existe um guia completo de implantação do Docker e do Linux que abrange imagens base Alpine e Debian.

Abordagem LEADTOOLS

A leitura LEADTOOLS requer criar uma instância RasterCodecs para carregar a imagem, uma instância BarcodeEngine para escaneá-la, e um array explícito de valores BarcodeSymbology especificando quais formatos procurar. Omitir uma simbologia da matriz significa que o LEADTOOLS não detectará códigos de barras desse tipo:

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

return barcodes.Select(b => b.Value).ToArray();

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

using var codecs = new RasterCodecs();
using var image = codecs.Load(imagePath);
var engine = new BarcodeEngine();

var symbologies = new[]
{
    BarcodeSymbology.Code128,
    BarcodeSymbology.QR,
    BarcodeSymbology.DataMatrix,
    BarcodeSymbology.EAN13,
    BarcodeSymbology.UPCA
};

var barcodes = engine.Reader.ReadBarcodes(
    image,
    LogicalRectangle.Empty,
    0,
    symbologies);

return barcodes.Select(b => b.Value).ToArray();

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim barcodes As BarcodeData()

Using codecs As New RasterCodecs()
    Using image As RasterImage = codecs.Load(imagePath)
        Dim engine As New BarcodeEngine()

        Dim symbologies As BarcodeSymbology() = {
            BarcodeSymbology.Code128,
            BarcodeSymbology.QR,
            BarcodeSymbology.DataMatrix,
            BarcodeSymbology.EAN13,
            BarcodeSymbology.UPCA
        }

        barcodes = engine.Reader.ReadBarcodes(
            image,
            LogicalRectangle.Empty,
            0,
            symbologies)
    End Using
End Using

Return barcodes.Select(Function(b) b.Value).ToArray()

Abordagem do IronBarcode

O IronBarcode detecta automaticamente os formatos em todas as mais de 50 simbologias suportadas. O caminho do arquivo é passado diretamente; Não é necessária nenhuma camada de carregamento de imagem ou matriz de simbologia:

using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

using IronBarCode;

var results = BarcodeReader.Read(imagePath);
return results.Select(r => r.Value).ToArray();

Imports IronBarCode

Dim results = BarcodeReader.Read(imagePath)
Return results.Select(Function(r) r.Value).ToArray()

Para obter mais detalhes sobre opções de leitura, ajuste de velocidade versus precisão e tratamento de imagens complexas, o guia de leitura de códigos de barras a partir de imagens abrange toda a API.

Abordagem LEADTOOLS

A geração de código de barras LEADTOOLS requer criar um objeto BarcodeData com simbologia, valor e limites — depois criar um RasterImage em branco com dimensões de pixel explícitas, profundidade de bits, ordem de byte e perspectiva de visualização — depois preenchê-lo com um fundo branco usando FillCommand — depois chamar engine.Writer.WriteBarcode() — e depois salvar com RasterCodecs. São cinco operações distintas em vários tipos de objetos:

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, outputPath, RasterImageFormat.Png, 0);

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData(BarcodeSymbology.Code128)
{
    Value = data,
    Bounds = new LeadRect(0, 0, 400, 100)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    400, 100, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    null, IntPtr.Zero, 0);

new FillCommand(RasterColor.White).Run(image);
engine.Writer.WriteBarcode(image, barcodeData, null);

using var codecs = new RasterCodecs();
codecs.Save(image, outputPath, RasterImageFormat.Png, 0);

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim barcodeData As New BarcodeData(BarcodeSymbology.Code128) With {
    .Value = data,
    .Bounds = New LeadRect(0, 0, 400, 100)
}

Using image As New RasterImage(RasterMemoryFlags.Conventional, 400, 100, 24, RasterByteOrder.Bgr, RasterViewPerspective.TopLeft, Nothing, IntPtr.Zero, 0)
    Dim fillCommand As New FillCommand(RasterColor.White)
    fillCommand.Run(image)
    engine.Writer.WriteBarcode(image, barcodeData, Nothing)

    Using codecs As New RasterCodecs()
        codecs.Save(image, outputPath, RasterImageFormat.Png, 0)
    End Using
End Using

Abordagem do IronBarcode

O IronBarcode gerencia internamente a criação de imagens, o preenchimento de fundo e a codificação:

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng(outputPath)

Para a criação de imagens de código de barras , a API IronBarcode expõe estilos, margens, rotação e conversão de formato por meio de uma cadeia fluente, em vez de uma série de objetos de configuração imperativos.

Implantação de contêineres e nuvem

Equipes que migram cargas de trabalho para Docker, Kubernetes ou ambientes sem servidor se deparam com o modelo de licenciamento baseado em arquivos como um problema operacional concreto. Cada nova instância de contêiner, cada nova região da nuvem, e cada novo ambiente deve ter o arquivo .LIC provisionado e acessível antes que a aplicação inicie. Sistemas de gerenciamento de segredos projetados para segredos com valores de string não se adaptam bem a artefatos baseados em arquivos. As equipes que padronizaram a injeção de variáveis ​​de ambiente para configuração descobrem que o LEADTOOLS exige uma etapa de provisionamento separada, que fica fora de seu fluxo de trabalho normal de segredos. Quando o volume de implantações aumenta — escalonamento automático, implantação azul-verde, replicação multirregional — o custo operacional do provisionamento de arquivos aumenta na mesma proporção.

Gerenciamento de dependências e presença do SDK

Quando a leitura ou geração de código de barras é o requisito principal ou único de um serviço, a instalação do LEADTOOLS, composto por cinco pacotes, e a dependência do MSVC++ 2017 Runtime representam uma sobrecarga que afeta o tamanho da imagem do contêiner, a latência de inicialização a frio em funções sem servidor e os tempos de compilação em pipelines de CI/CD. Equipes que desenvolvem microsserviços leves ou funções no estilo Lambda descobrem que a inclusão de um SDK de imagens completo para atender a uma necessidade específica de código de barras cria uma superfície de dependência difícil de justificar em revisões de código e arquitetura. Quando uma futura atualização da plataforma exigir o teste de uma alteração na dependência de tempo de execução nativa, essa tarefa ficará a cargo da equipe que mantém o serviço.

Transparência de preços

As equipes de desenvolvimento que precisam orçar um projeto antes de iniciá-lo não conseguem obter uma visão completa dos custos a partir dos preços publicados pela LEADTOOLS. As licenças de desenvolvimento começam em aproximadamente $1,469 por desenvolvedor por ano, mas as licenças de implantação em produção para aplicações de servidor são cotadas separadamente através de vendas. Uma equipe de cinco desenvolvedores que precisa implementar soluções em três servidores de produção deve obter um orçamento personalizado antes de confirmar se o LEADTOOLS se encaixa em seu orçamento. Equipes que preferem tomar decisões de compras com base em preços publicados — comparando opções, obtendo aprovação interna ou planejando orçamentos plurianuais — descobrem que esse modelo exige uma conversa com a equipe de vendas antes que a avaliação seja concluída.

Requisitos que exigem apenas código de barras

Aplicações que precisam ler ou gerar códigos de barras sem exigir OCR, imagens DICOM, anotação de documentos ou outros recursos do Suite LEADTOOLS estão pagando por uma plataforma mais abrangente do que suas necessidades exigem. O valor de integração do LEADTOOLS — a capacidade de transferir dados entre seus módulos de OCR, código de barras e processamento de documentos — é real, mas só se aplica quando várias funcionalidades desse Suite estão em uso ativo. Quando a necessidade se limita à leitura de códigos de barras em uma API da web ou à geração em um fluxo de processamento de documentos, uma biblioteca de códigos de barras específica atende diretamente à necessidade, sem a complexidade de uma plataforma de imagens abrangente.

Substituição de inicialização de licença

Todo o bloco de inicialização do LEADTOOLS — caminho do arquivo, verificação de expiração e verificação de bloqueio por recurso — é substituído por uma única linha. A chave de licença do IronBarcode pode ser armazenada em qualquer sistema de gerenciamento de segredos que armazene strings.

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

// Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

' Replace the entire LEADTOOLS initialization block with:
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE")

Padrão de variável de ambiente do Docker

A linha COPY LEADTOOLS.LIC em qualquer Dockerfile é removida inteiramente. A licença é fornecida por meio de uma variável de ambiente em tempo de execução, que funciona com todos os mecanismos padrão de injeção de segredos:

# Remove: COPY LEADTOOLS.LIC /app/license/LEADTOOLS.LIC
# Remove: ENV LEADTOOLS_LICENSE_PATH=/app/license/LEADTOOLS.LIC
# Add:
ENV IRONBARCODE_LICENSE=your-license-key

Remoção de Pacotes

Os cinco pacotes LEADTOOLS — e o codec PDF opcional — foram removidos e substituídos por um único pacote:

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package BarCode

dotnet remove package Leadtools.Barcode
dotnet remove package Leadtools
dotnet remove package Leadtools.Codecs
dotnet remove package Leadtools.Codecs.Png
dotnet remove package Leadtools.Codecs.Jpeg
# If added:
dotnet remove package Leadtools.Codecs.Pdf

dotnet add package BarCode