Das grundsätzliche Problem

Das Scanbot SDKbenötigt einen Live-Kamerastream. Wenn die Anforderungen über mobile Endgeräte hinausgehen, gibt es keinen gleichwertigen Weg über die bestehende Abhängigkeit:

// 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 akzeptiert in jedem Projektkontext die gleichen Quelltypen – Datei, Datenstrom, Byte-Array oder PDF:

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

Schritt 1: Ersetzen des NuGet-Pakets

Entfernen Sie das Scanbot-Paket:

dotnet remove package ScanbotBarcodeSDK.MAUI

dotnet remove package ScanbotBarcodeSDK.MAUI

Wenn das Projekt bedingte Paketreferenzen in der .csproj-Datei verwendet, entfernen Sie auch diese Einträge:

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

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

IronBarcode installieren:

dotnet add package IronBarcode

dotnet add package IronBarcode

IronBarcode ist über NuGet verfügbar und unterstützt .NET 6, 7, 8, 9 und .NET Framework 4.6.2+. Für ein MAUI-Multi-Target-Projekt arbeitet ein einziger dotnet add package über alle Ziele hinweg — keine plattformbedingten Paketreferenzen sind erforderlich.

Schritt 2: Namespaces aktualisieren

Ersetzen Sie die Scanbot-Namensräume durch den IronBarcode -Namensraum:

// Remove
using ScanbotSDK.MAUI;

// Add
using IronBarCode;

// Remove
using ScanbotSDK.MAUI;

// Add
using IronBarCode;

Imports IronBarCode

Schritt 3: Lizenz initialisieren

Entfernen Sie den Scanbot-Initialisierungsblock und ersetzen Sie ihn durch den IronBarcode -Lizenzschlüssel. Fügen Sie die Lizenzinitialisierung beim Anwendungsstart in MauiProgram.cs, App.xaml.cs oder Program.cs je nach Projekttyp hinzu:

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

MAUI-Fotoaufnahmen

Der Scanvorgang von Scanbot öffnet eine Vollbild-Kameraoberfläche und kehrt zurück, sobald der Benutzer einen Barcode scannt oder den Vorgang abbricht. IronBarcode bietet keine Kamera-Benutzeroberfläche; der Ersatz verwendet MAUIs MediaPicker, um die Systemkamera aufzurufen, ein Foto zu machen und die Bildbytes an BarcodeReader.Read() zu übergeben.

Scanbot SDK-Ansatz:

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

IronBarcode -Ansatz:

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

Die Änderung in der Benutzerführung besteht darin, dass der Benutzer den Bildschirm der Systemkamera anstelle des in Scanbot integrierten Suchers mit einer Scanbereichsüberlagerung sieht. Für Geschäftsanwendungen – Inventur, Logistik, Dokumentenworkflows – ist die Systemkamera ausreichend. Das .NET MAUI Barcode-Scanner-Tutorial behandelt das vollständige Integrationsmuster sowohl für iOS- als auch für Android-Ziele, einschließlich der Berechtigungsverwaltung.

Scanoptionen und Konfiguration

Scanbots BarcodeScannerScreenConfiguration steuert, welche Formate der Scanner akzeptiert und wie die Kamera-UI aussieht. IronBarcode's BarcodeReaderOptions steuert, wie das Bild analysiert wird — Verarbeitungsgeschwindigkeit, Multi-Barcode-Erkennung und ähnliche Parameter. Die Konfigurationskonzepte beziehen sich auf unterschiedliche Belange, da die zugrunde liegenden Operationen unterschiedlich sind.

Scanbot SDK-Ansatz:

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

IronBarcode -Ansatz:

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

Eine Formatangabe ist nicht erforderlich – IronBarcode erkennt alle unterstützten Formate automatisch. Die direktesten Entsprechungen von Scanbot-Konfiguration sind Speed (steuert die Verarbeitungsgenauigkeit im Vergleich zur Leistung) und ExpectMultipleBarcodes (setzt das Scannen nach dem ersten Treffer fort).

Serverseitige PDF-Verarbeitung

Dieses Szenario hat kein Scanbot-Äquivalent. Mit IronBarcode kann dasselbe Paket, das für die MAUI-Mobil-App installiert ist, Barcodes aus PDFs in einem serverseitigen ASP.NET Core Endpunkt extrahieren. Dadurch erhalten die Teams eine einzige Barcode-Abhängigkeit, die in beiden Bereitstellungskontexten funktioniert.

Scanbot SDK-Ansatz:

// Scanbot SDKcannot 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.

// Scanbot SDKcannot 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.

' Scanbot SDK 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.

IronBarcode -Ansatz:

// 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 verarbeitet mehrseitige PDFs nativ — jedes Ergebnis hat eine PageNumber-Eigenschaft, die angibt, auf welcher Seite der Barcode gefunden wurde. Der Leitfaden zur Extraktion von PDF-Barcodes deckt das gesamte Spektrum der PDF-Leseoptionen ab, einschließlich der Auswahl von Seitenbereichen und der Leistungsoptimierung für große Dokumentenstapel.

ASP.NET Core Hintergrundverarbeitung

Für Batch-Workflows wie Azure Functions oder Worker Services, die archivierte PDF-Dokumente verarbeiten, bietet IronBarcode die gleiche API, die auch in der MAUI-App und im ASP.NET Core -Controller verwendet wird.

Scanbot SDK-Ansatz:

// Scanbot SDKdoes not support this deployment context.
// The package will not compile in Azure Functions or Worker Services.

// Scanbot SDKdoes not support this deployment context.
// The package will not compile in Azure Functions or Worker Services.

' Scanbot SDK does not support this deployment context.
' The package will not compile in Azure Functions or Worker Services.

IronBarcode -Ansatz:

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

Problem 1: Kein gleichwertiger Live-Sucher

Scanbot SDK: Bietet einen in das Scan-Erlebnis integrierten Echtzeit-Kamera-Sucher mit Scanbereich-Overlay, haptischem Feedback und kontinuierlicher Barcode-Erkennung im Live-Videofeed.

Lösung: Verwenden Sie MAUIs MediaPicker.CapturePhotoAsync(), um die Systemkamera zu öffnen und ein Standbild zur Verarbeitung aufzunehmen:

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

Für geschäftliche Anwendungen ist die Systemkamera ausreichend. Bei Verbraucher-Apps, bei denen das Live-Overlay ein zentraler Bestandteil des Benutzererlebnisses ist, sollte vor der endgültigen Umstellung geprüft werden, ob diese Änderung der Benutzererfahrung akzeptabel ist.

Problem 2: Unterschiede bei den Kameraberechtigungen

Scanbot SDK: Das Scanbot-Paket verarbeitete Kameraberechtigungsanfragen im Rahmen seines UI-Ablaufs, sodass die Kameraberechtigungen implizit durch die SDK-Initialisierung und den Start des Scanners verwaltet wurden.

Lösung: Mit MediaPicker regelt MAUI Berechtigungen über den Standardmechanismus. Vergewissern Sie sich, dass AndroidManifest.xml die Kameraberechtigungserklärung enthält und dass Info.plist den NSCameraUsageDescription-Schlüssel enthält. Diese Einträge sind typischerweise in vordefinierten MAUI-Projektvorlagen vorhanden. Falls die App zuvor ausschließlich Scanbot für den Kamerazugriff verwendet hat, überprüfen Sie vor dem Testen, ob diese Manifesteinträge vorhanden sind:

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

Problem 3: Windows-Build-Fehler behoben

Scanbot SDK: Das ScanbotBarcodeSDK.MAUI-Paket zielt nur auf net10.0-android und net10.0-ios ab und führt zu Buildfehlern, wenn net10.0-windows in TargetFrameworks vorhanden ist.

Lösung: Durch Entfernen des Scanbot-Paketverweises wird der Build-Fehler unter Windows behoben. IronBarcode wird auf allen MAUI-Zielen ohne plattformspezifische Konfiguration korrekt aufgelöst:

# 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

Problem 4: Änderung des Enum-Namensraums

Scanbot SDK: Verwendet BarcodeFormat-Enum-Werte wie BarcodeFormat.Code128 aus dem ScanbotBarcodeSDK.MAUI-Namespace.

Lösung: IronBarcode verwendet das BarcodeEncoding-Enum im IronBarCode-Namespace. Aktualisieren Sie alle Formatverweise und jeglichen Code, der Format-Enum-Werte speichert, vergleicht oder auf sie umschaltet:

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

Beachten Sie, dass IronBarcode standardmäßig alle unterstützten Formate automatisch erkennt — eine explizite Formatfilterung mit BarcodeReaderOptions ist nur zur Leistungsoptimierung erforderlich, wenn das erwartete Format im Voraus bekannt ist.

Vor der Migration anfallende Aufgaben

Überprüfen Sie den Quellcode, um alle Scanbot SDK-Nutzungen zu identifizieren:

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

• Dokumentieren Sie alle Stellen, an denen Scanvorgänge aufgerufen werden, und vermerken Sie, ob sie sich in gemeinsam genutztem Code, plattformspezifischem Code oder UI-Ereignisbehandlern befinden.
• Ermitteln, ob Seiten oder Abläufe auf den Echtzeit-Sucher von Scanbot als primäre Benutzerinteraktion angewiesen sind.
• Bestätigen Sie, dass in AndroidManifest.xml und Info.plist Einträge für Kameraberechtigungen vorhanden sind.
• Überprüfen Sie die .csproj auf bedingte Paketreferenzen im Zusammenhang mit Scanbot.

Aufgaben der Code-Aktualisierung

1. Entfernen Sie das ScanbotSDK.MAUI NuGet-Paket
2. Entfernen Sie alle bedingten <PackageReference>-Einträge für Scanbot aus dem .csproj
3. Installieren Sie das IronBarcode NuGet-Paket
4. Ersetzen Sie using ScanbotSDK.MAUI; durch using IronBarCode; in allen Dateien
5. Ersetzen Sie ScanbotSDK.Initialize(...) beim Anwendungsstart durch IronBarCode.License.LicenseKey = "key"
6. Ersetzen Sie ScanbotSDKMain.Barcode.StartScannerAsync(configuration) durch MediaPicker.CapturePhotoAsync() gefolgt von Stream-Kopie und BarcodeReader.Read(bytes) in MAUI-Kamera-Workflows
7. Ersetzen Sie ScanbotSDKMain.Barcode.StartScannerAsync(configuration) durch BarcodeReader.Read(filePath) oder BarcodeReader.Read(stream) in serverseitigen und Dateiverarbeitungskontexten
8. Ersetzen Sie result.Status == OperationResult.Ok-Überprüfungen durch results.Any() oder results.FirstOrDefault() != null
9. Ersetzen Sie result.Barcodes-Sammlungsreferenzen durch den Rückgabewert von BarcodeReader.Read()
10. Ersetzen Sie barcode.Text-Eigenschaftszugriff durch result.Value
11. Ersetzen Sie BarcodeFormat.*-Enum-Werte durch BarcodeEncoding.*-Äquivalente
12. Ersetzen Sie new BarcodeScannerScreenConfiguration() durch new BarcodeReaderOptions(), wo Verarbeitungsoptionen benötigt werden

Post-Migrationstests

• Überprüfen Sie, ob der Build auf allen MAUI-Zielplattformen erfolgreich ist, einschließlich Windows und macOS, falls vorhanden.
• Testen Sie den MediaPicker.CapturePhotoAsync()-Ablauf auf einem physischen iOS-Gerät und einem physischen Android-Gerät
• Bestätigen Sie, dass die von IronBarcode dekodierten Barcode-Werte mit den Werten übereinstimmen, die zuvor von Scanbot für dieselben physischen Barcodes dekodiert wurden.
• Testen Sie die Extraktion mehrseitiger PDFs, falls das Projekt Dokumentenverarbeitungs-Workflows umfasst.
• Verifizieren Sie, dass die Formatdetektion alle Barcodetypen abdeckt, die zuvor in BarcodeScannerScreenConfiguration.BarcodeFormats konfiguriert wurden.
• Stellen Sie sicher, dass serverseitige Endpunkte oder Hintergrundprozesse bei denselben Dokumentbeispielen korrekte Ergebnisse liefern.
• Überprüfen, ob die Kameraberechtigungsabfragen beim ersten Start unter iOS und Android korrekt angezeigt werden.