La frontière fondamentale

La surface MAUI de Barkoder est liée à la caméra. Un développeur .NET utilisant Plugin.Maui.Barkoder écrit du code qui ressemble à ceci :

// dotnet add package Plugin.Maui.Barkoder
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.SetFlashEnabled(false);
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
            Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
    }
}

// dotnet add package Plugin.Maui.Barkoder
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.SetFlashEnabled(false);
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
            Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
    }
}

Imports Barkoder.Maui

Public Partial Class ScanPage
    Inherits ContentPage
    Implements IBarkoderDelegate

    Public Sub New()
        InitializeComponent()
        BarkoderView.SetFlashEnabled(False)
        BarkoderView.StartScanning(Me)
    End Sub

    Public Sub DidFinishScanning(result As BarcodeResult()) Implements IBarkoderDelegate.DidFinishScanning
        For Each r In result
            Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}")
        Next
    End Sub
End Class

IronBarcode fournit une API de fichiers / flux / PDF pour les mêmes données :

// dotnet add package BarCode
using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("scanned-label.png", options);
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format} | Value: {result.Value}");
}

// dotnet add package BarCode
using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("scanned-label.png", options);
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format} | Value: {result.Value}");
}

Imports IronBarCode

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

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.ExtremeDetail,
    .ExpectMultipleBarcodes = False
}

Dim results = BarcodeReader.Read("scanned-label.png", options)
For Each result In results
    Console.WriteLine($"Format: {result.Format} | Value: {result.Value}")
Next

Étape 1 : Remplacer le package NuGet

Installer IronBarcode:

dotnet add package BarCode

Si votre projet utilise Plugin.Maui.Barkoder ou Barkoder.Xamarin uniquement pour des flux de travail non basés sur la caméra (ou si vous passez complètement au traitement de fichiers / PDF), supprimez-le :

dotnet remove package Plugin.Maui.Barkoder

dotnet remove package Plugin.Maui.Barkoder

Si l'application a toujours besoin d'une interface utilisateur de caméra en direct, conservez Plugin.Maui.Barkoder et ajoutez Code-barres IronBarcode à côté pour le travail de génération de fichiers / PDF.

Étape 2 : Mise à jour des espaces de noms

Supprimez l'espace de noms barKoder là où il n'est plus nécessaire, et ajoutez l'espace de noms Code-barres IronBarcode :

// Remove (if no longer needed)
// using Barkoder.Maui;

// Add
using IronBarCode;

// Remove (if no longer needed)
// using Barkoder.Maui;

// Add
using IronBarCode;

Imports IronBarCode

Étape 3 : initialisation de la licence

Ajoutez l'initialisation de licence au démarrage de l'application — dans Program.cs pour ASP.NET Core, ou avant toute opération de code-barres dans les applications console ou de bureau :

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

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

Imports IronBarCode

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

Lecture des codes-barres à partir d'images

Le scénario de lecture de base est mappé des cadres de caméra en direct de barKoder à l'API de fichiers / flux / tableau[] d'IronBarcode.

Approche barKoder MAUI :

// dotnet add package Plugin.Maui.Barkoder
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
        {
            Console.WriteLine($"Barcode: {r.TextualData}");
            Console.WriteLine($"Type: {r.BarcodeTypeName}");
        }
    }
}

// dotnet add package Plugin.Maui.Barkoder
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
        {
            Console.WriteLine($"Barcode: {r.TextualData}");
            Console.WriteLine($"Type: {r.BarcodeTypeName}");
        }
    }
}

Imports Barkoder.Maui

Public Partial Class ScanPage
    Inherits ContentPage
    Implements IBarkoderDelegate

    Public Sub New()
        InitializeComponent()
        BarkoderView.StartScanning(Me)
    End Sub

    Public Sub DidFinishScanning(result As BarcodeResult()) Implements IBarkoderDelegate.DidFinishScanning
        For Each r In result
            Console.WriteLine($"Barcode: {r.TextualData}")
            Console.WriteLine($"Type: {r.BarcodeTypeName}")
        Next
    End Sub
End Class

Approche IronBarcode :

// dotnet add package BarCode
using IronBarCode;

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

var results = BarcodeReader.Read("scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
}

// dotnet add package BarCode
using IronBarCode;

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

var results = BarcodeReader.Read("scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
}

Imports IronBarCode

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

Dim results = BarcodeReader.Read("scan.png")
For Each result In results
    Console.WriteLine($"Format: {result.Format}")
    Console.WriteLine($"Value: {result.Value}")
Next

La fonction BarcodeReader.Read() d'IronBarcode détecte automatiquement le format de code-barres sans qu'il soit nécessaire de spécifier un format à l'avance. La même fonction s'applique aux images capturées par un appareil mobile et téléchargées sur un serveur, aux images chargées depuis un système de fichiers ou aux images reçues sous forme de tableaux d'octets à partir d'un flux. Pour une documentation complète sur la lecture, consultez le guide de lecture IronBarcode .

Récupération de codes-barres endommagés (équivalent du mode DeBlur)

Le mode DeBlur de Barkoder est l'une de ses fonctionnalités les plus citées. Code-barres IronBarcode fournit l'équivalent pour l'entrée de fichier via ReadingSpeed.ExtremeDetail.

Approche barKoder MAUI :

// Live camera scanning with DeBlur enabled via configuration
using Barkoder.Maui;

BarkoderView.SetEnabledBarcodeTypes(/* configure formats */);
BarkoderView.StartScanning(this);

public void DidFinishScanning(BarcodeResult[] result)
{
    foreach (var r in result)
        Console.WriteLine($"Recovered: {r.TextualData}");
}

// Live camera scanning with DeBlur enabled via configuration
using Barkoder.Maui;

BarkoderView.SetEnabledBarcodeTypes(/* configure formats */);
BarkoderView.StartScanning(this);

public void DidFinishScanning(BarcodeResult[] result)
{
    foreach (var r in result)
        Console.WriteLine($"Recovered: {r.TextualData}");
}

Imports Barkoder.Maui

' Live camera scanning with DeBlur enabled via configuration
BarkoderView.SetEnabledBarcodeTypes() ' configure formats
BarkoderView.StartScanning(Me)

Public Sub DidFinishScanning(result As BarcodeResult())
    For Each r In result
        Console.WriteLine($"Recovered: {r.TextualData}")
    Next
End Sub

Approche IronBarcode :

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered barcode: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered barcode: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

Imports IronBarCode

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

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.ExtremeDetail,
    .ExpectMultipleBarcodes = False
}

Dim results = BarcodeReader.Read("worn-shipping-label.png", options)

If results.Any() Then
    Console.WriteLine($"Recovered barcode: {results.First().Value}")
Else
    Console.WriteLine("Could not decode — image quality too low")
End If

ReadingSpeed.ExtremeDetail exécute un pipeline d'analyse d'image basé sur ML en plusieurs passes, appliquant l'amélioration du contraste, l'accentuation, la correction de rotation et la récupération des dommages avant d'essayer de décoder. Pour les flux de travail par lots, utilisez ReadingSpeed.Balanced par défaut et revenez à ExtremeDetail uniquement pour les images que Balanced échoue à décoder.

Détection de plusieurs codes-barres

La numérisation en trame multi-code-barres de Barkoder est mappée à l'option ExpectMultipleBarcodes d'IronBarcode, qui fonctionne aussi bien sur les images que sur les PDF.

Approche barKoder MAUI :

// Live camera frame returns BarcodeResult[]; multi-scan configured on the view
using Barkoder.Maui;

BarkoderView.StartScanning(this);

public void DidFinishScanning(BarcodeResult[] result)
{
    foreach (var r in result)
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
}

// Live camera frame returns BarcodeResult[]; multi-scan configured on the view
using Barkoder.Maui;

BarkoderView.StartScanning(this);

public void DidFinishScanning(BarcodeResult[] result)
{
    foreach (var r in result)
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
}

Imports Barkoder.Maui

BarkoderView.StartScanning(Me)

Public Sub DidFinishScanning(result As BarcodeResult())
    For Each r In result
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}")
    Next
End Sub

Approche IronBarcode :

using IronBarCode;

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

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

// Works identically on images and PDFs
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}");
}

using IronBarCode;

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

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

// Works identically on images and PDFs
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}");
}

Imports IronBarCode

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

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

' Works identically on images and PDFs
Dim results = BarcodeReader.Read("shipping-manifest.pdf", options)

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}")
Next

Il s'agit d'un appel de méthode unique. Aucune extraction de page, aucune requête multiple, aucun traitement supplémentaire par code-barres. Le PDF est lu nativement.

Génération et lecture de DataMatrix

Barkoder lit DataMatrix mais ne peut pas la générer. Code-barres IronBarcode couvre les deux aspects du flux de travail, ce qui est une exigence courante dans les systèmes de suivi industriels.

Approche barKoder MAUI :

// Camera-only DataMatrix scanning; no generation available
using Barkoder.Maui;

BarkoderView.StartScanning(this);

public void DidFinishScanning(BarcodeResult[] result)
{
    foreach (var r in result)
        Console.WriteLine($"Part ID: {r.TextualData}");
}

// Camera-only DataMatrix scanning; no generation available
using Barkoder.Maui;

BarkoderView.StartScanning(this);

public void DidFinishScanning(BarcodeResult[] result)
{
    foreach (var r in result)
        Console.WriteLine($"Part ID: {r.TextualData}");
}

Imports Barkoder.Maui

' Camera-only DataMatrix scanning; no generation available
BarkoderView.StartScanning(Me)

Public Sub DidFinishScanning(result As BarcodeResult())
    For Each r In result
        Console.WriteLine($"Part ID: {r.TextualData}")
    Next
End Sub

Approche IronBarcode :

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-SN-20240315-A42291", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Read DataMatrix from a scanned industrial part image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("etched-part-photo.png", options);
foreach (var result in results)
{
    Console.WriteLine($"Part Serial: {result.Value}");
    Console.WriteLine($"Barcode Type: {result.Format}");
}

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-SN-20240315-A42291", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Read DataMatrix from a scanned industrial part image
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("etched-part-photo.png", options);
foreach (var result in results)
{
    Console.WriteLine($"Part Serial: {result.Value}");
    Console.WriteLine($"Barcode Type: {result.Format}");
}

Imports IronBarCode

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

' Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-SN-20240315-A42291", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("part-label.png")

' Read DataMatrix from a scanned industrial part image
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.ExtremeDetail,
    .ExpectMultipleBarcodes = False
}

Dim results = BarcodeReader.Read("etched-part-photo.png", options)
For Each result In results
    Console.WriteLine($"Part Serial: {result.Value}")
    Console.WriteLine($"Barcode Type: {result.Format}")
Next

Pour obtenir la liste complète des formats d'encodage pris en charge et des options de génération, consultez la documentation de génération de codes-barres IronBarcode .

Génération de codes QR avec personnalisation

Barkoder ne génère pas de codes-barres. Code-barres IronBarcode génère des codes QR avec logos intégrés, ce qui est une exigence courante pour les processus de marketing, d'emballage et d'identification des produits.

Approche barKoder MAUI :

Not available — Plugin.Maui.Barkoder is a reader-only SDK with no
generation API on any platform.

Approche IronBarcode :

using IronBarCode;

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

// QR code with brand logo embedded at centre
QRCodeWriter.CreateQrCode("https://parts.example.com/product/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

using IronBarCode;

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

// QR code with brand logo embedded at centre
QRCodeWriter.CreateQrCode("https://parts.example.com/product/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

Imports IronBarCode

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

' QR code with brand logo embedded at centre
QRCodeWriter.CreateQrCode("https://parts.example.com/product/A42", 500) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("branded-qr.png")

Point de terminaison de l'API de code-barres ASP.NET Core

Barkoder ne possède pas de modèle de déploiement côté serveur. L'équivalent d'un point de terminaison de téléchargement de numérisation mobile — recevant une image de n'importe quel client et renvoyant des données de code-barres — nécessite une bibliothèque .NET .

Approche barKoder :

Not available — Plugin.Maui.Barkoder runs only inside a MAUI app head
against a live camera. There is no ASP.NET Core integration and no
server-side execution model.

Approche IronBarcode :

// In Program.cs
using IronBarCode;

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

app.MapPost("/api/scan", async (IFormFile file) =>
{
    using var stream = file.OpenReadStream();
    var imageBytes = new byte[stream.Length];
    await stream.ReadAsync(imageBytes);

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

    var results = BarcodeReader.Read(imageBytes, options);

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

// In Program.cs
using IronBarCode;

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

app.MapPost("/api/scan", async (IFormFile file) =>
{
    using var stream = file.OpenReadStream();
    var imageBytes = new byte[stream.Length];
    await stream.ReadAsync(imageBytes);

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

    var results = BarcodeReader.Read(imageBytes, options);

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

Imports IronBarCode

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

app.MapPost("/api/scan", Async Function(file As IFormFile) As Task(Of IResult)
    Using stream = file.OpenReadStream()
        Dim imageBytes(CInt(stream.Length) - 1) As Byte
        Await stream.ReadAsync(imageBytes, 0, imageBytes.Length)

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

        Dim results = BarcodeReader.Read(imageBytes, options)

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

Problème 1 : Noms des paquets NuGet

barKoder SDK : Les packages .NET officiels sont Plugin.Maui.Barkoder et Barkoder.Xamarin. Aucun ne couvre les scénarios non-mobiles.

Solution: Installer IronBarcode:

dotnet add package BarCode

Si Plugin.Maui.Barkoder n'est plus nécessaire (vous passez complètement au traitement de fichiers / PDF / serveur), éliminez-le :

dotnet remove package Plugin.Maui.Barkoder
dotnet add package BarCode

dotnet remove package Plugin.Maui.Barkoder
dotnet add package BarCode

Problème 2 : Entrée de cadre caméra vs Entrée de fichier

SDK barKoder : Tous les entrées arrivent sous forme de cadre de caméra en continu — un flux vidéo traité en continu sur l'appareil. Il n'y a pas de mode d'entrée de chemin de fichier.

Solution : Code-barres IronBarcode accepte les fichiers, les flux, les tableaux d'octets et les objets System.Drawing.Image. Pour les images téléchargées depuis un client mobile, lisez directement le flux de requêtes :

using var stream = file.OpenReadStream();
var imageBytes = new byte[stream.Length];
await stream.ReadAsync(imageBytes);
var results = BarcodeReader.Read(imageBytes, options);

using var stream = file.OpenReadStream();
var imageBytes = new byte[stream.Length];
await stream.ReadAsync(imageBytes);
var results = BarcodeReader.Read(imageBytes, options);

Imports System.IO

Using stream = file.OpenReadStream()
    Dim imageBytes = New Byte(stream.Length - 1) {}
    Await stream.ReadAsync(imageBytes, 0, imageBytes.Length)
    Dim results = BarcodeReader.Read(imageBytes, options)
End Using

Problème 3 : API basée sur les rappels vs résultat synchrone

barKoder SDK : BarkoderView.StartScanning(IBarkoderDelegate) utilise un modèle de délégué / rappel — DidFinishScanning(BarcodeResult[]) se déclenche de manière asynchrone lorsque des codes-barres sont détectés dans le flux de la caméra.

Solution : BarcodeReader.Read() d'IronBarcode est synchrone et retourne un IEnumerable<BarcodeResult> directement. Dans les contextes ASP.NET Core où l'asynchrone est requis, enveloppez dans Task.Run() :

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

Dim results = Await Task.Run(Function() BarcodeReader.Read(imageBytes, options))

Problème 4 : Configuration du mode de débruitage

barKoder SDK : DeBlur est activé sur la configuration BarkoderView avant le début de la numérisation et s'applique à toutes les numérisations suivantes.

Solution : Dans IronBarcode, l'équivalent est ReadingSpeed.ExtremeDetail défini par lecture via BarcodeReaderOptions. Créez l'objet d'options une seule fois et réutilisez-le :

var deepOptions = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

// Reuse across multiple reads
var results = BarcodeReader.Read("image.png", deepOptions);

var deepOptions = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

// Reuse across multiple reads
var results = BarcodeReader.Read("image.png", deepOptions);

Imports System

Dim deepOptions As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.ExtremeDetail,
    .ExpectMultipleBarcodes = False
}

' Reuse across multiple reads
Dim results = BarcodeReader.Read("image.png", deepOptions)

Problème 5 : Capacité de génération manquante

SDK barKoder : Barkoder est en lecture seule. Il n'existe pas d'API pour générer des codes-barres ou des codes QR.

Solution : Code-barres IronBarcode prend en charge à la fois la lecture et la génération. Utilisez BarcodeWriter pour les formats standards et QRCodeWriter pour les QR codes :

// Standard barcode generation
BarcodeWriter.CreateBarcode("SHIP-20240315-00428", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

// QR code generation
QRCodeWriter.CreateQrCode("https://example.com/product/A42", 500)
    .SaveAsPng("product-qr.png");

// Get as bytes for embedding in API response or PDF
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("INV-100291", BarcodeEncoding.Code128)
    .ToPngBinaryData();

// Standard barcode generation
BarcodeWriter.CreateBarcode("SHIP-20240315-00428", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

// QR code generation
QRCodeWriter.CreateQrCode("https://example.com/product/A42", 500)
    .SaveAsPng("product-qr.png");

// Get as bytes for embedding in API response or PDF
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("INV-100291", BarcodeEncoding.Code128)
    .ToPngBinaryData();

Imports System

' Standard barcode generation
BarcodeWriter.CreateBarcode("SHIP-20240315-00428", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

' QR code generation
QRCodeWriter.CreateQrCode("https://example.com/product/A42", 500) _
    .SaveAsPng("product-qr.png")

' Get as bytes for embedding in API response or PDF
Dim barcodeBytes As Byte() = BarcodeWriter.CreateBarcode("INV-100291", BarcodeEncoding.Code128) _
    .ToPngBinaryData()

Tâches préalables à la migration

Auditez votre codebase pour les références barKoder :

grep -r "Barkoder\|BarkoderView\|IBarkoderDelegate\|BarcodeResult" --include="*.cs" .
grep -r "Plugin.Maui.Barkoder\|Barkoder.Xamarin" --include="*.csproj" .
grep -r "Barkoder" --include="*.xaml" .

grep -r "Barkoder\|BarkoderView\|IBarkoderDelegate\|BarcodeResult" --include="*.cs" .
grep -r "Plugin.Maui.Barkoder\|Barkoder.Xamarin" --include="*.csproj" .
grep -r "Barkoder" --include="*.xaml" .

Documenter les scénarios de codes-barres actuellement mis en œuvre ou prévus :

• Quels formats de codes-barres doivent être lus (Code128, DataMatrix, QR, PDF417, etc.)
• Si la récupération de code-barres endommagé est requise (ReadingSpeed.ExtremeDetail)
• Si la détection multi-code-barres est requise (ExpectMultipleBarcodes = true)
• Si la génération de code-barres est requise (BarcodeWriter, QRCodeWriter)
• Si le traitement des PDF est requis (BarcodeReader.Read("doc.pdf"))
• Cibles de déploiement (ASP.NET Core, Azure Functions, Docker, Lambda, application de bureau, MAUI)

Tâches de mise à jour du code

1. Supprimez Plugin.Maui.Barkoder ou Barkoder.Xamarin de .csproj là où ce n'est plus nécessaire
2. Installez le package NuGet BarCode
3. Supprimez using Barkoder.Maui; (ou l'équivalent Xamarin) là où ce n'est plus nécessaire
4. Ajoutez using IronBarCode; à tous les fichiers de traitement de code-barres
5. Ajoutez IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; au démarrage de l'application
6. Remplacez les rappels BarkoderView.StartScanning / DidFinishScanning par BarcodeReader.Read(filePath, options)
7. Mettez en correspondance BarcodeResult.TextualData avec result.Value
8. Mettez en correspondance BarcodeResult.BarcodeTypeName avec result.Format
9. Mettez en correspondance la configuration DeBlur avec Speed = ReadingSpeed.ExtremeDetail dans BarcodeReaderOptions
10. Mettez en correspondance la configuration multi-scan avec ExpectMultipleBarcodes = true dans BarcodeReaderOptions
11. Ajoutez des appels BarcodeWriter.CreateBarcode() pour tout besoin de génération
12. Ajoutez des appels QRCodeWriter.CreateQrCode() pour les besoins de génération de QR codes
13. Remplacez tout code de prétraitement PDF par BarcodeReader.Read("document.pdf")
14. Enveloppez les appels BarcodeReader.Read() synchrones dans Task.Run() pour les points de terminaison asynchrones ASP.NET Core

Test de post-migration

Après avoir effectué les mises à jour du code, vérifiez les points suivants :

• Confirmez que BarcodeReader.Read() retourne des résultats pour tous les formats d'image utilisés (PNG, JPEG, TIFF, BMP)
• Vérifiez que ReadingSpeed.ExtremeDetail récupère les codes-barres à partir des échantillons de la plus basse qualité de votre jeu de test
• Confirmez que ExpectMultipleBarcodes = true retourne le bon nombre de codes-barres à partir de documents multi-code-barres
• Tester la lecture des fichiers PDF avec toutes les versions PDF utilisées dans les flux de production documentaire.
• Vérifiez que la sortie de BarcodeWriter.CreateBarcode() est scannable par vos lecteurs cibles
• Vérifiez que la sortie de QRCodeWriter.CreateQrCode() est scannable par les lecteurs de QR codes mobiles
• Tester le point de terminaison ASP.NET Core (le cas échéant) avec des téléchargements de fichiers depuis des clients mobiles
• Vérifier le bon fonctionnement dans les cibles de déploiement Docker, Azure ou Lambda
• Exécuter des tests de bout en bout couvrant l'intégralité du cycle lecture-traitement-génération, le cas échéant.