Le problème fondamental

La séquence d'initialisation de LEADTOOLSnécessite plus de 20 lignes et quatre étapes de vérification avant qu'un BarcodeEngine puisse être créé. Code-barres IronBarcode remplace toute la séquence par une seule affectation :

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

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    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.Barcode1DRead))
    throw new InvalidOperationException("1D barcode reading is locked");

if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead))
    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.Barcode1DRead) Then
    Throw New InvalidOperationException("1D barcode reading is locked")
End If

If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) 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")

Étape 1 : Supprimer les packages LEADTOOLS

Supprimez tous les packages LEADTOOLSdu projet :

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

Si le codec PDF a été ajouté pour l'extraction des codes-barres à partir des fichiers PDF :

dotnet remove package Leadtools.Pdf

dotnet remove package Leadtools.Pdf

Sur les déploiements Windows Server, le runtime MSVC++ 2017 peut être supprimé des scripts de provisionnement une fois la migration terminée. Code-barres IronBarcode ne présente aucune dépendance d'exécution native sur aucune plateforme.

Étape 2 : Installer IronBarcode

dotnet add package IronBarcode

dotnet add package IronBarcode

Ce package unique inclut la prise en charge de tous les formats d'image, l'extraction native des codes-barres PDF, la correction d'erreurs ML et plus de 50 symbologies prises en charge. Aucun pack de codecs supplémentaire n'est requis.

Étape 3 : Initialiser la licence

Remplacez l'ensemble du bloc d'initialisation LEADTOOLSpar une seule ligne. Localisez chaque appel à RasterSupport.SetLicense dans la base de code — il y en aura généralement un seul, au démarrage de l'application — et remplacez toute la séquence d'initialisation environnante :

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

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

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

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

Imports IronBarCode

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

La clé de licence peut être fournie par tout mécanisme de configuration capable de chaîne de caractères : une variable d'environnement, appsettings.json, Azure Key Vault, AWS Secrets Manager ou un secret Kubernetes. Pour la configuration des licences en fonction de l'environnement, les modèles de déploiement Docker et toutes les approches de configuration prises en charge, consultez la documentation relative à la configuration des clés de licence .

Lecture des codes-barres à partir d'images

LEADTOOLS sépare le chargement d'images et la lecture de codes-barres en deux couches d'objets distinctes. Une instance RasterCodecs charge le fichier image dans un RasterImage, et une instance BarcodeEngine le scanne. L'appelant doit également fournir un tableau explicite de valeurs BarcodeSymbology ; Les formats non répertoriés dans le tableau ne seront pas détectés.

Approche LEADTOOLS :

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

Approche IronBarcode :

using IronBarCode;

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

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

using IronBarCode;

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

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

Imports IronBarCode

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

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

IronBarcode accepte directement le chemin d'accès au fichier, charge l'image en interne et détecte automatiquement les formats parmi plus de 50 symbologies prises en charge, sans que l'utilisateur ait à préciser les types attendus. Pour une configuration avancée (optimisation de la vitesse de lecture, détection de plusieurs codes-barres et gestion des images de faible qualité), consultez le guide de lecture des codes-barres à partir d'images .

Générer un code-barres Code 128

La génération LEADTOOLSnécessite la construction d'un objet BarcodeData, l'allocation d'un RasterImage vierge avec des indicateurs de mémoire explicites, profondeur de pixel et ordre des octets, le remplissage de l'image avec une couleur de fond, l'écriture du code-barres sur celle-ci, puis la sauvegarde avec RasterCodecs. Code-barres IronBarcode réalise toutes ces étapes grâce à une seule chaîne de méthodes fluides.

Approche LEADTOOLS :

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

Approche IronBarcode :

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

Pour une présentation complète du dimensionnement, du style, du contrôle des marges et des formats de sortie pris en charge, consultez la section création d'images de codes-barres .

Générer un code QR avec logo

La génération de code QR LEADTOOLSsuit le même motif de construction RasterImage en plusieurs étapes que les autres types de code-barres. Code-barres IronBarcode fournit QRCodeWriter avec une méthode dédiée AddBrandLogo pour intégrer un logo au centre d'un code QR.

Approche LEADTOOLS :

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

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

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

Approche IronBarcode :

using IronBarCode;

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

using IronBarCode;

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

Imports IronBarCode

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

Extraction des codes-barres à partir de documents PDF

L'extraction de code-barres PDF LEADTOOLSnécessite le package séparé Leadtools.Pdf, une configuration de chargement PDF explicite, une requête de comptage de pages manuelle, et une boucle sur chaque page. Chaque page doit être chargée individuellement en tant que RasterImage avant le balayage. Code-barres IronBarcode inclut la prise en charge des fichiers PDF dans son package de base et gère l'itération des pages en interne.

Approche LEADTOOLS :

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

Approche IronBarcode :

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

Déploiement Docker

L'exigence de gestion des fichiers qui définit chaque déploiement Docker LEADTOOLSest entièrement éliminée lors de la migration vers IronBarcode.

Approche LEADTOOLS :

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

Approche IronBarcode :

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

WORKDIR /app
COPY publish/ .

ENV IRONBARCODE_LICENSE=your-license-key

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

La clé de licence est injectée lors de l'exécution du conteneur via les secrets Docker, les secrets Kubernetes ou tout autre mécanisme de variable d'environnement. Aucune étape de provisionnement de fichiers n'est requise. Le guide de déploiement Docker et Linux couvre les images de base Alpine et Debian, les builds multi-étapes et les modèles de déploiement Kubernetes.

Problème n° 1 : Références aux fichiers .LIC dans l'intégration continue/le déploiement continu (CI/CD)

LEADTOOLS : Les pipelines CI/CD qui créent ou déploient des applications LEADTOOLSdoivent prévoir le fichier .LIC — soit en le vérifiant dans le contrôle de version, en le décodant à partir d'un secret base64, ou en le montant en tant qu'artéfact de volume. Chaque étape du pipeline qui exécute l'application a besoin que le fichier soit accessible.

Solution : Supprimez toute gestion de fichier .LIC du pipeline. Remplacez par un secret en chaîne :

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

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

La valeur de chaîne est stockée dans le magasin de secrets CI/CD avec d'autres informations d'identification de type chaîne. Aucun décodage de fichier, aucun provisionnement d'artefacts, aucune configuration de volume n'est requis.

Problème n° 2 : Dépendance de l'environnement d'exécution MSVC++ sous Windows

LEADTOOLS : Les déploiements sur Windows Server nécessitent l'installation du runtime MSVC++ 2017 sur l'hôte. Les scripts de provisionnement, les images de base des conteneurs et les AMI Windows utilisés pour les déploiements LEADTOOLSincluent généralement une étape d'installation de ce runtime.

Solution : Supprimez l'étape d'installation de MSVC++ 2017 Runtime de tous les scripts de provisionnement Windows et des images de conteneur. Code-barres IronBarcode ne dépend d'aucune dépendance d'exécution native. L'image de base dotnet/aspnet est suffisante sans packages d'exécution supplémentaires.

Problème 3 : Vérifications du verrouillage des fonctionnalités RasterSupportType

LEADTOOLS : La séquence d'initialisation inclut les vérifications RasterSupport.IsLocked() pour chaque fonctionnalité de code-barres — Barcodes1D, Barcodes2D et BarcodeWrite. Ces contrôles constituent un code de défense requis par l'architecture LEADTOOLSpour vérifier que le fichier de licence couvre chaque fonctionnalité requise.

Solution : Supprimez tous les appels RasterSupport.IsLocked(). Code-barres IronBarcode inclut toutes les fonctionnalités de lecture et d'écriture dans une seule licence. Il n'existe pas d'états de verrouillage par fonctionnalité et aucune étape de vérification des fonctionnalités n'est nécessaire :

// Remove these lines entirely:
// if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)) ...

// Remove these lines entirely:
// if (RasterSupport.IsLocked(RasterSupportType.Barcode1DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.Barcode2DRead)) ...
// if (RasterSupport.IsLocked(RasterSupportType.BarcodeWrite)) ...

' Remove these lines entirely:
' If RasterSupport.IsLocked(RasterSupportType.Barcode1DRead) ...
' If RasterSupport.IsLocked(RasterSupportType.Barcode2DRead) ...
' If RasterSupport.IsLocked(RasterSupportType.BarcodeWrite) ...

Problème 4 : Suppression du tableau de symboles de codes-barres

LEADTOOLS : Chaque appel à engine.Reader.ReadBarcodes() nécessite un paramètre BarcodeSymbology[] explicite. Les codes-barres dont la symbologie ne figure pas dans le tableau ne seront pas détectés, ce qui peut entraîner des lectures manquées silencieuses lorsqu'un nouveau type de code-barres est introduit dans un document d'entrée.

Solution : Supprimez le tableau de symbologie. BarcodeReader.Read() détecte automatiquement tous les formats pris en charge. Si un ajustement des performances est nécessaire pour un ensemble de formats connus, BarcodeReaderOptions fournit des indices optionnels sans nécessiter d'énumération exhaustive :

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

Tâches préalables à la migration

Avant d'apporter des modifications, vérifiez l'ensemble de l'utilisation de LEADTOOLSdans le code source :

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

Documentez le nombre et l'emplacement des blocs d'initialisation, des sites d'appels de lecture, des sites d'appels d'écriture et des références Dockerfile avant de commencer les modifications de code.

Tâches de mise à jour du code

1. Supprimez les cinq packages NuGet LEADTOOLS(et le codec PDF s'il est présent).
2. Installez IronBarcode via dotnet add package IronBarcode
3. Remplacez toutes les importations de namespace using Leadtools.* par using IronBarCode
4. Remplacez l'ensemble du bloc d'initialisation RasterSupport.SetLicense par IronBarCode.License.LicenseKey = "key"
5. Supprimez toutes les vérifications RasterSupport.KernelExpired
6. Supprimez toutes les vérifications RasterSupport.IsLocked(RasterSupportType.*)
7. Supprimez toutes les instanciations new BarcodeEngine()
8. Supprimez toutes les instanciations new RasterCodecs() des chemins de code des code-barres
9. Remplacez codecs.Load(path) + engine.Reader.ReadBarcodes(image, ...) par BarcodeReader.Read(path)
10. Remplacez new BarcodeData(...) + new RasterImage(...) + FillCommand + WriteBarcode + codecs.Save() par BarcodeWriter.CreateBarcode(...).SaveAsPng(path)
11. Remplacez les références d'enum BarcodeSymbology.* par BarcodeEncoding.* (note : QR devient QRCode)
12. Supprimez les lignes COPY LEADTOOLS.LIC de tous les Dockerfiles
13. Supprimez les déclarations de variables d'environnement LEADTOOLS_LICENSE_PATH et LEADTOOLS_DEVELOPER_KEY des Dockerfiles et de la configuration de déploiement
14. Ajoutez la variable d'environnement IRONBARCODE_LICENSE aux Dockerfiles et à la configuration des secrets
15. Supprimez l'installation de MSVC++ 2017 Runtime des scripts de provisionnement Windows

Test de post-migration

• Vérifiez que toutes les opérations de lecture de code-barres renvoient les valeurs attendues pour tous les types de symbologie précédemment couverts par le tableau BarcodeSymbology[]
• Vérifiez que les codes 128, les codes QR et tout autre type de code-barres généré produisent un résultat valide et scannable.
• Confirmez que l'extraction de code-barres PDF fonctionne correctement sans Leadtools.Pdf
• Construisez et démarrez l'image du conteneur sans monter de fichier .LIC et confirmez que l'application s'initialise correctement
• Exécutez le pipeline CI/CD sans l'étape de provisionnement de fichier .LIC et confirmez que toutes les étapes se terminent avec succès
• Vérifiez que la taille de sortie publiée et le temps d'extraction de l'image conteneur se sont améliorés.