拆分SDK架構

購買Neodynamic SDK的項目必須在啟動時配置兩個不同的授權塊。雙重LicenseKey分配使用不同的命名空間和不同的類名，兩個塊彼此不知情：

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

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

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

這種模式反覆出現在每個環境中 —— 開發，測試和生產 —— 並且每當產品升級或更新時都必須維護。

詳細特性比較

Neodynamic條碼讀取器方法

Neodynamic條碼讀取器僅支持線性條碼。 當將2D條碼提交給讀取器時，SDK返回一個空或null的結果集。 不會拋出異常，也沒有錯誤訊息指示發生了什麼。 使用該SDK的團隊通常會在部署調用讀取器對QR碼圖像進行調用的程式碼後發現這一限制，觀察到結果集合總是為空。

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

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

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

using Neodynamic.SDK.BarcodeReader;
using System.Drawing;

public string ReadQrCode(string imagePath)
{
    using var bitmap = new Bitmap(imagePath);
    var reader = new BarcodeReader();
    var results = reader.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 reader As New BarcodeReader()
        Dim results = reader.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()調用讀取所有支持的符號學。 格式從圖像內容中自動檢測。 QR碼、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條碼專業方法

Neodynamic的生成API是基於實例的。 構建一個System.Drawing.Image。 然後使用System.Drawing.Imaging.ImageFormat枚舉保存圖像：

using Neodynamic.SDK.Barcode;

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

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

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

using Neodynamic.SDK.Barcode;

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

// Build the barcode through property assignment
var barcode = new BarcodeProfessional();
barcode.Code = "12345678";
barcode.Symbology = Symbology.Code128;
barcode.BarcodeUnit = BarcodeUnit.Pixel;

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

Imports Neodynamic.SDK.Barcode
Imports System.Drawing

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

' Build the barcode through property assignment
Dim barcode As New BarcodeProfessional()
barcode.Code = "12345678"
barcode.Symbology = Symbology.Code128
barcode.BarcodeUnit = BarcodeUnit.Pixel

' Get image and save via System.Drawing
Dim image As Image = barcode.GetBarcodeImage()
image.Save("output.png", Imaging.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")

對於2D條碼生成，專門的QRCodeWriter類提供特定於QR碼的額外選項：

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

有關生成具有大小和註解選項的1D符號學的指南，請參閱建立1D條碼指南。 有關建立包括DataMatrix和PDF417在內的2D條碼，請參閱建立2D條碼指南。

Neodynamic方法

Neodynamic的條碼能力分割在兩個單獨許可的產品中。 Barcode Professional SDK涵蓋生成，Barcode Reader SDK涵蓋讀取。 每個產品需要單獨購買並有單獨的許可密鑰。 購買兩個產品的團隊必須維護兩個LicenseOwner / LicenseKey配置塊，跟踪兩個不同的續約日期，並在出現問題時處理兩個獨立的支持渠道。

Barcode Professional SDK從大約$352起，針對Basic版的一位開發者授權，而從Ultimate版起大約$705（開發者授權經由ComponentSource取得）。 Barcode Reader SDK有單獨的成本，是根據遺留定價供應的—該產品已於2019年12月31日標記為服務終止。需要2D讀取的專案無法以任何價格滿足該需求，需要新增第三個程式庫。 您可以參閱IronBarcode支持條碼格式頁面，查看單一統一許可涵蓋的完整列表。

IronBarcode方法

IronBarcode作為一個單一產品出售，涵蓋所有條碼操作 — 包括生成和讀取所有支持的符號學 — 使用單一許可密鑰。 沒有單獨的讀取許可，沒有單獨的生成許可，也沒有額外的2D格式支持費用。 許可密鑰在應用程式啟動時設定一次，無需進一步的配置：

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

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

Imports IronBarCode

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

IronBarcode Lite價格為$749支持一位開發者，包括完整功能套件。 若要查看當前的定價級別和批量選擇，請參閱IronBarcode授權頁面。

QR碼讀取需求

團隊從Neodynamic轉到IronBarcode的最常見情況是發現Barcode Professional SDK生成的QR碼不能被Barcode Reader SDK讀回。 構建產品標籤系統、庫存管理工具或文件跟踪工作流的團隊通常將生成和讀取實施為更大系統的單個階段。 當首先使用Barcode Professional構建生成時，只在嘗試讀取組件時才會發現讀取器的限制。 到了那時，項目已經承諾使用Neodynamic進行生成，新增第三個程式庫以涵蓋2D讀取會引入版本管理的複雜性，而這在統一的SDK中不存在。

降低產品複雜性

有些團隊轉移不是因為具體的格式差距，而是因為維護兩個獨立產品的負擔，這在概念上是一個單一功能，卻成為了經常性的摩擦點。 兩個包在.csproj文件中，兩個授權續期周期要跟踪，兩套釋放說明要審查，應用.NET或Windows更新時的兩個潛在不相容來源——這些額外的負擔沒有提供超越單個統一包所能提供的功能。在.NET升級作為依賴項審計的一部分時，團隊經常將Neodynamic雙包方案識別為一個精簡化的機會。

PDF條碼處理

處理包含條碼的PDF文件的應用程式代表了兩個Neodynamic SDK短板同時發生的情況。 生成SDK和讀取SDK都無法打開PDF文件並從其頁面中提取條碼值。 處理運單、發票文件、醫療記錄或任何條碼嵌入在PDF中的文件工作流的團隊必須在進行任何讀取之前實施中間的圖像提取步驟。 該提取步驟需要額外的程式庫，這意味著這個項目已經附加了第三個依賴項，以克服一個單一IronBarcode安裝可以消除的限制。

讀寫格式一致性

以規模運行條碼工作流的團隊有時發現，生成和讀取之間在格式支持上的不一致性會造成測試和驗證問題。 當系統為一個目的生成QR碼，為另一個目的讀取不同格式型別時，生成器支持與讀取器支持之間的分歧會在回路測試中產生差距。 一個系統，其中生成和讀取共享相同的程式庫和相同的支持格式列表，較易於驗證。 確認生成的條碼能夠成功回讀，從多程式庫整合測試變成單一程式庫操作。

雙包刪除

從Neodynamic轉移需要刪除兩個NuGet包：Neodynamic.SDK.BarcodeReader。 兩者必須從using指令必須從原始文件中刪除。 對每個包運行dotnet remove package就足夠了； 這兩個之間沒有共享依賴，需要額外清理。

雙授權配置清除

兩個授權配置塊 —— 一個用於Neodynamic.SDK.BarcodeReader.BarcodeReader —— 以一個IronBarCode.License.LicenseKey賦值替換。 這個賦值在應用程式啟動時進行，通常在Program.cs或應用的依賴注入引導中。任何儲存Neodynamic授權密鑰的配置文件或環境變數都可以在遷移驗證後淘汰。

NotSupportedException 清除

開發期間遇到2D讀取限制的程式碼庫通常包含拋出NotSupportedException的佔位符方法，來處理QR碼或DataMatrix讀取。 這些方法不是變通，而是誠實地承認該功能並不存在。在遷移到IronBarcode後，每個這樣的方法體都被標準BarcodeReader.Read(imagePath)呼叫替換。 不需要特別處理； 格式是自動檢測的。