IRONSOFTWAREHOME
FILMY

Migrating from Dynamsoft Barcode Reader to IronBarcode

Curtis Chau
Curtis Chau
Updated: 1 sierpnia 2026

Większość deweloperów, którzy dokonują migracji z Dynamsoft Barcode Reader do IronBarcode, należy do jednej z dwóch grup: tych, którzy wybrali Dynamsoft ze względu na jego renomę, a następnie odkryli, że API skoncentrowane na kamerze nie pasowało do przypadku użycia przetwarzania dokumentów, oraz tych, którzy działają w środowiskach zamkniętych lub Docker, gdzie zależność od serwera licencyjnego powodowała incydenty produkcyjne.

Jeśli należysz do pierwszej grupy, migracja usuwa zewnętrzną bibliotekę renderowania PDF, pętlę renderowania na stronę oraz wzorzec licencji oparty na kodach błędów. Jeśli jesteś w drugiej grupie, migracja usuwa wywołanie sieciowe InitLicense, pakiet licencji offline i cykl odświeżania oraz zewnętrzną politykę sieciową z Twojej konfiguracji Docker lub VPC. Tak czy inaczej, po tej migracji kod źródłowy staje się krótszy.

Niniejszy przewodnik szczerze mówi o tym, co tracisz: jeśli Twoja aplikacja przetwarza ramki kamery w czasie rzeczywistym, pipeline Capture Vision Dynamsofta nadaje się najlepiej do tego obciążenia, a IronBarcode nie jest odpowiednim zamiennikiem. Ten przewodnik po migracji dotyczy przetwarzania plików po stronie serwera, przepływów pracy z dokumentami oraz środowisk, w których dostęp do serwera licencji stanowi problem.

Krok 1: Zamień pakiety NuGet

dotnet remove package Dynamsoft.DotNet.BarcodeReader.Bundle
dotnet add package BarCode
SHELL

Jeśli w projekcie znajduje się również biblioteka do renderowania plików PDF dodana specjalnie dla Dynamsoft (najczęściej jest to PdfiumViewer), można ją również usunąć:

# Remove if added only for Dynamsoft PDF support
dotnet remove package PdfiumViewer
dotnet remove package PdfiumViewer.Native.x86_64.v8-xfa
SHELL

Krok 2: Zastąp inicjalizację licencji

To właśnie tutaj następuje najbardziej bezpośrednie uproszczenie. Wzorzec Dynamsoft wymaga sprawdzania kodów błędów i obsługi wyjątków przy każdym uruchomieniu:

Przed — Dynamsoft:

using Dynamsoft.License;
using Dynamsoft.Core;

// Must run before any barcode operations
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"License validation failed [{errorCode}]: {errorMsg}");

Po — IronBarcode:

// NuGet: dotnet add package BarCode
using IronBarCode;

// Local validation — no network call, no error code
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

W aplikacji ASP.NET Core dodaj to do Program.cs przed builder.Build():

IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_KEY")
    ?? "YOUR-LICENSE-KEY";

W środowisku Docker lub Kubernetes ustaw zmienną środowiskową IRONBARCODE_KEY w swoim manifeście wdrożenia. Nie są wymagane zewnętrzne reguły sieciowe.

Krok 3: Zastąp importy przestrzeni nazw

Znajdź i zamień we wszystkich plikach źródłowych:

grep -r "using Dynamsoft\." --include="*.cs" .
SHELL

Zastąp każde wystąpienie:

// Before
using Dynamsoft.CVR;
using Dynamsoft.DBR;
using Dynamsoft.License;
using Dynamsoft.Core;

// After
using IronBarCode;

Przykłady migracji kodu

Podstawowe odczytywanie plików

Najbardziej podstawowa operacja — odczytanie BARCODE-a z pliku graficznego.

Przed — Dynamsoft:

using Dynamsoft.CVR;
using Dynamsoft.DBR;

public string ReadBarcodeFromFile(CaptureVisionRouter router, string imagePath)
{
    CapturedResult result = router.Capture(imagePath, PresetTemplate.PT_READ_BARCODES);
    BarcodeResultItem[] items = result.GetDecodedBarcodesResult()?.GetItems();
    if (items == null || items.Length == 0)
        return null;

    return items[0].GetText();
}

Po — IronBarcode:

// NuGet: dotnet add package BarCode
using IronBarCode;

public string ReadBarcodeFromFile(string imagePath)
{
    var results = BarcodeReader.Read(imagePath);
    return results?.FirstOrDefault()?.Value;
}

Instancja routera zniknęła. BarcodeReader.Read jest statyczna. BarcodeResultItem.GetText() staje się .Value. Sprawdzenie zerowe na results jest czystsze z LINQ.

Odczytywanie wielu BarCodes

Przed — Dynamsoft:

using Dynamsoft.CVR;
using Dynamsoft.DBR;

public List<string> ReadAllBarcodes(CaptureVisionRouter router, string imagePath)
{
    SimplifiedCaptureVisionSettings settings = router.GetSimplifiedSettings(
        PresetTemplate.PT_READ_BARCODES);
    settings.BarcodeSettings.ExpectedBarcodesCount = 0; // 0 = find all
    router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings);

    CapturedResult result = router.Capture(imagePath, PresetTemplate.PT_READ_BARCODES);
    BarcodeResultItem[] items = result.GetDecodedBarcodesResult()?.GetItems();
    var values = new List<string>();

    if (items != null)
    {
        foreach (var item in items)
            values.Add(item.GetText());
    }

    return values;
}

Po — IronBarcode:

using IronBarCode;

public List<string> ReadAllBarcodes(string imagePath)
{
    var options = new BarcodeReaderOptions
    {
        ExpectMultipleBarcodes = true,
        MaxParallelThreads = 4
    };

    return BarcodeReader.Read(imagePath, options)
        .Select(r => r.Value)
        .ToList();
}

Odczytywanie z bajtów (obrazy w pamięci)

Przed — Dynamsoft:

using Dynamsoft.CVR;
using Dynamsoft.Core;
using Dynamsoft.DBR;

// Requires width, height, stride, and pixel format — low-level buffer API
public string ReadFromBuffer(CaptureVisionRouter router, byte[] rawPixels, int width, int height)
{
    var imageData = new ImageData
    {
        Bytes = rawPixels,
        Width = width,
        Height = height,
        Stride = width * 3, // assuming 24bpp RGB
        Format = EnumImagePixelFormat.IPF_RGB_888
    };

    CapturedResult result = router.Capture(imageData, PresetTemplate.PT_READ_BARCODES);
    return result.GetDecodedBarcodesResult()?.GetItems()?.FirstOrDefault()?.GetText();
}

Po — IronBarcode:

using IronBarCode;

// Pass PNG/JPEG/BMP bytes directly — no pixel format or stride calculation
public string ReadFromImageBytes(byte[] imageBytes)
{
    return BarcodeReader.Read(imageBytes)?.FirstOrDefault()?.Value;
}

Jeśli Twoja aplikacja wcześniej konwertowała bajty obrazu na surowy bufor pikseli dla Dynamsoft, możesz przekazać oryginalne zakodowane bajty obrazu (PNG, JPEG, BMP) bezpośrednio do IronBarcode bez konieczności wcześniejszego dekodowania do surowych pikseli.

Odczytywanie BarCode'ów z plików PDF — usunięcie pętli renderowania

Jest to zazwyczaj największa redukcja kodu w ramach migracji. Usuń całą pętlę renderowania PdfiumViewer i zastąp ją pojedynczym wywołaniem.

Przed — Dynamsoft z PdfiumViewer:

// Requires: Dynamsoft.DotNet.BarcodeReader.Bundle + PdfiumViewer + PdfiumViewer.Native.*
using Dynamsoft.CVR;
using Dynamsoft.DBR;
using PdfiumViewer;
using System.Drawing.Imaging;

public List<string> ReadBarcodesFromPdf(CaptureVisionRouter router, string pdfPath)
{
    var allBarcodes = new List<string>();

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    {
        for (int page = 0; page < pdfDoc.PageCount; page++)
        {
            using var image = pdfDoc.Render(page, 300, 300, true);
            using var ms = new MemoryStream();
            image.Save(ms, ImageFormat.Png);

            CapturedResult result = router.Capture(ms.ToArray(),
                PresetTemplate.PT_READ_BARCODES);
            var items = result.GetDecodedBarcodesResult()?.GetItems();
            if (items != null)
            {
                foreach (var item in items)
                    allBarcodes.Add(item.GetText());
            }
        }
    }

    return allBarcodes;
}

Po — IronBarcode:

using IronBarCode;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    return BarcodeReader.Read(pdfPath)
        .Select(r => r.Value)
        .ToList();
}

Pętla strony, PdfDocument, krok renderowania 300 DPI, MemoryStream i wywołanie Capture na każdej stronie znikają. IronBarcode obsługuje strony PDF wewnętrznie.

Jeśli chcesz odczytać plik PDF z opcjami (dla gęstych lub trudnych BarCodes):

using IronBarCode;

public List<string> ReadBarcodesFromPdfAccurate(string pdfPath)
{
    var options = new BarcodeReaderOptions
    {
        Speed = ReadingSpeed.Balanced,
        ExpectMultipleBarcodes = true
    };

    return BarcodeReader.Read(pdfPath, options)
        .Select(r => r.Value)
        .ToList();
}

Wdrożenie offline / w środowisku izolowanym

Jeśli Twój obecny kod zawiera wzorzec licencji offline, usuń go całkowicie:

Przed — Licencja offline Dynamsoft:

using Dynamsoft.License;
using Dynamsoft.Core;

// Dynamsoft offline: fetch license bundle on a connected machine, persist it,
// then replay it on the offline machine via InitLicenseFromLicenseContent.
int errorCode = LicenseManager.InitLicenseFromLicenseContent(
    licenseContent,
    out string errorMsg);

if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"Offline license failed: {errorMsg}");

Po — IronBarcode:

// Remove all of the above. Replace with:
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Nie ma wiązki zawartości licencji do pobrania i odświeżenia. Brak kroku uruchamiania połączonego urządzenia. Klucz jest weryfikowany lokalnie.

Konfiguracja Docker

Jeśli wcześniej miałeś zasady wyjścia sieciowego lub konfigurację proxy, aby umożliwić wychodzący HTTPS do punktów licencyjnych Dynamsoft:

# Before: Docker or Kubernetes egress policy
# Required: Allow outbound HTTPS to Dynamsoft licence endpoints

# After: Remove that egress rule.
# IronBarcode does not require outbound network access for license validation.

# Set license via environment variable
env:
  - name: IRONBARCODE_KEY
    valueFrom:
      secretKeyRef:
        name: ironbarcode-license
        key: key
Text

Porządkowanie zarządzania instancjami

Dynamsoft używa opartego na instancjach API zbudowanego wokół CaptureVisionRouter. Jeśli Twój kod tworzy instancje routera w klasach serwisowych, inicjalizatorach pól lub rejestracjach DI, wszystko to znika:

Przed — Zarządzanie instancjami Dynamsoft:

using Dynamsoft.CVR;
using Dynamsoft.DBR;
using Dynamsoft.License;
using Dynamsoft.Core;

public class BarcodeService : IDisposable
{
    private readonly CaptureVisionRouter _router;

    public BarcodeService()
    {
        int errorCode = LicenseManager.InitLicense("KEY", out string errorMsg);
        if (errorCode != (int)EnumErrorCode.EC_OK)
            throw new InvalidOperationException(errorMsg);

        _router = new CaptureVisionRouter();

        var settings = _router.GetSimplifiedSettings(PresetTemplate.PT_READ_BARCODES);
        settings.BarcodeSettings.ExpectedBarcodesCount = 0;
        _router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings);
    }

    public string[] ReadFile(string path)
    {
        CapturedResult result = _router.Capture(path, PresetTemplate.PT_READ_BARCODES);
        var items = result.GetDecodedBarcodesResult()?.GetItems();
        return items?.Select(i => i.GetText()).ToArray() ?? Array.Empty<string>();
    }

    public void Dispose()
    {
        _router?.Dispose();
    }
}

Po — statyczne API IronBarcode:

// NuGet: dotnet add package BarCode
using IronBarCode;

public class BarcodeService
{
    // No constructor initialization — license set once at app startup
    // No Dispose — no instance to clean up

    public string[] ReadFile(string path)
    {
        var options = new BarcodeReaderOptions { ExpectMultipleBarcodes = true };
        return BarcodeReader.Read(path, options)
            .Select(r => r.Value)
            .ToArray();
    }
}

Klasa traci swój konstruktor, implementację IDisposable i pole _router. Jeśli usługa ta była zarejestrowana w DI jako usługa singletonowa lub w zakriwie, aby zarządzać cyklem życia routera, taka rejestracja może zostać uproszczona lub usługa może stać się zbiorem statycznych metod.

Mapowanie prędkości czytania a limit czasu

Dynamsoft używa Timeout w milisekundach zoptymalizowanego dla szybkości klatek kamery. IronBarcode używa ReadingSpeed enum:

Ustawienia DynamsoftOdpowiednik IronBarcode
settings.Timeout = 100 (camera pipeline)Speed = ReadingSpeed.Faster
Krótki limit czasu (priorytet szybkości)Speed = ReadingSpeed.Balanced
Dłuższy limit czasu (priorytet dla dokładności)Speed = ReadingSpeed.Detailed
Maksymalna dokładność, bez presji czasowejSpeed = ReadingSpeed.ExtremeDetail

Dla większości przepływów pracy przetwarzania dokumentów, gdzie wydajność jest ważniejsza niż czas odpowiedzi poniżej 100 ms, ReadingSpeed.Balanced to odpowiedni domyślny wybór:

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

Typowe problemy związane z migracją

BarcodeResultItem.GetText() vs result.Value

Dostęp zmienia się z metody na właściwość:

// Before
string value = item.GetText();

// After
string value = result.Value;

BarcodeResultItem.GetFormatString() vs result.Format

Dynamsoft zwraca format jako ciąg znaków poprzez GetFormatString(). IronBarcode przedstawia to jako BarcodeEncoding enum na result.Format:

// Before
if (item.GetFormatString() == "QR_CODE")
    Console.WriteLine("Found QR code");

// After
if (result.Format == BarcodeEncoding.QRCode)
    Console.WriteLine("Found QR code");

// For logging without enum comparison — .ToString() works on both
Console.WriteLine($"Format: {result.Format}");

Wyniki zerowe a pusta kolekcja

Dynamsoft's GetDecodedBarcodesResult() może zwrócić null, gdy nie znaleziono żadnych kodów kreskowych. IronBarcode zwraca pustą kolekcję. Zaktualizuj sprawdzanie wartości null:

// Before: null check required
CapturedResult result = router.Capture(path, PresetTemplate.PT_READ_BARCODES);
var items = result.GetDecodedBarcodesResult()?.GetItems();
if (items != null && items.Length > 0)
    Process(items[0].GetText());

// After: null-safe but also correct to check Count
var results = BarcodeReader.Read(path);
if (results.Any())
    Process(results.First().Value);

SimplifiedCaptureVisionSettings to BarcodeReaderOptions

Wzorzec GetSimplifiedSettings / UpdateSettings staje się BarcodeReaderOptions przekazywany do Read:

// Before
var settings = router.GetSimplifiedSettings(PresetTemplate.PT_READ_BARCODES);
settings.BarcodeSettings.ExpectedBarcodesCount = 0;
settings.Timeout = 500;
router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings);
var result = router.Capture(path, PresetTemplate.PT_READ_BARCODES);

// After
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};
var results = BarcodeReader.Read(path, options);

Lista kontrolna migracji

Uruchom poniższe wyszukiwania, aby znaleźć wszystkie odniesienia do Dynamsoft, które wymagają aktualizacji:

grep -r "using Dynamsoft\." --include="*.cs" .
grep -r "LicenseManager.InitLicense\|EnumErrorCode\|EC_OK" --include="*.cs" .
grep -r "new CaptureVisionRouter\|router\.Capture\|PresetTemplate" --include="*.cs" .
grep -r "BarcodeResultItem\|GetDecodedBarcodesResult\|GetFormatString" --include="*.cs" .
grep -r "GetSimplifiedSettings\|UpdateSettings\|SimplifiedCaptureVisionSettings" --include="*.cs" .
grep -r "router\.Dispose\|InitLicenseFromLicenseContent" --include="*.cs" .
SHELL

Przejrzyj wszystkie dopasowania:

  • using Dynamsoft.*using IronBarCode
  • LicenseManager.InitLicense(key, out errorMsg) + sprawdzenie błędu → IronBarCode.License.LicenseKey = "key"
  • new CaptureVisionRouter() → usuń (statyczne API, brak instancji)
  • router.Capture(path, PresetTemplate.PT_READ_BARCODES)BarcodeReader.Read(path)
  • router.Capture(imageData, ...) (bufor surowych pikseli) → BarcodeReader.Read(imageBytes)
  • Pętla renderowania PDF na stronę + router.Capture(pageBytes, ...)BarcodeReader.Read(pdfPath)
  • BarcodeResultItem.GetText()result.Value
  • BarcodeResultItem.GetFormatString()result.Format
  • GetSimplifiedSettings(...) + UpdateSettings(...)new BarcodeReaderOptions { ... }
  • router.Dispose() → usuń
  • LicenseManager.InitLicenseFromLicenseContent(...) → usuń całkowicie
  • Usuń pakiety NuGet PdfiumViewer, jeśli zostały dodane wyłącznie w celu obsługi przetwarzania plików PDF przez Dynamsoft
  • Usuń zasady wyjścia sieciowego Docker/Kubernetes dla punktów licencji Dynamsoft
  • Ustaw zmienną środowiskową IRONBARCODE_KEY w konfiguracji wdrożenia
Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Powiązane artykuły

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Your trial license will be sent to your email address

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta