Podstawowy problem

Scandit wymaga uruchomionej kamery, zanim będzie można rozpocząć pracę z kodami barcode.IronBarcode wymaga jedynie ścieżki do pliku:

// Scandit SDK: mandatory camera pipeline before first barcode read
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");
var settings = BarcodeCaptureSettings.Create();
settings.EnableSymbologies(new HashSet<Symbology>
{
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
});
var barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings);
var camera = Camera.GetDefaultCamera();
await dataCaptureContext.SetFrameSourceAsync(camera);
await camera.SwitchToDesiredStateAsync(FrameSourceState.On);
barcodeCapture.IsEnabled = true;
// Results arrive later via BarcodeScanned event callback

// Scandit SDK: mandatory camera pipeline before first barcode read
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");
var settings = BarcodeCaptureSettings.Create();
settings.EnableSymbologies(new HashSet<Symbology>
{
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
});
var barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings);
var camera = Camera.GetDefaultCamera();
await dataCaptureContext.SetFrameSourceAsync(camera);
await camera.SwitchToDesiredStateAsync(FrameSourceState.On);
barcodeCapture.IsEnabled = true;
// Results arrive later via BarcodeScanned event callback

Imports Scandit.DataCapture.Core
Imports Scandit.DataCapture.Barcode
Imports System.Collections.Generic

' Scandit SDK: mandatory camera pipeline before first barcode read
Dim dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE")
Dim settings = BarcodeCaptureSettings.Create()
settings.EnableSymbologies(New HashSet(Of Symbology) From {
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
})
Dim barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings)
Dim camera = Camera.GetDefaultCamera()
Await dataCaptureContext.SetFrameSourceAsync(camera)
Await camera.SwitchToDesiredStateAsync(FrameSourceState.On)
barcodeCapture.IsEnabled = True
' Results arrive later via BarcodeScanned event callback

// IronBarcode: direct file reading
// NuGet: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// IronBarcode: direct file reading
// NuGet: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

Imports IronBarCode

' IronBarcode: direct file reading
' NuGet: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

Cały blok potoku kamery — tworzenie kontekstu, ustawienia, włączanie symboliki, pozyskiwanie obrazu z kamery, przypisywanie źródła klatek, przejście między stanami — zostaje zastąpiony przez przypisanie klucza licencyjnego i pojedyncze wywołanie metody.

Krok 1: Zastąp pakiet NuGet

Usuń pakiety Scandit:

dotnet remove package Scandit.BarcodePicker
dotnet remove package Scandit.DataCapture.Core
dotnet remove package Scandit.DataCapture.Barcode

dotnet remove package Scandit.BarcodePicker
dotnet remove package Scandit.DataCapture.Core
dotnet remove package Scandit.DataCapture.Barcode

Zainstaluj IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

Krok 2: Aktualizacja przestrzeni nazw

Zastąp importy nazw przestrzeni Scandit importami nazw przestrzeni IronBarcode:

// Before (Scandit SDK)
using Scandit.DataCapture.Core;
using Scandit.DataCapture.Barcode;
using Scandit.DataCapture.Barcode.Data;

// After (IronBarcode)
using IronBarCode;

// Before (Scandit SDK)
using Scandit.DataCapture.Core;
using Scandit.DataCapture.Barcode;
using Scandit.DataCapture.Barcode.Data;

// After (IronBarcode)
using IronBarCode;

' Before (Scandit SDK)
Imports Scandit.DataCapture.Core
Imports Scandit.DataCapture.Barcode
Imports Scandit.DataCapture.Barcode.Data

' After (IronBarcode)
Imports IronBarCode

Krok 3: Inicjalizacja licencji

Dodaj inicjalizację licencji przy starcie aplikacji, zastępując wywołanie DataCaptureContext.ForLicenseKey:

// Before (Scandit SDK)
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");

// After (IronBarcode)
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Before (Scandit SDK)
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");

// After (IronBarcode)
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Before (Scandit SDK)
Dim dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE")

' After (IronBarcode)
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Odczytywanie BarCodes z pliku graficznego

Przetwarzanie statycznego pliku graficznego jest podstawowym scenariuszem obsługiwanym przez IronBarcode, a w Scandit jest to proces nieobsługiwany. Pakiet SDK firmy Scandit przetwarza klatki z kamery na żywo; Odczytanie pliku wymaga dostosowania potoku przechwytywania tak, aby traktował mapę bitową jako źródło klatek, co nie ma natywnej implementacji.

Podejście Scandit SDK:

// Scandit SDK has no direct file-read API.
// Reading a static image requires constructing a bitmap frame source
// and routing it through the capture pipeline — an unsupported workaround.
// The standard Scandit integration assumes a running camera at all times.

// Scandit SDK has no direct file-read API.
// Reading a static image requires constructing a bitmap frame source
// and routing it through the capture pipeline — an unsupported workaround.
// The standard Scandit integration assumes a running camera at all times.

' Scandit SDK has no direct file-read API.
' Reading a static image requires constructing a bitmap frame source
' and routing it through the capture pipeline — an unsupported workaround.
' The standard Scandit integration assumes a running camera at all times.

Podejście IronBarcode:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

var results = BarcodeReader.Read("product-label.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

var results = BarcodeReader.Read("product-label.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
}

Imports IronBarCode

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

Dim results = BarcodeReader.Read("product-label.png")
For Each result In results
    Console.WriteLine($"Value: {result.Value}")
    Console.WriteLine($"Format: {result.Format}")
    Console.WriteLine($"Confidence: {result.Confidence}%")
Next

Odczytywanie kodów kreskowych z obrazów za pomocąIronBarcode nie wymaga konfiguracji potoku. Zbiór wyników jest dostępny natychmiast po zwróceniu metody, bez konieczności subskrypcji zdarzeń.

Pobieranie BarCodes z dokumentu PDF

Wyodrębnianie kodów kreskowych z plików PDF to zupełnie nowy obszar podczas migracji z platformy Scandit, która nie obsługuje plików PDF.IronBarcode odczytuje dokumenty PDF bezpośrednio, zwracając wyniki indeksowane według numeru strony.

Podejście Scandit SDK:

// Scandit SDK: no PDF support.
// Implementing PDF barcode extraction with Scandit requires:
// 1. A separate PDF rendering library to convert pages to raster images
// 2. Routing each rendered image through the camera simulation pipeline
// 3. Correlating results back to page numbers manually
// This is not a supported workflow and requires significant custom engineering.

// Scandit SDK: no PDF support.
// Implementing PDF barcode extraction with Scandit requires:
// 1. A separate PDF rendering library to convert pages to raster images
// 2. Routing each rendered image through the camera simulation pipeline
// 3. Correlating results back to page numbers manually
// This is not a supported workflow and requires significant custom engineering.

' Scandit SDK: no PDF support.
' Implementing PDF barcode extraction with Scandit requires:
' 1. A separate PDF rendering library to convert pages to raster images
' 2. Routing each rendered image through the camera simulation pipeline
' 3. Correlating results back to page numbers manually
' This is not a supported workflow and requires significant custom engineering.

Podejście IronBarcode:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

var results = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.Format})");
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

var results = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.Format})");
}

Imports IronBarCode

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

Dim results = BarcodeReader.Read("shipping-manifest.pdf")
For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.Format})")
Next

Pełne wytyczne dotyczące odczytu kodów kreskowych z dokumentów PDF, w tym wyboru zakresu stron i obsługi wielu kodów kreskowych, można znaleźć w dokumentacji IronBarcode, która obejmuje pełen zakres scenariuszy przetwarzania plików PDF. Nie są wymagane żadne dodatkowe biblioteki PDF.

Konwersja wywołań zwrotnych zdarzeń na bezpośrednie wartości zwracane

Scandit dostarcza wyniki skanowania przez zdarzenie BarcodeScanned, ponieważ skanowanie z kamery na żywo jest z natury asynchroniczne — wyniki pojawiają się, gdy kamera wykryje kod kreskowy w bieżącej klatce.IronBarcode zwraca wyniki jako kolekcję typowaną, ponieważ odczyt oparty na plikach ma znaną granicę zakończenia. Jest to jedna z najbardziej znaczących zmian strukturalnych w ramach migracji.

Podejście Scandit SDK:

// Scandit SDK: event-driven result delivery
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
    {
        string value = barcode.Data;
        string symbology = barcode.Symbology.ToString();

        // Processing logic embedded inside event handler
        LogBarcodeResult(value, symbology);
        UpdateInventory(value);
    }
};

// Scan continues indefinitely until camera session is terminated

// Scandit SDK: event-driven result delivery
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
    {
        string value = barcode.Data;
        string symbology = barcode.Symbology.ToString();

        // Processing logic embedded inside event handler
        LogBarcodeResult(value, symbology);
        UpdateInventory(value);
    }
};

// Scan continues indefinitely until camera session is terminated

Imports System

' Scandit SDK: event-driven result delivery
AddHandler barcodeCapture.BarcodeScanned, Sub(sender, args)
    For Each barcode In args.Session.NewlyRecognizedBarcodes
        Dim value As String = barcode.Data
        Dim symbology As String = barcode.Symbology.ToString()

        ' Processing logic embedded inside event handler
        LogBarcodeResult(value, symbology)
        UpdateInventory(value)
    Next
End Sub

' Scan continues indefinitely until camera session is terminated

Podejście IronBarcode:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

var results = BarcodeReader.Read("document.png");
foreach (var result in results)
{
    // Same processing logic, now in standard control flow
    LogBarcodeResult(result.Value, result.Format.ToString());
    UpdateInventory(result.Value);
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

var results = BarcodeReader.Read("document.png");
foreach (var result in results)
{
    // Same processing logic, now in standard control flow
    LogBarcodeResult(result.Value, result.Format.ToString());
    UpdateInventory(result.Value);
}

Imports IronBarCode

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

Dim results = BarcodeReader.Read("document.png")
For Each result In results
    ' Same processing logic, now in standard control flow
    LogBarcodeResult(result.Value, result.Format.ToString())
    UpdateInventory(result.Value)
Next

Cała logika przetwarzania, która była osadzona w wywołaniach zwrotnych obsługi zdarzeń, zostaje przeniesiona do standardowego kodu sekwencyjnego. Obsługa błędów, rejestrowanie i operacje następcze mogą być zorganizowane przy użyciu zwykłego przepływu sterowania, a nie wzorców obsługi zdarzeń.

Punkt końcowy ASP.NET Core do przesyłania plików

Bezstanowy punkt końcowy serwera odczytujący kody kreskowe z przesłanego pliku stanowi główny przykład zastosowania IronBarcode po stronie serwera. Ten wzorzec nie jest obsługiwany przez architekturę potoku kamer Scandit.

Podejście Scandit SDK:

// Scandit SDK: not applicable to ASP.NET Core file upload scenarios.
// The DataCaptureContext requires a camera hardware session.
// There is no mechanism to process an IFormFile through the Scandit pipeline
// without substantial custom camera-simulation infrastructure.

// Scandit SDK: not applicable to ASP.NET Core file upload scenarios.
// The DataCaptureContext requires a camera hardware session.
// There is no mechanism to process an IFormFile through the Scandit pipeline
// without substantial custom camera-simulation infrastructure.

' Scandit SDK: not applicable to ASP.NET Core file upload scenarios.
' The DataCaptureContext requires a camera hardware session.
' There is no mechanism to process an IFormFile through the Scandit pipeline
' without substantial custom camera-simulation infrastructure.

Podejście IronBarcode:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

[ApiController]
[Route("api/[controller]")]
public class BarcodeController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult ScanUploadedDocument(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return BadRequest("No file provided");

        using var stream = file.OpenReadStream();
        var results = BarcodeReader.Read(stream);

        if (!results.Any())
            return NotFound("No barcodes detected");

        return Ok(results.Select(r => new
        {
            r.Value,
            Format = r.Format.ToString(),
            r.PageNumber
        }));
    }
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

[ApiController]
[Route("api/[controller]")]
public class BarcodeController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult ScanUploadedDocument(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return BadRequest("No file provided");

        using var stream = file.OpenReadStream();
        var results = BarcodeReader.Read(stream);

        if (!results.Any())
            return NotFound("No barcodes detected");

        return Ok(results.Select(r => new
        {
            r.Value,
            Format = r.Format.ToString(),
            r.PageNumber
        }));
    }
}

Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/[controller]")>
Public Class BarcodeController
    Inherits ControllerBase

    <HttpPost("scan")>
    Public Function ScanUploadedDocument(file As IFormFile) As IActionResult
        If file Is Nothing OrElse file.Length = 0 Then
            Return BadRequest("No file provided")
        End If

        Using stream = file.OpenReadStream()
            Dim results = BarcodeReader.Read(stream)

            If Not results.Any() Then
                Return NotFound("No barcodes detected")
            End If

            Return Ok(results.Select(Function(r) New With {
                .Value = r.Value,
                .Format = r.Format.ToString(),
                .PageNumber = r.PageNumber
            }))
        End Using
    End Function
End Class

Metoda BarcodeReader.Read akceptuje Stream bezpośrednio z IFormFile.OpenReadStream(), nie wymaga tworzenia tymczasowego pliku. Wyniki są zwracane synchronicznie w ramach cyklu żądanie-odpowiedź bez asynchronicznego zarządzania kamerą.

Równoległe przetwarzanie wsadowe wielu dokumentów

Duże kolejki dokumentów wymagają przetwarzania równoległego w wielu wątkach. Ponieważ API IronBarcode jest bezstanowe, jest z natury bezpieczne dla wątków i komponuje się bezpośrednio z Parallel.ForEach oraz asynchronicznymi wzorcami zadań.

Podejście Scandit SDK:

// Scandit SDK: no supported batch file processing pattern.
// The FrameSourceState model assumes a continuous camera session,
// not a queue of discrete documents. Batch processing would require
// one camera simulation pipeline per document or serialized processing
// through a shared pipeline — neither is a supported workflow.

// Scandit SDK: no supported batch file processing pattern.
// The FrameSourceState model assumes a continuous camera session,
// not a queue of discrete documents. Batch processing would require
// one camera simulation pipeline per document or serialized processing
// through a shared pipeline — neither is a supported workflow.

' Scandit SDK: no supported batch file processing pattern.
' The FrameSourceState model assumes a continuous camera session,
' not a queue of discrete documents. Batch processing would require
' one camera simulation pipeline per document or serialized processing
' through a shared pipeline — neither is a supported workflow.

Podejście IronBarcode:

// NuGet: dotnet add package IronBarcode
using IronBarCode;
using System.Collections.Concurrent;

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

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

var files = Directory.GetFiles("./documents/", "*.pdf");
var allResults = new ConcurrentBag<(string File, BarcodeResult Result)>();

Parallel.ForEach(files, file =>
{
    var results = BarcodeReader.Read(file, options);
    foreach (var result in results)
        allResults.Add((file, result));
});

foreach (var (file, result) in allResults)
    Console.WriteLine($"{Path.GetFileName(file)}: {result.Value} ({result.Format})");

// NuGet: dotnet add package IronBarcode
using IronBarCode;
using System.Collections.Concurrent;

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

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

var files = Directory.GetFiles("./documents/", "*.pdf");
var allResults = new ConcurrentBag<(string File, BarcodeResult Result)>();

Parallel.ForEach(files, file =>
{
    var results = BarcodeReader.Read(file, options);
    foreach (var result in results)
        allResults.Add((file, result));
});

foreach (var (file, result) in allResults)
    Console.WriteLine($"{Path.GetFileName(file)}: {result.Value} ({result.Format})");

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.IO
Imports System.Threading.Tasks

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

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim files = Directory.GetFiles("./documents/", "*.pdf")
Dim allResults As New ConcurrentBag(Of (File As String, Result As BarcodeResult))()

Parallel.ForEach(files, Sub(file)
    Dim results = BarcodeReader.Read(file, options)
    For Each result In results
        allResults.Add((file, result))
    Next
End Sub)

For Each item In allResults
    Console.WriteLine($"{Path.GetFileName(item.File)}: {item.Result.Value} ({item.Result.Format})")
Next

W przypadku zaawansowanych wzorców obejmujących asynchroniczne i wielowątkowe odczytywanie kodów kreskowych, w tym dostrajanie przepustowości i konfigurację liczby wątków, dokumentacja IronBarcode zawiera szczegółowe wskazówki.

Problem 1: Kod potoku kamery nie ma bezpośredniego tłumaczenia

Scandit SDK: Blok ustawień DataCaptureContext, BarcodeCaptureSettings, Camera i BarcodeCapture obejmuje 7–10 linii kodu inicjalizacyjnego z asynchronicznymi przejściami stanu.

Rozwiązanie: Ten blok został całkowicie usunięty. Nie ma odpowiednika IronBarcode, ponieważ oparte na plikach API IronBarcode nie wymaga inicjalizacji sesji. Zastąp cały blok następującym tekstem:

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

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

Imports IronBarCode

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

Problem 2: Logika obsługi zdarzeń BarcodeScanned

Scandit SDK: Logika przetwarzania jest osadzona wewnątrz lambd bądź metod obsługi zdarzeń BarcodeScanned +=. Ten wzorzec nie istnieje w IronBarcode.

Rozwiązanie: Przenieś ciało obsługi do standardowego kodu po wywołaniu BarcodeReader.Read:

// Before: event handler
barcodeCapture.BarcodeScanned += (s, args) =>
{
    foreach (var b in args.Session.NewlyRecognizedBarcodes)
        Console.WriteLine(b.Data);
};

// After: direct iteration
foreach (var result in BarcodeReader.Read("document.png"))
    Console.WriteLine(result.Value);

// Before: event handler
barcodeCapture.BarcodeScanned += (s, args) =>
{
    foreach (var b in args.Session.NewlyRecognizedBarcodes)
        Console.WriteLine(b.Data);
};

// After: direct iteration
foreach (var result in BarcodeReader.Read("document.png"))
    Console.WriteLine(result.Value);

Imports System

' Before: event handler
AddHandler barcodeCapture.BarcodeScanned, Sub(s, args)
    For Each b In args.Session.NewlyRecognizedBarcodes
        Console.WriteLine(b.Data)
    Next
End Sub

' After: direct iteration
For Each result In BarcodeReader.Read("document.png")
    Console.WriteLine(result.Value)
Next

Problem 3: Wywołania EnableSymbologies rozproszone w kodzie źródłowym

Scandit SDK: W wielu miejscach w kodzie można wywołać settings.EnableSymbologies(...) z różnymi zestawami symbologii dla różnych kontekstów skanowania.

Rozwiązanie: Usuń wszystkie wywołania EnableSymbologies.IronBarcode domyślnie automatycznie wykrywa wszystkie obsługiwane formaty. Jeśli ograniczenie formatu jest potrzebne dla wydajności w określonych scenariuszach, użyj BarcodeReaderOptions.ExpectBarcodeTypes:

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};
var results = BarcodeReader.Read("document.png", options);

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};
var results = BarcodeReader.Read("document.png", options);

Imports System

Dim options As New BarcodeReaderOptions With {
    .ExpectBarcodeTypes = BarcodeEncoding.Code128 Or BarcodeEncoding.QRCode
}
Dim results = BarcodeReader.Read("document.png", options)

Problem 4: Brak możliwości odczytu plików PDF w istniejącym kodzie źródłowym

Scandit SDK: Jeśli istniejąca baza kodu konwertuje strony PDF na obrazy przed przekazaniem ich do potoku Scandit, ta niestandardowa infrastruktura renderowania nie jest już potrzebna.

Rozwiązanie: Całkowicie usunąć etap renderowania pliku PDF na obraz. Przekaż ścieżkę do pliku PDF bezpośrednio do IronBarcode:

// Before: render PDF pages to images, then pass each image to Scandit pipeline
// (multiple steps, external PDF library dependency)

// After: pass PDF directly to IronBarcode
var results = BarcodeReader.Read("document.pdf");
// Results include PageNumber property for each detected barcode

// Before: render PDF pages to images, then pass each image to Scandit pipeline
// (multiple steps, external PDF library dependency)

// After: pass PDF directly to IronBarcode
var results = BarcodeReader.Read("document.pdf");
// Results include PageNumber property for each detected barcode

' Before: render PDF pages to images, then pass each image to Scandit pipeline
' (multiple steps, external PDF library dependency)

' After: pass PDF directly to IronBarcode
Dim results = BarcodeReader.Read("document.pdf")
' Results include PageNumber property for each detected barcode

Zagadnienie 5: Wzorce asynchronicznej inicjalizacji kamery

Scandit SDK: Inicjalizacja kamery używa await dla SetFrameSourceAsync oraz SwitchToDesiredStateAsync. Jeśli kod wywołujący jest zbudowany wokół tych operacji asynchronicznych, ich usunięcie upraszcza łańcuch asynchroniczny.

Rozwiązanie: Całkowicie usuń asynchroniczną inicjalizację kamery. BarcodeReader.Read jest synchroniczny. Jeśli potrzebne jest asynchroniczne wykonanie dla responsywności w interfejsie użytkownika lub kontekście serwera, otocz go Task.Run:

// Async wrapper for non-blocking execution
var results = await Task.Run(() => BarcodeReader.Read("document.png"));

// Async wrapper for non-blocking execution
var results = await Task.Run(() => BarcodeReader.Read("document.png"));

Imports System.Threading.Tasks

' Async wrapper for non-blocking execution
Dim results = Await Task.Run(Function() BarcodeReader.Read("document.png"))

Zadania przed migracją

Sprawdź wszystkie punkty integracji Scandit w kodzie źródłowym:

grep -r "DataCaptureContext\|BarcodeCaptureSettings\|BarcodeCapture" --include="*.cs" .
grep -r "EnableSymbologies\|BarcodeScanned\|NewlyRecognizedBarcodes" --include="*.cs" .
grep -r "using Scandit" --include="*.cs" .
grep -r "barcode\.Data\|barcode\.Symbology\|FrameSourceState" --include="*.cs" .

grep -r "DataCaptureContext\|BarcodeCaptureSettings\|BarcodeCapture" --include="*.cs" .
grep -r "EnableSymbologies\|BarcodeScanned\|NewlyRecognizedBarcodes" --include="*.cs" .
grep -r "using Scandit" --include="*.cs" .
grep -r "barcode\.Data\|barcode\.Symbology\|FrameSourceState" --include="*.cs" .

Udokumentuj wszystkie konteksty skanowania — określ, które ścieżki kodu obsługują skanowanie z kamery w czasie rzeczywistym (pozostając w Scandit), a które przetwarzanie plików lub dokumentów (migrując do IronBarcode). Należy zwrócić uwagę na wszystkie miejsca, w których strony PDF są renderowane do obrazów przed przetworzeniem przez Scandit, ponieważ ten etap renderowania zostanie wyeliminowany.

Zadania związane z aktualizacją kodu

1. Usuń pakiety NuGet Scandit (Scandit.BarcodePicker, Scandit.DataCapture.Core, Scandit.DataCapture.Barcode)
2. Zainstaluj pakiet NuGet IronBarcode
3. Zastąp importy using Scandit.DataCapture.* using IronBarCode
4. Usuń blok inicjalizacyjny DataCaptureContext w całości
5. Usuń wszystkie wywołania Camera.GetDefaultCamera() i SetFrameSourceAsync
6. Usuń wszystkie wywołania EnableSymbologies
7. Zastąp barcodeCapture.IsEnabled = true BarcodeReader.Read(filePath)
8. Przekształć obsługę zdarzeń BarcodeScanned += w foreach nad wynikami BarcodeReader.Read()
9. Zastąp barcode.Data result.Value
10. Zastąp barcode.Symbology result.Format
11. Usunięcie potoków renderowania PDF na obraz, gdzie IronBarcode odczytuje teraz pliki PDF bezpośrednio
12. Dodaj IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY" przy starcie aplikacji

Testy po migracji

Po zakończeniu aktualizacji kodu sprawdź, czy:

• Sprawdź, czy wartości BarCode zwracane przez IronBarcodesą zgodne z wartościami zwracanymi wcześniej przez Scandit dla tych samych dokumentów wejściowych
• Zweryfikuj, że wszystkie obsługiwane formaty kodów kreskowych w zestawie dokumentów są wykrywane bez konfiguracji ExpectBarcodeTypes
• Przetestuj, czy ekstrakcja PDF zwraca poprawne wartości PageNumber dla dokumentów wielostronicowych
• Sprawdź, czy punkty końcowe .NET Core zwracają wyniki w akceptowalnym czasie odpowiedzi przy oczekiwanym obciążeniu
• Sprawdź, czy wdrożenia Docker lub kontenerowe pomyślnie odczytują BarCode bez sprzętu kamerowego
• Przetestuj, czy jednoczesne przetwarzanie wsadowe z Parallel.ForEach zwraca poprawne wyniki bez warunków wyścigu
• Sprawdź, czy aplikacja uruchamia się i inicjuje poprawnie z kluczem licencyjnym IronBarcode zamiast kontekstu Scandit