Neodynamic Barcode Professional 與 IronBarcode：C# 條碼庫對比

拆分式 SDK 架構

購買了兩個 Neodynamic SDK 的專案必須在啟動時配置兩個獨立的許可證區塊。這兩個許可證塊 LicenseOwner 和 LicenseKey 使用不同的命名空間和類名，並且彼此之間互不感知：

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

// Generation license (Barcode Professional SDK)
BarcodeInfo.LicenseOwner = "Company";
BarcodeInfo.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)
BarcodeInfo.LicenseOwner = "Company";
BarcodeInfo.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)
BarcodeInfo.LicenseOwner = "Company"
BarcodeInfo.LicenseKey = "GEN-KEY"

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

這種模式在每個環境（開發、測試和生產）中都會重複出現，每當產品升級或更新時都必須保持這種模式。

詳細功能比較

新動力學條碼閱讀器方法

Neodynamic條碼閱讀器僅支援線性條碼。 當向讀取器提交二維條碼時，SDK 傳回空結果集或 null 結果集。 沒有引發異常，也沒有錯誤訊息表明發生了什麼。 使用此 SDK 的團隊通常會在部署呼叫讀取器讀取二維碼影像的程式碼後發現此限制，並觀察到結果集合始終為空。

在使用 Neodynamic Reader 的程式庫中，常見的防禦模式是明確檢查，當預期為 2D 格式時引發異常：

// 新動力條碼閱讀器 SDK: QR code reading is not supported
using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var results = BarcodeReader.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;
}

// 新動力條碼閱讀器 SDK: QR code reading is not supported
using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var results = BarcodeReader.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 results = BarcodeReader.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

僅使用 Neodynamic Reader SDK 無法完成此方法。 NotSupportedException 不是一種變通方法，而是讀者對 2D 輸入所能提供的唯一誠實回應。

IronBarcode方法

IronBarcode 透過同一個 BarcodeReader.Read() 呼叫讀取所有支援的條碼系統。 系統會根據影像內容自動偵測格式。 二維碼、Code 128 條碼和 DataMatrix 條碼都使用相同的呼叫碼：

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

呼叫者未指定預期格式。IronBarcode可識別條碼並傳回其值。 有關影像讀取選項（包括多條碼檢測和影像預處理）的完整詳細信息，請參閱影像條碼讀取指南。

新動態條碼專業方法

Neodynamic 的產生 API 是基於實例的。 建構一個 BarcodeInfo 對象，分別賦值其屬性，並呼叫 GetImage() 傳回一個 System.Drawing.Image。 然後使用 System.Drawing.Imaging.ImageFormat 枚舉保存影像：

using Neodynamic.SDK.Barcode;

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

// Build the barcode through property assignment
var barcode = new BarcodeInfo();
barcode.Value = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.TextAlign = BarcodeTextAlignment.BelowCenter;
barcode.Dpi = 300;

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

using Neodynamic.SDK.Barcode;

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

// Build the barcode through property assignment
var barcode = new BarcodeInfo();
barcode.Value = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.TextAlign = BarcodeTextAlignment.BelowCenter;
barcode.Dpi = 300;

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

Imports Neodynamic.SDK.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

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

' Build the barcode through property assignment
Dim barcode As New BarcodeInfo()
barcode.Value = "12345678"
barcode.Symbology = Symbology.Code128
barcode.TextAlign = BarcodeTextAlignment.BelowCenter
barcode.Dpi = 300

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

該 SDK 提供合法的自訂選項，包括 DPI 控制、文字對齊、顏色設定和靜默區大小。 這些功能對於需要精確實體尺寸的列印工作流程非常有用。 發電能力本身是完整的； 促使人們遷移的限制因素在於閱讀方面，而不是生成方面。

IronBarcode方法

IronBarcode採用流暢的靜態方法。 編碼和資料作為參數傳遞給 BarcodeWriter.CreateBarcode()，輸出格式以傳回物件的方法名稱表示。 無需導入 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")

對於二維條碼生成，專用的 QRCodeWriter 類別提供了特定於二維碼的其他選項：

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

有關產生具有尺寸和註釋選項的一維條碼的指導，請參閱建立一維條碼指南。 有關二維條碼的建立（包括 DataMatrix 和 PDF417），請參閱二維條碼建立指南。

新動力學方法

Neodynamic 的條碼功能分為兩個獨立授權的產品。 條碼專業 SDK 涵蓋條碼生成，條碼讀取器 SDK 涵蓋條碼讀取。 每款產品都需要單獨購買，並配有單獨的許可證金鑰。 購買這兩款產品的團隊必須維護兩個 LicenseOwner / LicenseKey 配置區塊，追蹤兩個不同的續約日期，並在出現問題時處理兩個不同的支援管道。

條碼專業 SDK 的單開發者授權價格約為 245 美元。 條碼讀取器 SDK 需要單獨付費。因此，一個既需要產生條碼又需要讀取一維條碼的項目，對於單一開發人員來說，總支出可能接近或超過 500 美元。 需要 2D 讀取的項目，無論價格如何，Neodynamic 產品都無法滿足這一要求——必須添加第三個庫。 請參閱IronBarcode 支援的條碼格式頁面，以了解單一統一授權涵蓋的完整清單。

IronBarcode方法

IronBarcode 以單一產品出售，它涵蓋所有條碼操作——產生和讀取所有支援的條碼符號——只需一個許可證金鑰即可完成。 沒有單獨的閱讀器許可證，沒有單獨的生成器許可證，2D 格式支援也不收取額外費用。 許可證密鑰在應用程式啟動時設定一次，無需其他配置：

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

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

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-KEY"

IronBarcode Lite 單一開發者版本售價為 749 美元，涵蓋所有功能。 有關目前定價等級和批量選項，請參閱IronBarcode 許可頁面。

二維碼讀取要求

導致 Neodynamic 團隊轉向IronBarcode的最常見情況是，他們發現 Barcode Professional SDK 產生的二維碼無法被 Barcode Reader SDK 讀取。 建立產品標籤系統、庫存管理工具或文件追蹤工作流程的團隊通常會將生成和讀取作為更大系統中的獨立階段來實現。 當首先使用 Barcode Professional 建立生成過程時，只有在嘗試讀取元件時，讀取器的限制才會顯現出來。 到那時，該專案已經承諾使用 Neodynamic 進行生成，而添加第三個庫來涵蓋 2D 閱讀會引入版本管理的複雜性，而統一的 SDK 則不會出現這種情況。

降低產品複雜性

有些團隊遷移並非因為存在特定的格式差異，而是因為維護兩個獨立產品來實現概念上單一的功能所帶來的開銷，成為了反覆出現的摩擦點。 .csproj 檔案中包含兩個軟體包，需要進行兩次許可證續訂，需要查閱兩套發行說明，並且在應用 .NET 或 Windows 更新時可能出現兩種不相容性——所有這些額外的開銷並沒有帶來單一統一軟體包無法提供的功能。在進行 .NET 升級依賴項審核的團隊通常會發現 Neodynamic 的雙軟體包架構有簡化的可能。

PDF條碼處理

處理包含條碼的 PDF 文件的應用程式代表了 Neodynamic SDK 同時無法滿足需求的場景。 產生 SDK 和讀取器 SDK 都無法開啟 PDF 檔案並從其頁面中提取條碼值。 處理貨運清單、發票文件、醫療記錄或任何在 PDF 中嵌入條碼的文件工作流程的團隊，必須在進行任何讀取之前實施中間影像擷取步驟。 此提取步驟需要額外的庫，這意味著該專案已經存在第三個依賴項，以解決單一IronBarcode安裝即可消除的限制。

讀寫格式的一致性

大規模運行條碼工作流程的團隊有時會發現，生成和讀取之間格式支援的不一致會造成測試和驗證問題。 當一個系統為一個目的產生二維碼，並為另一個目的讀取不同格式類型的二維碼時，生成器支援的內容與讀取器支援的內容之間的差異會在往返測試中造成差距。 生成和讀取共享同一個庫和同一個支援格式清單的系統更容易驗證。 驗證產生的條碼是否可以成功讀取，變成了單庫操作，而不是多庫整合測試。

雙包裝移除

從 Neodynamic 遷移需要刪除以下兩個 NuGet 套件：Neodynamic.SDK.Barcode 和 Neodynamic.SDK.BarcodeReader。 必須從 .csproj 檔案中刪除這兩個指令，並且必須從來源檔案中刪除對應的 using 指令。 對每個運行 dotnet remove package 就足夠了； 兩者之間沒有需要額外清理的共享相依性。

雙許可證配置清理

兩個許可證配置區塊（一個用於 BarcodeInfo，一個用於 Neodynamic.SDK.BarcodeReader.BarcodeReader）都被一個 IronBarCode.License.LicenseKey 賦值所取代。 此分配在應用程式啟動時執行一次，通常在 Program.cs 或應用程式的依賴注入引導程式中執行。任何儲存 Neodynamic 許可證金鑰的設定檔或環境變數都可以在遷移驗證後停用。

NotSupportedException 移除

在開發過程中遇到 2D 讀取限制的程式碼庫通常包含佔位符方法，這些方法會拋出 NotSupportedException 錯誤，用於讀取 QR 碼或 DataMatrix 碼。 這些方法並非權宜之計，而是坦誠地承認該功能先前並不存在。遷移到IronBarcode後，每個此類方法體都替換為標準的 BarcodeReader.Read(imagePath) 呼叫。 無需特殊處理； 系統會自動偵測格式。