IRONSOFTWAREHOME
IRONSUITE所有10個程式庫只需支付2個的價格
聯絡銷售
按公司
影片

從LEADTOOLS Barcode遷移到IronBarcode

Curtis Chau
Curtis Chau
Updated: 2026年8月1日

本指南涵蓋了從LEADTOOLS Barcode遷移到IronBarcode的完整過程，適用於.NET開發人員。 它涉及去除LEADTOOLS NuGet套件和一個本地執行時依賴，將基於文件的LEADTOOLS授權初始化序列替換為字串金鑰，以及將LEADTOOLS的讀寫模式翻譯為IronBarcode的靜態流暢API。 為每個主要遷移場景提供了程式碼範例，還包括API映射表、結構化檢查清單，以及在過渡期間可能出現的問題的指導。

為什麼從LEADTOOLS Barcode遷移

**基於文件的授權部署：**LEADTOOLS授權需要在每台執行應用程式的計算機上磁碟上有一個.LIC文件，並且在已知路徑下。 在開發者工作站、CI構建代理、預備伺服器和生產容器上都需要配置該文件，然後應用程式才能初始化。這與基於字串的秘密根本不同，其可以乾淨地融入到環境變數、秘密管理器和CI/CD管道配置中。 每新增一個部署拓撲環境——例如新的雲區域、新的Kubernetes節點池、新的開發者上船——都需要一步文件配置，而基於字串的授權則不需要。

**SDK足跡：**安裝LEADTOOLS條碼需要Leadtools.Barcode NuGet套件（它會拉取Leadtools.Codecs和相關依賴）。 PDF條碼提取會增加Leadtools.Pdf。 在Windows上，MSVC++ 2017執行時是一個單獨的本地依賴。 LEADTOOLS條碼應用程式的發布輸出大約是148 MB。 只需要條碼讀取或生成的應用程式也會承擔一個全面的影像平台的全部負擔——OCR 基礎結構、格式編解碼器架構和文件查看功能——無論是否使用這些功能。

**遺留API設計：**LEADTOOLS條碼操作要求在執行任何工作之前按特定順序構造多個物件。 讀取條碼需要一個BarcodeSymbology陣列來聲明要尋找的格式。 生成條碼需要構建一個RasterCodecs保存。 該API反映了其時代的設計模式。 IronBarcode通過靜態方法調用直接接受文件路徑來執行相同的操作。

**價格透明度：**LEADTOOLS的生產伺服器部署授權通過LEADTOOLS銷售單獨報價，並未在其網站上發布。需要在開發開始前得到完整成本預估的團隊必須先與銷售接洽，然後才能確認LEADTOOLS是否符合預算。 IronBarcode提供覆蓋開發和部署的永久一次性授權，無需單獨的生產許可。

基本問題

LEADTOOLS初始化序列在建立BarcodeEngine之前需要20多行和四個驗證步驟。 IronBarcode使用單個賦值替換整個序列：

// LEADTOOLS: file path, expiry check, three feature lock checks, engine creation
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();
// IronBarcode: one line, no file required
using IronBarCode;

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE");

##IronBarcodevsLEADTOOLSBarcode：功能比較

功能LEADTOOLS BarcodeIronBarcode
授權模型文件+開發者金鑰僅字串金鑰
需要的NuGet套件5+1
本地執行時依賴MSVC++ 2017 (Windows)None
發布輸出大小~148 MB~39 MB
支持的總符號數40+50+
自動檢測條碼格式有限是
PDF條碼提取需要單獨的包內建
機器學習錯誤更正否是
QR碼logo品牌化否是
Docker部署需要掛載文件環境變數
初始化程式碼20+行1行
API風格遺留物件圖靜態流暢
跨平台部分（本地依賴）完整（.NET Standard）
部署授權定價聯繫銷售（未公開）包含在永久購買中

快速開始：從LEADTOOLS Barcode遷移到IronBarcode

步驟1：移除LEADTOOLS套件

從項目中移除所有LEADTOOLS套件：

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
SHELL

如果PDF編解碼器已為從PDF文件中提取條碼而新增：

dotnet remove package Leadtools.Pdf
SHELL

在Windows Server部署中，遷移完成後可從提供腳本中移除MSVC++ 2017執行時。 IronBarcode在任何平台上都沒有本地運行時依賴。

步驟2：安裝 IronBarcode

dotnet add package IronBarcode
SHELL

這個單一套件包括所有圖像格式支持、本機PDF條碼提取、機器學習錯誤更正和所有50+支持的符號學。 不需要額外的編解碼器套件。

步驟3：初始化授權

用一行代替整個LEADTOOLS初始化區塊。找到程式碼庫中每個對RasterSupport.SetLicense的調用——通常只有一個，在應用啟動時——替換整個周圍的初始化序列：

// Before: entireLEADTOOLSinitialization block (20+ lines)
// After:
using IronBarCode;

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

授權金鑰可以從任何支持字串的配置機制中獲取：環境變數、appsettings.json、Azure Key Vault、AWS Secrets Manager或Kubernetes秘密。 對於基於環境的授權配置、Docker部署模式和所有支持的配置方法，請參見授權金鑰設置文件。

程式碼遷移範例

從圖像中讀取條碼

LEADTOOLS將圖像載入和條碼掃描分為兩個不同的对象層。 一個BarcodeEngine實例進行掃描。 調用者還必須提供一個明確的BarcodeSymbology陣列; 未在陣列中列出的格式將不被檢測。

LEADTOOLS方法：

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

using var codecs = new RasterCodecs();
using var image = codecs.Load("scan.png");

var engine = new BarcodeEngine();

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

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

foreach (var barcode in barcodes)
    Console.WriteLine($"{barcode.Symbology}: {barcode.Value}");

IronBarcode 方法：

using IronBarCode;

var results = BarcodeReader.Read("scan.png");

foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

IronBarcode直接接受文件路徑，內部載入圖像，並自動檢測所有50+支持的符號學的格式，而不要求調用者列舉預期型別。對於高級配置——閱讀速度調整、多條碼檢測和低質量圖像處理——請參閱從圖像中讀取條碼指南。

生成一個Code 128條碼

LEADTOOLS生成需要構建一個RasterCodecs保存。 IronBarcode通過單一流暢的方法鏈執行所有這些步驟。

LEADTOOLS方法：

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

var engine = new BarcodeEngine();

var barcodeData = new BarcodeData()
{
    Symbology = BarcodeSymbology.Code128,
    Value = "ITEM-98765",
    Bounds = new LeadRect(0, 0, 500, 120)
};

using var image = new RasterImage(
    RasterMemoryFlags.Conventional,
    500, 120, 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, "item-barcode.png", RasterImageFormat.Png, 0);

IronBarcode 方法：

using IronBarCode;

BarcodeWriter.CreateBarcode("ITEM-98765", BarcodeEncoding.Code128)
    .ResizeTo(500, 120)
    .SaveAsPng("item-barcode.png");

查看尺寸調整、樣式設置、邊距控制和支持的輸出格式的完整指南，請參見建立條碼圖像。

生成帶有Logo品牌的QR碼

LEADTOOLS QR碼生成遵循與其他條碼型別相同的多步AddBrandLogo方法，用於在QR碼的中心嵌入Logo。

LEADTOOLS方法：

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

var engine = new BarcodeEngine();

var qrData = new BarcodeData()
{
    Symbology = BarcodeSymbology.QR,
    Value = "https://example.com/product/12345",
    Bounds = new LeadRect(0, 0, 400, 400)
};

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

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

using var codecs = new RasterCodecs();
codecs.Save(image, "product-qr.png", RasterImageFormat.Png, 0);

IronBarcode 方法：

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/12345", 400, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("brand-logo.png")
    .SaveAsPng("product-qr.png");

從PDF文件中提取條碼

LEADTOOLS PDF條碼提取需要單獨的Leadtools.Pdf套件、明確的PDF載入配置、手動頁數查詢和每頁迴圈。 必須將每頁單獨載入為RasterImage才能掃描。 IronBarcode在基礎包中包括PDF支持，並內部處理頁面迭代。

LEADTOOLS方法：

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

// Requires: dotnet add package Leadtools.Pdf
using var codecs = new RasterCodecs();
codecs.Options.Pdf.Load.Resolution = 300;
codecs.Options.Pdf.Load.DisplayDepth = 24;

var engine = new BarcodeEngine();
var results = new List<string>();
int pageCount = codecs.GetTotalPages("shipment.pdf");

for (int page = 1; page <= pageCount; page++)
{
    using var image = codecs.Load(
        "shipment.pdf", 0,
        CodecsLoadByteOrder.BgrOrGray,
        page, page);

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

    foreach (var barcode in barcodes)
        results.Add($"Page {page}: {barcode.Value}");
}

IronBarcode 方法：

using IronBarCode;

var results = BarcodeReader.Read("shipment.pdf");

foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

Docker部署

當遷移到IronBarcode時，定義每個LEADTOOLS Docker部署的文件管理要求被完全消除。

LEADTOOLS方法：

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

WORKDIR /app
COPY publish/ .

# License file must be physically present in the container image
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"]
Text

IronBarcode 方法：

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

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

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

授權金鑰在容器運行時通過Docker秘密、Kubernetes秘密或任何環境變數機制注入。 不需要文件配置步驟。 Docker和Linux部署指南涵蓋Alpine和Debian基礎映像、多階段構建和Kubernetes部署模式。

##LEADTOOLS BarcodeAPI至IronBarcode映射參考

LEADTOOLSIronBarcode注意事項
RasterSupport.SetLicense(path, key)IronBarCode.License.LicenseKey = "key"僅金鑰——無需文件
RasterSupport.KernelExpired(removed)不需要到期檢查
RasterSupport.IsLocked(RasterSupportType.Barcode1DRead)(removed)所有功能均包括
RasterSupport.IsLocked(RasterSupportType.Barcode2DRead)(removed)所有功能均包括
RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)(removed)所有功能均包括
new BarcodeEngine()靜態——無需實例BarcodeReader, BarcodeWriter是靜態的
new RasterCodecs()(removed)直接傳遞文件路徑
codecs.Load(imagePath)(removed)直接傳遞文件路徑
engine.Reader.ReadBarcodes(image, LogicalRectangle.Empty, 0, symbologies)BarcodeReader.Read(imagePath)自動檢測符號學
BarcodeData.Valueresult.Value相同的屬性名稱
BarcodeData.Symbologyresult.Format屬性已重命名
new BarcodeData() { Symbology = BarcodeSymbology.Code128 }BarcodeWriter.CreateBarcode(data, BarcodeEncoding.Code128)流暢建立
BarcodeSymbology.Code128BarcodeEncoding.Code128命名空間更改
BarcodeSymbology.QRBarcodeEncoding.QRCode名稱更改
BarcodeSymbology.DataMatrixBarcodeEncoding.DataMatrix相同名稱
BarcodeSymbology.PDF417BarcodeEncoding.PDF417相同名稱
BarcodeSymbology.EAN13BarcodeEncoding.EAN13相同名稱
BarcodeSymbology.UPCABarcodeEncoding.UPCA相同名稱
BarcodeSymbology.Interleaved2of5BarcodeEncoding.Interleaved2of5相同名稱
BarcodeSymbology.CodabarBarcodeEncoding.Codabar相同名稱
engine.Writer.WriteBarcode(image, data, null) + codecs.Save(...).SaveAsPng(path)單一方法鏈
new RasterImage(...) + new FillCommand(RasterColor.White).Run(image)(removed)內部至IronBarcode

常見遷移問題及解決方案

問題1：.LIC文件在CI/CD中的引用

**LEADTOOLS：**構建或部署LEADTOOLS應用程式的CI/CD管道必須配置.LIC文件——可以將其檢入源程式碼控制、從base64祕密解碼，或作為卷工件掛載。 運行應用程式的每個管道階段都需要存取該文件。

**解決方案：**從管道中移除所有.LIC文件處理。替換為字串秘密：

# Example: GitHub Actions environment variable
env:
  IRONBARCODE_LICENSE: ${{secrets.IRONBARCODE_LICENSE}}
Text

字串值儲存在CI/CD祕密儲存中，與其他字串值的憑證放在一起。 不需要文件解碼、不需要工件配置、不需要卷配置。

問題2：Windows上的MSVC++運行時依賴

**LEADTOOLS：**Windows Server部署需要在主機上安裝MSVC++ 2017運行時。LEADTOOLS部署中使用的提供腳本、容器基礎映像和Windows AMI通常包括一個安裝此運行時的步驟。

**解決方案：**從所有Windows提供腳本和容器映像中移除MSVC++ 2017運行時安裝步驟。 IronBarcode沒有本地運行時依賴。 dotnet/aspnet基礎映像足以，不需要其他運行時包。

問題3：RasterSupportType功能鎖定檢查

**LEADTOOLS：**初始化序列包括BarcodeWrite。 這些檢查是LEADTOOLS架構要求的防禦程式碼，用於驗證授權文件覆蓋每個所需功能。

**解決方案：**移除所有RasterSupport.IsLocked()調用。 IronBarcode包括所有讀寫能力在單一授權中。 沒有每個功能的鎖定狀態，也不需要功能驗證步驟：

// Remove these lines entirely:
// if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)) ...

問題4：BarcodeSymbology陣列移除

**LEADTOOLS：**對BarcodeSymbology[]參數。 未在陣列中列出的條碼符號學不會被檢測到，這可能導致當輸入文件中引入新的條碼型別時，出現無聲的錯過讀取。

**解決方案：**移除符號學陣列。 BarcodeReader.Read()自動檢測所有支持的格式。 如果對於已知格式集需要性能優化，BarcodeReaderOptions提供可選提示，而不需要詳盡列舉：

// Optional: hint the reader for performance in format-known scenarios
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};
var results = BarcodeReader.Read("scan.png", options);

LEADTOOLS條碼遷移檢查清單

遷移前任務

在進行任何更改之前，審計程式碼庫中所有的LEADTOOLS使用情況：

grep -r "using Leadtools" --include="*.cs" .
grep -r "RasterSupport\|BarcodeEngine\|RasterCodecs" --include="*.cs" .
grep -r "BarcodeSymbology\|BarcodeData\|RasterImage" --include="*.cs" .
grep -r "LEADTOOLS.LIC\|SetLicense\|KernelExpired" --include="*.cs" .
grep -r "COPY LEADTOOLS.LIC\|LEADTOOLS_LICENSE_PATH" --include="*.dockerfile" --include="Dockerfile" .
SHELL

在開始程式碼更改之前，記錄初始化塊、讀取調用站點、寫入調用站點和Dockerfile引用的數量和位置。

程式碼更新任務

  1. 移除所有五個LEADTOOLS NuGet套件（如果存在PDF編解碼器，也移除）
  2. 通過dotnet add package IronBarcode
  3. 用using Leadtools.*命名空間導入
  4. 用RasterSupport.SetLicense初始化區塊
  5. 移除所有RasterSupport.KernelExpired檢查
  6. 移除所有RasterSupport.IsLocked(RasterSupportType.*)檢查
  7. 移除所有new BarcodeEngine()實例化
  8. 移除條碼程式碼路徑中所有new RasterCodecs()實例化
  9. 用codecs.Load(path) + engine.Reader.ReadBarcodes(image, ...)
  10. 用new BarcodeData(...) + new RasterImage(...) + FillCommand + WriteBarcode + codecs.Save()
  11. 用QRCode）
  12. 從所有Dockerfile中移除COPY LEADTOOLS.LIC行
  13. 從Dockerfile和部署配置中移除LEADTOOLS_DEVELOPER_KEY環境變數聲明
  14. 向Dockerfile和秘密配置新增IRONBARCODE_LICENSE環境變數
  15. 從Windows提供腳本中移除MSVC++ 2017運行時安裝

遷移後測試

  • 驗證所有條碼讀取操作在先前由BarcodeSymbology[]陣列覆蓋的所有符號學型別中返回預期值
  • 驗證Code 128、QR碼和任何其他生成的條碼型別產生有效的、可掃描的輸出
  • 確認PDF條碼提取在未使用Leadtools.Pdf的情況下正確工作
  • 在未掛載任何.LIC文件的情況下構建並啟動容器映像，確認應用程式正確初始化
  • 在沒有.LIC文件配置步驟的情況下運行CI/CD管道，確認所有階段成功完成
  • 驗證發布的輸出大小和容器映像提取時間得到改進

遷移到IronBarcode的主要優勢

**簡化的部署架構：**遷移後，每個環境——開發、CI、預備、生產——都通過相同的字串值秘密機制接收授權，用於API金鑰、資料庫密碼和其他憑證。 不需要文件配置、不需要工件處理，也不需要音量掛載。 新增一個新的部署環境的操作與新增任何其他秘密相同。

**減少的依賴面積：**一個NuGet包取代了五個，並且MSVC++ 2017運行時要求被消除。 條碼服務的發布輸出從大約148 MB降至大約39 MB。 較小的映像意味著更快的容器提取、降低的容器註冊表儲存成本以及在無伺服器和自動縮放環境中縮短冷啟動時間。

**精簡的應用啟動：**20行的LEADTOOLS初始化序列——文件路徑解析、到期驗證和三個每個功能鎖定檢查——被一行取代。應用啟動更快，初始化程式碼路徑沒有可能在新環境中失敗的文件系統依賴。

**全面的格式檢測：**IronBarcode支持跨所有50+符號學的讀取，而不需要調用者指定預期格式。 由於省略了LEADTOOLS中的符號學BarcodeSymbology[]陣列而導致的無聲漏讀風險被消除。 當在輸入文件中出現新的條碼型別時，IronBarcode會檢測到它，而不需要程式碼更改。

**可預測的總成本：**單一永久授權購買涵蓋開發、測試和無限生產部署，無需部署跟蹤，無需年度續訂，不需要單獨獲取生產許可。 團隊可以在開發開始前確認完整的程式庫成本，而無需銷售對話。

現代API設計：BarcodeWriter.CreateBarcode()是接受文件路徑的靜態入口。 LEADTOOLS的閱讀和寫入要求的多層物件構建——編解碼器實例、引擎實例、圖像分配、背景填充——由內部處理。 讀取和生成條碼的程式碼更短、更易於審核和測試。

請注意: LEADTOOLS是其各自所有者的註冊商標。 此網站與LEAD Technologies無關，未經其認可或贊助。 所有產品名稱、標誌和品牌均為其各自所有者的財產。 比較僅供資訊參考，並反映了撰寫時公開可用的資訊。
Curtis Chau
Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...
閱讀更多

相關文章

Key in blue circle

立即免費取得 30 天試用金鑰。

Your trial license will be sent to your email address

無任何限制。100% 解鎖。無需信用卡。

bullet_checked無需信用卡或建立帳號無任何限制。100% 解鎖。無需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
預訂您的免費即時演示
Booking Badge

全球數百萬工程師信賴

Iron Software的客戶標誌
獲取您的無義務諮詢
完成下方表單或發送電子郵件至sales@ironsoftware.com
您的詳細資訊將始終保密。
全球數百萬工程師信賴
Iron Software的客戶標誌
立即獲取您的30天試用金鑰。
無需信用卡或帳戶建立