LEADTOOLS 条形码库与 IronBarcode 对比：C# 条形码库比较

基于文件的许可架构

LEADTOOLS 初始化大约需要 20 行代码，然后才能执行第一个条形码操作。 该序列涵盖文件路径解析、过期验证和每个功能的锁定检查：

// LEADTOOLS: 20行以上 before the first barcode operation
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();

// LEADTOOLS: 20行以上 before the first barcode operation
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

' LEADTOOLS: 20行以上 before the first barcode operation

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()

此初始化块必须成功执行，任何条形码读取或写入操作才能生效。 如果 .LIC 文件不存在、路径不正确或文件权限错误，LEADTOOLS 将不会初始化——不会静默地停止，而是会报错导致操作停止。

详细功能对比

LEADTOOLS 方法

LEADTOOLS 许可要求文件系统中已知路径上存在一个 .LIC 文件，以及一个传递给 RasterSupport.SetLicense 的开发者密钥字符串。 调用 SetLicense 后，应用程序必须验证许可证是否已过期，并且每个条形码功能是否已单独解锁。 只有所有检查都通过后，才能创建 BarcodeEngine：

// LEADTOOLS: 20行以上 before the first barcode operation
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();

// LEADTOOLS: 20行以上 before the first barcode operation
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

' LEADTOOLS: 20行以上 before the first barcode operation

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()

这种基于文件的模型早于现代密钥管理系统。 必须在应用程序运行的每个环境中配置 .LIC 文件：开发人员机器、CI 构建代理、暂存服务器和生产主机。

IronBarcode方法

IronBarcode 的许可证初始化代码只有一行：

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

// IronBarcode: done
IronBarCode.License.LicenseKey = "YOUR-KEY";

该密钥可以来自环境变量、配置文件或密钥管理器——任何可以产生字符串的地方。 无需查找文件，无需写入过期检查，也无需验证功能锁定。 对于许可证设置和部署选项，文档涵盖所有模式：环境变量、appsettings.json、Azure Key Vault 等。

LEADTOOLS 方法

LEADTOOLS Docker 部署需要将 .LIC 文件复制到容器镜像中，或者在运行时将其挂载为卷：

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"]

这种方法会带来后续的并发症。 轮换或撤销许可证密钥需要重建映像或重新挂载卷。 CI/CD 流水线必须检入 .LIC 文件，或者在构建时从 base64 编码的密钥中解码该文件。原本设计用于存储键值对的 Kubernetes 密钥现在需要存储文件内容。 运行临时容器的团队必须解决每个新节点上的文件配置问题。

IronBarcode方法

IronBarcode不需要容器内的任何文件：

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

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

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

环境变量模型原生支持 Docker secrets、Kubernetes secrets、AWS Secrets Manager、Azure Key Vault 和 HashiCorp Vault——任何可以将字符串注入容器环境的系统。 我们提供了一份完整的Docker 和 Linux 部署指南，涵盖 Alpine 和 Debian 基础镜像。

LEADTOOLS 方法

LEADTOOLS 读取需要创建一个 RasterCodecs 实例来加载图像，创建一个 BarcodeEngine 实例来扫描图像，以及一个 BarcodeSymbology 值的显式数组来指定要查找的格式。 如果数组中省略了某种条形码符号，则 LEADTOOLS 将无法检测到该类型的条形码：

// LEADTOOLS: codec, engine, explicit symbology list
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();

// LEADTOOLS: codec, engine, explicit symbology list
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 IEnumerable(Of 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()

IronBarcode方法

IronBarcode可自动检测所有 50 多种受支持的条码格式。 文件路径直接传递； 无需图像加载图层或符号系统数组：

// IronBarcode: auto-detect, no object setup
using IronBarCode;

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

// IronBarcode: auto-detect, no object setup
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()

有关读取选项、调整速度与准确性以及处理复杂图像的更多详细信息，请参阅《从图像读取条形码指南》，其中涵盖了完整的 API 接口。

LEADTOOLS 方法

LEADTOOLS 条码生成需要创建一个 BarcodeData 对象，包含符号体系、值和边界 — 然后创建一个空白的 RasterImage 对象，包含明确的像素尺寸、位深度、字节顺序和视图透视 — 然后使用 FillCommand 对象填充白色背景 — 然后调用 engine.Writer.WriteBarcode() 对象 — 最后使用 RasterCodecs 对象保存。 这是针对多种对象类型的五种不同操作：

// LEADTOOLS: 5 operations, 25岁以上 lines
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);

// LEADTOOLS: 5 operations, 25岁以上 lines
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

IronBarcode方法

IronBarcode在内部处理图像创建、背景填充和编码：

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

// IronBarcode: one method chain
BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng(outputPath);

Imports IronBarcode

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

IronBarcode API 在创建条形码图像时，通过流畅的链式调用而非一系列命令式设置对象来公开样式、边距、旋转和格式转换。

容器和云部署

将工作负载迁移到 Docker、Kubernetes 或无服务器环境的团队会遇到基于文件的许可模式这一具体的运营问题。 每个新的容器实例、每个新的云区域和每个新的环境都必须在应用程序启动之前配置并可访问 .LIC 文件。 为字符串值密钥设计的密钥管理系统无法很好地处理基于文件的密钥。 已经将环境变量注入作为配置标准的团队发现，LEADTOOLS 需要一个单独的配置步骤，该步骤存在于他们正常的密钥工作流程之外。 当部署规模增长时——自动扩展、蓝绿部署、多区域复制——文件配置的运营成本也会随之增长。

SDK 占用空间和依赖项管理

当条形码读取或生成是服务的主要或唯一要求时，五包 LEADTOOLS 安装和 MSVC++ 2017 运行时依赖项会带来开销，影响容器镜像大小、无服务器函数中的冷启动延迟以及 CI/CD 管道中的构建时间。 构建轻量级微服务或 Lambda 式函数的团队发现，引入完整的图像 SDK 来解决条形码的特定需求会造成依赖关系，这在代码审查和架构审查中很难得到证明。 当未来的平台升级需要测试原生运行时依赖项变更时，这项工作将由维护服务的团队负责。

定价透明度

开发团队需要在开始开发之前制定项目预算，但无法从 LEADTOOLS 公布的价格中获得完整的成本信息。 开发许可证的价格为每位开发人员每年 1,295 美元至 1,469 美元，但服务器应用程序的生产部署许可证需通过销售部门单独报价。 一个由五名开发人员组成的团队，需要向三个生产服务器交付产品，他们必须先获得定制报价，才能确认 LEADTOOLS 是否符合他们的预算。 喜欢根据公布的价格做出采购决策的团队（比较各种方案、获得内部批准或制定多年预算）发现，这种模式需要在评估完成之前进行销售对话。

仅条形码要求

需要读取或生成条形码但不需要 OCR、DICOM 成像、文档注释或 LEADTOOLSSuite中的其他功能的应用程序，实际上是在为超出其需求范围的平台付费。 LEADTOOLS 的集成价值——即在其 OCR、条形码和文档处理模块之间传递数据的能力——是真实存在的，但只有当该Suite中的多个功能处于活跃使用状态时，它才能发挥作用。 当需求仅限于在 Web API 中扫描条形码或在文档处理流程中生成条形码时，一个专注于条形码的库可以直接满足需求，而无需承担综合成像平台的负担。

许可证初始化替换

整个 LEADTOOLS 初始化块（包括文件路径、过期检查和每个功能的锁定验证）都被替换为一行代码IronBarcode许可证密钥可以存储在任何存储字符串的密钥管理系统中：

// 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")

Docker 环境变量模式

任何 Dockerfile 中的 COPY LEADTOOLS.LIC 行都将被完全删除。 许可证在运行时通过环境变量提供，可与所有标准密钥注入机制配合使用：

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

包裹移除

五个 LEADTOOLS 软件包（以及可选的 PDF 编解码器）被移除，并替换为一个单独的软件包：

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 IronBarcode

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 IronBarcode