Le problème fondamental

Le kit de développement logiciel Scanbot nécessite un flux vidéo en direct. Lorsque les exigences s'étendent au-delà du mobile, il n'existe pas de chemin équivalent à travers la dépendance existante :

// Scanbot SDK: camera-only — no file or server equivalent exists
var configuration = new BarcodeScannerScreenConfiguration
{
    BarcodeFormats = new[] { BarcodeFormat.Code128, BarcodeFormat.QrCode }
};

// This call requires iOS or Android hardware and a MAUI camera UI
// It cannot be redirected to a file path, stream, or server context
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

// Scanbot SDK: camera-only — no file or server equivalent exists
var configuration = new BarcodeScannerScreenConfiguration
{
    BarcodeFormats = new[] { BarcodeFormat.Code128, BarcodeFormat.QrCode }
};

// This call requires iOS or Android hardware and a MAUI camera UI
// It cannot be redirected to a file path, stream, or server context
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

Imports System.Threading.Tasks

' Scanbot SDK: camera-only — no file or server equivalent exists
Dim configuration As New BarcodeScannerScreenConfiguration With {
    .BarcodeFormats = {BarcodeFormat.Code128, BarcodeFormat.QrCode}
}

' This call requires iOS or Android hardware and a MAUI camera UI
' It cannot be redirected to a file path, stream, or server context
Dim result = Await ScanbotSDKMain.Barcode.StartScannerAsync(configuration)

IronBarcode accepte les mêmes types de sources (fichier, flux, tableau d'octets ou PDF) dans n'importe quel contexte de projet :

// IronBarcode: the same call works in MAUI, ASP.NET Core, console, WPF, Azure Functions
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// From a file — works on any platform
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.BarcodeType})");

// IronBarcode: the same call works in MAUI, ASP.NET Core, console, WPF, Azure Functions
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// From a file — works on any platform
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.BarcodeType})");

Imports IronBarCode

' IronBarcode: the same call works in MAUI, ASP.NET Core, console, WPF, Azure Functions
License.LicenseKey = "YOUR-LICENSE-KEY"

' From a file — works on any platform
Dim results = BarcodeReader.Read("invoice.pdf")
For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.BarcodeType})")
Next

Étape 1 : Remplacer le package NuGet

Supprimez le package Scanbot :

dotnet remove package ScanbotBarcodeSDK.MAUI

dotnet remove package ScanbotBarcodeSDK.MAUI

Si le projet utilise des références de package conditionnelles dans le fichier .csproj, supprimez également ces entrées :

<PackageReference Include="ScanbotBarcodeSDK.MAUI" Version="8.0.0" />

<PackageReference Include="ScanbotBarcodeSDK.MAUI" Version="8.0.0" />

Installer IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

IronBarcode est disponible sur NuGet et prend en charge .NET 6, 7, 8, 9 et .NET Framework 4.6.2+. Pour un projet multi-cible MAUI, un seul dotnet add package fonctionne pour toutes les cibles — aucune référence de package conditionnelle à la plateforme n'est nécessaire.

Étape 2 : Mise à jour des espaces de noms

Remplacez les espaces de noms Scanbot par l'espace de noms IronBarcode :

// Remove
using ScanbotSDK.MAUI;

// Add
using IronBarCode;

// Remove
using ScanbotSDK.MAUI;

// Add
using IronBarCode;

Imports IronBarCode

Étape 3 : initialisation de la licence

Supprimez le bloc d'initialisation du Scanbot et remplacez-le par la clé de licence Code-barres IronBarcode . Ajoutez l'initialisation de la licence au démarrage de l'application dans MauiProgram.cs, App.xaml.cs, ou Program.cs en fonction du type de projet :

// Remove this
ScanbotSDKMain.Initialize(new SdkConfiguration
{
    LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
    LoggingEnabled = false
});

// Add this — one line, placed once at startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Remove this
ScanbotSDKMain.Initialize(new SdkConfiguration
{
    LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
    LoggingEnabled = false
});

// Add this — one line, placed once at startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Remove this
ScanbotSDKMain.Initialize(New SdkConfiguration With {
    .LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
    .LoggingEnabled = False
})

' Add this — one line, placed once at startup
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Capture de photos MAUI

L'appel de numérisation de Scanbot ouvre une interface utilisateur de caméra en plein écran et revient à la normale lorsque l'utilisateur scanne un code-barres ou annule. Code-barres IronBarcode ne fournit pas d'interface utilisateur pour la caméra ; le remplacement utilise MediaPicker de MAUI pour invoquer la caméra du système, capturer une photo et passer les octets de l'image à BarcodeReader.Read().

Approche du kit de développement logiciel Scanbot :

using ScanbotSDK.MAUI;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var configuration = new BarcodeScannerScreenConfiguration
    {
        BarcodeFormats = new[]
        {
            BarcodeFormat.Code128,
            BarcodeFormat.QrCode,
            BarcodeFormat.Ean13
        },
        FinderAspectRatio = new AspectRatio(1, 1),
        TopBarBackgroundColor = Colors.DarkBlue
    };

    var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

    if (result.Status == OperationResult.Ok)
    {
        foreach (var barcode in result.Barcodes)
            ResultLabel.Text = $"{barcode.Format}: {barcode.Text}";
    }
}

using ScanbotSDK.MAUI;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var configuration = new BarcodeScannerScreenConfiguration
    {
        BarcodeFormats = new[]
        {
            BarcodeFormat.Code128,
            BarcodeFormat.QrCode,
            BarcodeFormat.Ean13
        },
        FinderAspectRatio = new AspectRatio(1, 1),
        TopBarBackgroundColor = Colors.DarkBlue
    };

    var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

    if (result.Status == OperationResult.Ok)
    {
        foreach (var barcode in result.Barcodes)
            ResultLabel.Text = $"{barcode.Format}: {barcode.Text}";
    }
}

Imports ScanbotSDK.MAUI

Private Async Sub ScanButton_Clicked(sender As Object, e As EventArgs)
    Dim configuration = New BarcodeScannerScreenConfiguration With {
        .BarcodeFormats = New BarcodeFormat() {
            BarcodeFormat.Code128,
            BarcodeFormat.QrCode,
            BarcodeFormat.Ean13
        },
        .FinderAspectRatio = New AspectRatio(1, 1),
        .TopBarBackgroundColor = Colors.DarkBlue
    }

    Dim result = Await ScanbotSDKMain.Barcode.StartScannerAsync(configuration)

    If result.Status = OperationResult.Ok Then
        For Each barcode In result.Barcodes
            ResultLabel.Text = $"{barcode.Format}: {barcode.Text}"
        Next
    End If
End Sub

Approche IronBarcode :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    var first = results.FirstOrDefault();
    ResultLabel.Text = first != null
        ? $"{first.BarcodeType}: {first.Value}"
        : "No barcode found";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    var first = results.FirstOrDefault();
    ResultLabel.Text = first != null
        ? $"{first.BarcodeType}: {first.Value}"
        : "No barcode found";
}

Imports IronBarCode
Imports System.IO
Imports System.Linq
Imports System.Threading.Tasks

Private Async Sub ScanButton_Clicked(sender As Object, e As EventArgs)
    Dim photo = Await MediaPicker.CapturePhotoAsync()
    If photo Is Nothing Then Return

    Using stream = Await photo.OpenReadAsync()
        Using ms As New MemoryStream()
            Await stream.CopyToAsync(ms)

            Dim results = BarcodeReader.Read(ms.ToArray())
            Dim first = results.FirstOrDefault()
            ResultLabel.Text = If(first IsNot Nothing, $"{first.BarcodeType}: {first.Value}", "No barcode found")
        End Using
    End Using
End Sub

La modification de l'expérience utilisateur consiste à afficher l'écran de la caméra système plutôt que le viseur intégré du Scanbot avec une zone de numérisation superposée. Pour les applications professionnelles (inventaire, logistique, flux de documents), la caméra du système est adéquate. Le tutoriel sur le lecteur de codes-barres .NET MAUI couvre le modèle d'intégration complet pour les cibles iOS et Android, y compris la gestion des autorisations.

Options et configuration de numérisation

Le BarcodeScannerScreenConfiguration de Scanbot contrôle quels formats le scanner accepte et comment l'interface utilisateur de la caméra se présente. Le BarcodeReaderOptions d'IronBarcode contrôle comment l'image est analysée — vitesse de traitement, détection de plusieurs codes-barres et paramètres similaires. Les concepts de configuration correspondent à des problématiques différentes car les opérations sous-jacentes sont différentes.

Approche du kit de développement logiciel Scanbot :

var configuration = new BarcodeScannerScreenConfiguration
{
    BarcodeFormats = new[] { BarcodeFormat.Code128, BarcodeFormat.QrCode },
    FinderAspectRatio = new AspectRatio(1, 1),
    FlashEnabled = false,
    OrientationLockMode = OrientationLockMode.Portrait
};

var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.Status == OperationResult.Ok)
{
    foreach (var barcode in result.Barcodes)
        Console.WriteLine($"{barcode.Format}: {barcode.Text}");
}

var configuration = new BarcodeScannerScreenConfiguration
{
    BarcodeFormats = new[] { BarcodeFormat.Code128, BarcodeFormat.QrCode },
    FinderAspectRatio = new AspectRatio(1, 1),
    FlashEnabled = false,
    OrientationLockMode = OrientationLockMode.Portrait
};

var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.Status == OperationResult.Ok)
{
    foreach (var barcode in result.Barcodes)
        Console.WriteLine($"{barcode.Format}: {barcode.Text}");
}

Imports System
Imports System.Threading.Tasks

Dim configuration As New BarcodeScannerScreenConfiguration With {
    .BarcodeFormats = {BarcodeFormat.Code128, BarcodeFormat.QrCode},
    .FinderAspectRatio = New AspectRatio(1, 1),
    .FlashEnabled = False,
    .OrientationLockMode = OrientationLockMode.Portrait
}

Dim result = Await ScanbotSDKMain.Barcode.StartScannerAsync(configuration)

If result.Status = OperationResult.Ok Then
    For Each barcode In result.Barcodes
        Console.WriteLine($"{barcode.Format}: {barcode.Text}")
    Next
End If

Approche IronBarcode :

using IronBarCode;

// Format detection is automatic — BarcodeReaderOptions controls processing behavior
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = false
};

// Combined with the MediaPicker capture pattern
var photo = await MediaPicker.CapturePhotoAsync();
if (photo == null) return;

using var photoStream = await photo.OpenReadAsync();
using var ms = new MemoryStream();
await photoStream.CopyToAsync(ms);

var results = BarcodeReader.Read(ms.ToArray(), options);
foreach (var result in results)
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");

using IronBarCode;

// Format detection is automatic — BarcodeReaderOptions controls processing behavior
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = false
};

// Combined with the MediaPicker capture pattern
var photo = await MediaPicker.CapturePhotoAsync();
if (photo == null) return;

using var photoStream = await photo.OpenReadAsync();
using var ms = new MemoryStream();
await photoStream.CopyToAsync(ms);

var results = BarcodeReader.Read(ms.ToArray(), options);
foreach (var result in results)
    Console.WriteLine($"{result.BarcodeType}: {result.Value}");

Imports IronBarCode
Imports System.IO

' Format detection is automatic — BarcodeReaderOptions controls processing behavior
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = False
}

' Combined with the MediaPicker capture pattern
Dim photo = Await MediaPicker.CapturePhotoAsync()
If photo Is Nothing Then Return

Using photoStream = Await photo.OpenReadAsync()
    Using ms As New MemoryStream()
        Await photoStream.CopyToAsync(ms)

        Dim results = BarcodeReader.Read(ms.ToArray(), options)
        For Each result In results
            Console.WriteLine($"{result.BarcodeType}: {result.Value}")
        Next
    End Using
End Using

La spécification du format n'est pas requise — Code-barres IronBarcode détecte automatiquement tous les formats pris en charge. Les paramètres BarcodeReaderOptions qui correspondent le plus directement à la configuration de Scanbot sont Speed (contrôle la rigueur du traitement par rapport aux performances) et ExpectMultipleBarcodes (continue le balayage après la première correspondance).

Traitement PDF côté serveur

Ce scénario n'a pas d'équivalent chez Scanbot. Avec IronBarcode, le même package installé pour l'application mobile MAUI peut extraire les codes-barres des PDF dans un point de terminaison ASP.NET Core côté serveur, offrant ainsi aux équipes une seule dépendance de code-barres qui fonctionne dans les deux contextes de déploiement.

Approche du kit de développement logiciel Scanbot :

// Kit de développement logiciel Scanbot cannot be used here — the package does not compile
// in ASP.NET Core, Azure Functions, console apps, or any non-MAUI project.
// There is no server-side Scanbot equivalent for this endpoint.

// Kit de développement logiciel Scanbot cannot be used here — the package does not compile
// in ASP.NET Core, Azure Functions, console apps, or any non-MAUI project.
// There is no server-side Scanbot equivalent for this endpoint.

' Kit de développement logiciel Scanbot cannot be used here — the package does not compile
' in ASP.NET Core, Azure Functions, console apps, or any non-MAUI project.
' There is no server-side Scanbot equivalent for this endpoint.

Approche IronBarcode :

// NuGet: dotnet add package IronBarcode
// Works in ASP.NET Core, console apps, Azure Functions, Docker — the same package as MAUI
using IronBarCode;

[HttpPost("extract-barcodes")]
public async Task<IActionResult> ExtractBarcodes(IFormFile file)
{
    using var ms = new MemoryStream();
    await file.CopyToAsync(ms);

    // Reads all barcodes from all pages of the uploaded PDF
    var results = BarcodeReader.Read(ms.ToArray());
    var values = results.Select(r => new
    {
        r.Value,
        Format = r.Format.ToString(),
        r.PageNumber
    });

    return Ok(values);
}

// NuGet: dotnet add package IronBarcode
// Works in ASP.NET Core, console apps, Azure Functions, Docker — the same package as MAUI
using IronBarCode;

[HttpPost("extract-barcodes")]
public async Task<IActionResult> ExtractBarcodes(IFormFile file)
{
    using var ms = new MemoryStream();
    await file.CopyToAsync(ms);

    // Reads all barcodes from all pages of the uploaded PDF
    var results = BarcodeReader.Read(ms.ToArray());
    var values = results.Select(r => new
    {
        r.Value,
        Format = r.Format.ToString(),
        r.PageNumber
    });

    return Ok(values);
}

Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc
Imports System.IO
Imports System.Threading.Tasks

<HttpPost("extract-barcodes")>
Public Async Function ExtractBarcodes(file As IFormFile) As Task(Of IActionResult)
    Using ms As New MemoryStream()
        Await file.CopyToAsync(ms)

        ' Reads all barcodes from all pages of the uploaded PDF
        Dim results = BarcodeReader.Read(ms.ToArray())
        Dim values = results.Select(Function(r) New With {
            .Value = r.Value,
            .Format = r.Format.ToString(),
            .PageNumber = r.PageNumber
        })

        Return Ok(values)
    End Using
End Function

IronBarcode gère nativement les PDF multi-pages — chaque résultat a une propriété PageNumber indiquant sur quelle page le code-barres a été trouvé. Le guide d'extraction des codes-barres PDF couvre l'ensemble des options de lecture PDF, y compris la sélection de la plage de pages et l'optimisation des performances pour les lots de documents volumineux.

Traitement en arrière-plan ASP.NET Core

Pour les flux de travail par lots tels que les Azure Functions ou les services de travail traitant des documents PDF archivés, Code-barres IronBarcode fournit la même API que celle utilisée dans l'application MAUI et le contrôleur ASP.NET Core .

Approche du kit de développement logiciel Scanbot :

// Kit de développement logiciel Scanbot does not support this deployment context.
// The package will not compile in Azure Functions or Worker Services.

// Kit de développement logiciel Scanbot does not support this deployment context.
// The package will not compile in Azure Functions or Worker Services.

' Kit de développement logiciel Scanbot does not support this deployment context.
' The package will not compile in Azure Functions or Worker Services.

Approche IronBarcode :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Azure Function or Worker Service batch processing
public void ProcessInvoiceBatch(IEnumerable<string> filePaths)
{
    foreach (var filePath in filePaths)
    {
        var results = BarcodeReader.Read(filePath);
        foreach (var result in results)
            Console.WriteLine($"File: {filePath} | Page {result.PageNumber}: {result.Value} ({result.BarcodeType})");
    }
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Azure Function or Worker Service batch processing
public void ProcessInvoiceBatch(IEnumerable<string> filePaths)
{
    foreach (var filePath in filePaths)
    {
        var results = BarcodeReader.Read(filePath);
        foreach (var result in results)
            Console.WriteLine($"File: {filePath} | Page {result.PageNumber}: {result.Value} ({result.BarcodeType})");
    }
}

Imports IronBarCode

Public Sub ProcessInvoiceBatch(filePaths As IEnumerable(Of String))
    For Each filePath In filePaths
        Dim results = BarcodeReader.Read(filePath)
        For Each result In results
            Console.WriteLine($"File: {filePath} | Page {result.PageNumber}: {result.Value} ({result.BarcodeType})")
        Next
    Next
End Sub

Problème n° 1 : Absence d'équivalent en mode viseur électronique

Kit de développement logiciel Scanbot : Fournit un viseur de caméra en temps réel intégré à l'expérience de numérisation, avec une superposition de zone de numérisation, un retour haptique et une détection continue des codes-barres dans le flux vidéo en direct.

Solution : Utilisez MediaPicker.CapturePhotoAsync() de MAUI pour ouvrir la caméra du système et capturer une image fixe pour le traitement :

var photo = await MediaPicker.CapturePhotoAsync();
if (photo == null) return;

using var stream = await photo.OpenReadAsync();
using var ms = new MemoryStream();
await stream.CopyToAsync(ms);

var results = BarcodeReader.Read(ms.ToArray());

var photo = await MediaPicker.CapturePhotoAsync();
if (photo == null) return;

using var stream = await photo.OpenReadAsync();
using var ms = new MemoryStream();
await stream.CopyToAsync(ms);

var results = BarcodeReader.Read(ms.ToArray());

Imports System.IO

Dim photo = Await MediaPicker.CapturePhotoAsync()
If photo Is Nothing Then Return

Using stream = Await photo.OpenReadAsync()
    Using ms As New MemoryStream()
        Await stream.CopyToAsync(ms)

        Dim results = BarcodeReader.Read(ms.ToArray())
    End Using
End Using

Pour les applications professionnelles, la caméra du système est adéquate. Pour les applications grand public où la superposition en direct est essentielle à l'expérience utilisateur, évaluez si ce changement d'expérience utilisateur est acceptable avant de vous engager dans la migration.

Problème n° 2 : Différences concernant les autorisations d'utilisation des appareils photo

Kit de développement logiciel Scanbot : Le package Scanbot gérait les demandes d'autorisation d'accès à la caméra dans le cadre de son flux d'interface utilisateur ; les autorisations d'accès à la caméra étaient donc gérées implicitement par l'initialisation du kit de développement logiciel et le lancement du scanner.

Solution : Avec MediaPicker, MAUI gère les permissions via le mécanisme standard. Vérifiez que AndroidManifest.xml inclut la déclaration de permission de la caméra et que Info.plist inclut la clé NSCameraUsageDescription. Ces entrées sont généralement présentes dans les modèles de projets MAUI pré-structurés. Si l'application utilisait auparavant uniquement Scanbot pour l'accès à la caméra, vérifiez que les entrées suivantes du manifeste sont bien présentes avant de procéder au test :

<uses-permission android:name="android.permission.CAMERA" />

<key>NSCameraUsageDescription</key>
<string>This app uses the camera to scan barcodes.</string>

<uses-permission android:name="android.permission.CAMERA" />

<key>NSCameraUsageDescription</key>
<string>This app uses the camera to scan barcodes.</string>

Problème 3 : Correction des erreurs de compilation Windows

Scanbot SDK : Le package ScanbotBarcodeSDK.MAUI cible uniquement net10.0-android et net10.0-ios, causant des échecs de construction lorsque net10.0-windows est présent dans TargetFrameworks.

Solution : La suppression de la référence au package Scanbot résout l'échec de la compilation sous Windows. Code-barres IronBarcode fonctionne correctement sur toutes les cibles MAUI sans configuration spécifique à la plateforme :

# Verify the build succeeds on all targets after removing Scanbot and adding IronBarcode
dotnet build -f net10.0-windows10.0.19041.0
dotnet build -f net10.0-ios
dotnet build -f net10.0-android

# Verify the build succeeds on all targets after removing Scanbot and adding IronBarcode
dotnet build -f net10.0-windows10.0.19041.0
dotnet build -f net10.0-ios
dotnet build -f net10.0-android

Problème n° 4 : Modification de l'espace de noms des énumérations de format

Scanbot SDK : Utilise des valeurs d'énumération BarcodeFormat telles que BarcodeFormat.Code128 du namespace ScanbotBarcodeSDK.MAUI.

Solution : Code-barres IronBarcode utilise l'énumération BarcodeEncoding dans le namespace IronBarCode. Mettez à jour toutes les références de format et tout code qui stocke, compare ou active les valeurs d'énumération de format :

// Before (Scanbot)
BarcodeFormat.Code128
BarcodeFormat.QrCode
BarcodeFormat.Ean13

// After (IronBarcode)
BarcodeEncoding.Code128
BarcodeEncoding.QRCode
BarcodeEncoding.EAN13

// Before (Scanbot)
BarcodeFormat.Code128
BarcodeFormat.QrCode
BarcodeFormat.Ean13

// After (IronBarcode)
BarcodeEncoding.Code128
BarcodeEncoding.QRCode
BarcodeEncoding.EAN13

' Before (Scanbot)
BarcodeFormat.Code128
BarcodeFormat.QrCode
BarcodeFormat.Ean13

' After (IronBarcode)
BarcodeEncoding.Code128
BarcodeEncoding.QRCode
BarcodeEncoding.EAN13

Notez qu'IronBarcode détecte automatiquement tous les formats pris en charge par défaut — le filtrage explicite des formats via BarcodeReaderOptions est uniquement nécessaire pour l'optimisation des performances lorsque le format attendu est connu à l'avance.

Tâches préalables à la migration

Auditez le code source pour identifier toutes les utilisations du SDK Scanbot :

grep -rn "ScanbotSDK.Initialize" --include="*.cs" .
grep -rn "BarcodeScannerScreenConfiguration" --include="*.cs" .
grep -rn "ScanbotSDKMain.Barcode.StartScannerAsync" --include="*.cs" .
grep -rn "result\.Barcodes" --include="*.cs" .
grep -rn "barcode\.Format" --include="*.cs" .
grep -rn "barcode\.Text" --include="*.cs" .
grep -rn "OperationResult\.Ok" --include="*.cs" .
grep -rn "using ScanbotBarcodeSDK" --include="*.cs" .
grep -rn "BarcodeFormat\." --include="*.cs" .

grep -rn "ScanbotSDK.Initialize" --include="*.cs" .
grep -rn "BarcodeScannerScreenConfiguration" --include="*.cs" .
grep -rn "ScanbotSDKMain.Barcode.StartScannerAsync" --include="*.cs" .
grep -rn "result\.Barcodes" --include="*.cs" .
grep -rn "barcode\.Format" --include="*.cs" .
grep -rn "barcode\.Text" --include="*.cs" .
grep -rn "OperationResult\.Ok" --include="*.cs" .
grep -rn "using ScanbotBarcodeSDK" --include="*.cs" .
grep -rn "BarcodeFormat\." --include="*.cs" .

• Documentez tous les points d'appel de numérisation et indiquez s'ils se trouvent dans du code partagé, du code spécifique à la plateforme ou des gestionnaires d'événements d'interface utilisateur.
• Identifier si des pages ou des flux s'appuient sur le viseur en temps réel du Scanbot comme principale interaction utilisateur.
• Confirmez que les entrées de permission de la caméra existent dans AndroidManifest.xml et Info.plist
• Examinez .csproj pour toute référence de package conditionnelle liée à Scanbot

Tâches de mise à jour du code

1. Supprimez le package NuGet ScanbotSDK.MAUI
2. Supprimez toutes les entrées conditionnelles <PackageReference> pour Scanbot de .csproj
3. Installez le package NuGet IronBarcode
4. Remplacez using ScanbotSDK.MAUI; par using IronBarCode; dans tous les fichiers
5. Remplacez ScanbotSDK.Initialize(...) par IronBarCode.License.LicenseKey = "key" au démarrage de l'application
6. Remplacez ScanbotSDKMain.Barcode.StartScannerAsync(configuration) par MediaPicker.CapturePhotoAsync() suivi d'une copie de flux et BarcodeReader.Read(bytes) dans les flux de travail de la caméra MAUI
7. Remplacez ScanbotSDKMain.Barcode.StartScannerAsync(configuration) par BarcodeReader.Read(filePath) ou BarcodeReader.Read(stream) dans les contextes côté serveur et traitement de fichiers
8. Remplacez les vérifications result.Status == OperationResult.Ok par results.Any() ou results.FirstOrDefault() != null
9. Remplacez les références de collection result.Barcodes par la valeur de retour de BarcodeReader.Read()
10. Remplacez l'accès à la propriété barcode.Text par result.Value
11. Remplacez les valeurs d'énumération BarcodeFormat.* par les équivalents BarcodeEncoding.*
12. Remplacez new BarcodeScannerScreenConfiguration() par new BarcodeReaderOptions() là où des options de traitement sont nécessaires

Test de post-migration

• Vérifiez que la compilation réussit sur toutes les plateformes cibles MAUI, y compris Windows et macOS si elles sont présentes.
• Testez le flux MediaPicker.CapturePhotoAsync() sur un appareil iOS physique et un appareil Android physique
• Vérifier que les valeurs des codes-barres décodées par Code-barres IronBarcode correspondent aux valeurs précédemment décodées par Scanbot pour les mêmes codes-barres physiques.
• Tester l'extraction de PDF multipages si le projet inclut des flux de travail de traitement de documents.
• Vérifiez que la détection de format couvre tous les types de codes-barres précédemment configurés dans BarcodeScannerScreenConfiguration.BarcodeFormats
• Vérifiez que les points de terminaison côté serveur ou les tâches en arrière-plan produisent des résultats corrects sur les mêmes exemples de documents.
• Vérifiez que les invites d'autorisation d'accès à la caméra s'affichent correctement lors du premier lancement sur iOS et Android.