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 對象，包含明確的像素尺寸、位元深度、位元組順序和視圖透視 @最後使用 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 成像、文件註釋或 LEADTOOLS 套件中的其他功能的應用程序，實際上是在為超出其需求範圍的平台付費。 LEADTOOLS 的整合價值——即在其 OCR、條碼和文件處理模組之間傳遞資料的能力——是真實存在的，但只有當該套件中的多個功能處於活躍使用狀態時，它才能發揮作用。 當需求僅限於在 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