Migrating from LEADTOOLS Barcode to IronBarcode

The Fundamental Problem

The LEADTOOLS initialization sequence requires 20+ lines and four verification steps before a BarcodeEngine can be created. IronBarcode replaces the entire sequence with a single assignment:

// 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.Barcodes1D))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcodes2D))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

// 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.Barcodes1D))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcodes2D))
    throw new InvalidOperationException("2D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite))
    throw new InvalidOperationException("Barcode writing is locked");

var engine = new BarcodeEngine();

Imports Leadtools
Imports Leadtools.Barcode

' LEADTOOLS: file path, expiry check, three feature lock checks, engine creation
RasterSupport.SetLicense(
    "C:\LEADTOOLS23\Support\Common\License\LEADTOOLS.LIC",
    "your-developer-key-here")

If RasterSupport.KernelExpired Then
    Throw New InvalidOperationException("LEADTOOLS license has expired")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcodes1D) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcodes2D) Then
    Throw New InvalidOperationException("2D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) Then
    Throw New InvalidOperationException("Barcode writing is locked")
End If

Dim engine As New BarcodeEngine()

// IronBarcode: one line, no file required
using IronBarCode;

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

// IronBarcode: one line, no file required
using IronBarCode;

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

Imports IronBarCode

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

Step 1: Remove LEADTOOLS Packages

Remove all LEADTOOLS packages from the project:

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

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

If the PDF codec was added for barcode extraction from PDF files:

dotnet remove package Leadtools.Pdf

dotnet remove package Leadtools.Pdf

On Windows Server deployments, the MSVC++ 2017 Runtime can be removed from provisioning scripts after the migration is complete. IronBarcode has no native runtime dependencies on any platform.

Step 2: Install IronBarcode

dotnet add package IronBarcode

dotnet add package IronBarcode

This single package includes all image format support, native PDF barcode extraction, ML error correction, and all 50+ supported symbologies. No additional codec packages are required.

Step 3: Initialize the License

Replace the entire LEADTOOLS initialization block with a single line. Locate every call to RasterSupport.SetLicense in the codebase — there will typically be exactly one, at application startup — and replace the entire surrounding initialization sequence:

// Before: entire LEADTOOLS initialization block (20+ lines)
// After:
using IronBarCode;

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

// Before: entire LEADTOOLS initialization block (20+ lines)
// After:
using IronBarCode;

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

Imports IronBarCode

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

The license key can be sourced from any string-capable configuration mechanism: an environment variable, appsettings.json, Azure Key Vault, AWS Secrets Manager, or a Kubernetes secret. For environment-based license configuration, Docker deployment patterns, and all supported configuration approaches, see the license key setup documentation.

Reading Barcodes from Images

LEADTOOLS separates image loading from barcode scanning into two distinct object layers. A RasterCodecs instance loads the image file into a RasterImage, and a BarcodeEngine instance scans it. The caller must also provide an explicit array of BarcodeSymbology values; formats not listed in the array will not be detected.

LEADTOOLS Approach:

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}");

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}");

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim codecs As New RasterCodecs()
Using codecs
    Dim image = codecs.Load("scan.png")
    Using image
        Dim engine As New BarcodeEngine()

        Dim symbologies = New BarcodeSymbology() {
            BarcodeSymbology.Code128,
            BarcodeSymbology.Code39,
            BarcodeSymbology.QR,
            BarcodeSymbology.DataMatrix,
            BarcodeSymbology.EAN13,
            BarcodeSymbology.UPCA
        }

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

        For Each barcode In barcodes
            Console.WriteLine($"{barcode.Symbology}: {barcode.Value}")
        Next
    End Using
End Using

IronBarcode Approach:

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

Dim results = BarcodeReader.Read("scan.png")

For Each result In results
    Console.WriteLine($"{result.BarcodeType}: {result.Value}")
Next

IronBarcode accepts the file path directly, loads the image internally, and auto-detects formats across all 50+ supported symbologies without requiring the caller to enumerate expected types. For advanced configuration — reading speed tuning, multi-barcode detection, and low-quality image handling — see the reading barcodes from images guide.

Generating a Code 128 Barcode

LEADTOOLS generation requires constructing a BarcodeData object, allocating a blank RasterImage with explicit memory flags, pixel depth, and byte order, filling the image with a background color, writing the barcode onto it, and then saving with RasterCodecs. IronBarcode performs all of those steps through a single fluent method chain.

LEADTOOLS Approach:

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);

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);

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim barcodeData As New BarcodeData() With {
    .Symbology = BarcodeSymbology.Code128,
    .Value = "ITEM-98765",
    .Bounds = New LeadRect(0, 0, 500, 120)
}

Using image As New RasterImage(
    RasterMemoryFlags.Conventional,
    500, 120, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    Nothing, IntPtr.Zero, 0)

    Dim fillCommand As New FillCommand(RasterColor.White)
    fillCommand.Run(image)
    engine.Writer.WriteBarcode(image, barcodeData, Nothing)

    Using codecs As New RasterCodecs()
        codecs.Save(image, "item-barcode.png", RasterImageFormat.Png, 0)
    End Using
End Using

IronBarcode Approach:

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

For a full walkthrough of sizing, styling, margin control, and supported output formats, see creating barcode images.

Generating a QR Code with Logo Branding

LEADTOOLS QR code generation follows the same multi-step RasterImage construction pattern as other barcode types. Logo embedding in the center of a QR code is not supported. IronBarcode provides QRCodeWriter with a dedicated AddBrandLogo method.

LEADTOOLS Approach:

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);
// Note: LEADTOOLS does not support logo embedding in QR codes

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);
// Note: LEADTOOLS does not support logo embedding in QR codes

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

Dim engine As New BarcodeEngine()

Dim qrData As New BarcodeData() With {
    .Symbology = BarcodeSymbology.QR,
    .Value = "https://example.com/product/12345",
    .Bounds = New LeadRect(0, 0, 400, 400)
}

Using image As New RasterImage(
    RasterMemoryFlags.Conventional,
    400, 400, 24,
    RasterByteOrder.Bgr,
    RasterViewPerspective.TopLeft,
    Nothing, IntPtr.Zero, 0)

    Dim fillCommand As New FillCommand(RasterColor.White)
    fillCommand.Run(image)
    engine.Writer.WriteBarcode(image, qrData, Nothing)

    Using codecs As New RasterCodecs()
        codecs.Save(image, "product-qr.png", RasterImageFormat.Png, 0)
    End Using
End Using
' Note: LEADTOOLS does not support logo embedding in QR codes

IronBarcode Approach:

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

QRCodeWriter.CreateQrCodeWithLogo("https://example.com/product/12345", "brand-logo.png", 400) _
    .SaveAsPng("product-qr.png")

Extracting Barcodes from PDF Documents

LEADTOOLS PDF barcode extraction requires the separate Leadtools.Pdf package, explicit PDF loading configuration, a manual page count query, and a loop over each page. Each page must be loaded individually as a RasterImage before scanning. IronBarcode includes PDF support in the base package and handles page iteration internally.

LEADTOOLS Approach:

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}");
}

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}");
}

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs

' Requires: dotnet add package Leadtools.Pdf
Using codecs As New RasterCodecs()
    codecs.Options.Pdf.Load.Resolution = 300
    codecs.Options.Pdf.Load.DisplayDepth = 24

    Dim engine As New BarcodeEngine()
    Dim results As New List(Of String)()
    Dim pageCount As Integer = codecs.GetTotalPages("shipment.pdf")

    For page As Integer = 1 To pageCount
        Using image = codecs.Load("shipment.pdf", 0, CodecsLoadByteOrder.BgrOrGray, page, page)
            Dim barcodes = engine.Reader.ReadBarcodes(image, LogicalRectangle.Empty, 0, Nothing)

            For Each barcode In barcodes
                results.Add($"Page {page}: {barcode.Value}")
            Next
        End Using
    Next
End Using

IronBarcode Approach:

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

Dim results = BarcodeReader.Read("shipment.pdf")

For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

Docker Deployment

The file management requirement that defines every LEADTOOLS Docker deployment is eliminated entirely when migrating to IronBarcode.

LEADTOOLS Approach:

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"]

IronBarcode Approach:

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

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

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

The license key is injected at container runtime through Docker secrets, Kubernetes secrets, or any environment variable mechanism. No file provisioning step is required. The Docker and Linux deployment guide covers Alpine and Debian base images, multi-stage builds, and Kubernetes deployment patterns.

Issue 1: .LIC File References in CI/CD

LEADTOOLS: CI/CD pipelines that build or deploy LEADTOOLS applications must provision the .LIC file — either checking it into source control, decoding it from a base64 secret, or mounting it as a volume artifact. Each pipeline stage that runs the application needs the file accessible.

Solution: Remove all .LIC file handling from the pipeline. Replace with a string secret:

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

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

The string value is stored in the CI/CD secrets store alongside other string-valued credentials. No file decoding, no artifact provisioning, no volume configuration is required.

Issue 2: MSVC++ Runtime Dependency on Windows

LEADTOOLS: Windows Server deployments require the MSVC++ 2017 Runtime to be installed on the host. Provisioning scripts, container base images, and Windows AMIs used for LEADTOOLS deployments typically include a step to install this runtime.

Solution: Remove the MSVC++ 2017 Runtime installation step from all Windows provisioning scripts and container images. IronBarcode has no native runtime dependencies. The dotnet/aspnet base image is sufficient without additional runtime packages.

Issue 3: RasterSupportType Feature Lock Checks

LEADTOOLS: The initialization sequence includes RasterSupport.IsLocked() checks for each barcode feature — Barcodes1D, Barcodes2D, and BarcodeWrite. These checks are defensive code required by the LEADTOOLS architecture to verify that the license file covers each required capability.

Solution: Remove all RasterSupport.IsLocked() calls. IronBarcode includes all reading and writing capabilities in a single license. There are no per-feature lock states and no feature verification step is needed:

// Remove these lines entirely:
// if (RasterSupport.IsLocked(RasterSupportType.Barcodes1D)) ...
// if (RasterSupport.IsLocked(RasterSupportType.Barcodes2D)) ...
// if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)) ...

// Remove these lines entirely:
// if (RasterSupport.IsLocked(RasterSupportType.Barcodes1D)) ...
// if (RasterSupport.IsLocked(RasterSupportType.Barcodes2D)) ...
// if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)) ...

Issue 4: BarcodeSymbology Array Removal

LEADTOOLS: Every call to engine.Reader.ReadBarcodes() requires an explicit BarcodeSymbology[] parameter. Barcodes whose symbology is not listed in the array will not be detected, which can cause silent missed reads when a new barcode type is introduced in an input document.

Solution: Remove the symbology array. BarcodeReader.Read() auto-detects all supported formats. If performance tuning is needed for a known format set, BarcodeReaderOptions provides optional hints without requiring exhaustive enumeration:

// 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);

// 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);

Imports System

' Optional: hint the reader for performance in format-known scenarios
Dim options As New BarcodeReaderOptions With {
    .ExpectBarcodeTypes = BarcodeEncoding.Code128 Or BarcodeEncoding.QRCode
}
Dim results = BarcodeReader.Read("scan.png", options)

Pre-Migration Tasks

Audit all LEADTOOLS usage in the codebase before making any changes:

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" .

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" .

Document the count and location of initialization blocks, read call sites, write call sites, and Dockerfile references before beginning code changes.

Code Update Tasks

1. Remove all five LEADTOOLS NuGet packages (and the PDF codec if present)
2. Install IronBarcode via dotnet add package IronBarcode
3. Replace all using Leadtools.* namespace imports with using IronBarCode
4. Replace the entire RasterSupport.SetLicense initialization block with IronBarCode.License.LicenseKey = "key"
5. Remove all RasterSupport.KernelExpired checks
6. Remove all RasterSupport.IsLocked(RasterSupportType.*) checks
7. Remove all new BarcodeEngine() instantiations
8. Remove all new RasterCodecs() instantiations from barcode code paths
9. Replace codecs.Load(path) + engine.Reader.ReadBarcodes(image, ...) with BarcodeReader.Read(path)
10. Replace new BarcodeData(...) + new RasterImage(...) + FillCommand + WriteBarcode + codecs.Save() with BarcodeWriter.CreateBarcode(...).SaveAsPng(path)
11. Replace BarcodeSymbology.* enum references with BarcodeEncoding.* (note: QR becomes QRCode)
12. Remove COPY LEADTOOLS.LIC lines from all Dockerfiles
13. Remove LEADTOOLS_LICENSE_PATH and LEADTOOLS_DEVELOPER_KEY environment variable declarations from Dockerfiles and deployment configuration
14. Add IRONBARCODE_LICENSE environment variable to Dockerfiles and secrets configuration
15. Remove MSVC++ 2017 Runtime installation from Windows provisioning scripts

Post-Migration Testing

• Verify all barcode read operations return expected values across all symbology types previously covered by the BarcodeSymbology[] array
• Verify Code 128, QR code, and any other generated barcode types produce valid, scannable output
• Confirm PDF barcode extraction works correctly without Leadtools.Pdf
• Build and start the container image without mounting any .LIC file and confirm the application initializes correctly
• Run the CI/CD pipeline without the .LIC file provisioning step and confirm all stages complete successfully
• Verify the published output size and container image pull time have improved