El problema fundamental

El SDK de Scanbot requiere una transmisión de video en directo. Cuando los requisitos se extienden más allá de los dispositivos móviles, no existe una ruta equivalente a través de la dependencia existente:

// 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 acepta los mismos tipos de origen (archivo, flujo de datos, matriz de bytes o PDF) en cualquier contexto de proyecto:

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

Paso 1: Sustituir el paquete NuGet

Elimine el paquete Scanbot:

dotnet remove package ScanbotBarcodeSDK.MAUI

dotnet remove package ScanbotBarcodeSDK.MAUI

Si el proyecto utiliza referencias de paquete condicionales en el archivo .csproj, elimine también esas entradas:

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

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

Instalar IronBarcode:

dotnet add package IronBarcode

dotnet add package IronBarcode

IronBarcode está disponible en NuGet y es compatible con .NET 6, 7, 8, 9 y .NET Framework 4.6.2+. Para un proyecto multi-objetivo de MAUI, un solo dotnet add package funciona en todos los objetivos: no se necesitan referencias de paquetes condicionales a la plataforma.

Paso 2: Actualizar los espacios de nombres

Reemplace los espacios de nombres de Scanbot con el espacio de nombres de IronBarcode :

// Remove
using ScanbotSDK.MAUI;

// Add
using IronBarCode;

// Remove
using ScanbotSDK.MAUI;

// Add
using IronBarCode;

Imports IronBarCode

Paso 3: Inicializar licencia

Elimine el bloque de inicialización de Scanbot y sustitúyalo por la clave de licencia de IronBarcode . Agregue la inicialización de la licencia al inicio de la aplicación en MauiProgram.cs, App.xaml.cs o Program.cs dependiendo del tipo de proyecto:

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

Captura de fotos de MAUI

La función de escaneo de Scanbot abre una interfaz de cámara a pantalla completa y regresa cuando el usuario escanea un código de barras o cancela la operación. IronBarcode no proporciona una interfaz de usuario para la cámara; el reemplazo utiliza MediaPicker de MAUI para invocar la cámara del sistema, capturar una foto y pasar los bytes de la imagen a BarcodeReader.Read().

Enfoque del SDK de 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

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

El cambio en la experiencia de usuario consiste en que el usuario ve la pantalla de la cámara del sistema en lugar del visor integrado de Scanbot con una superposición de la región de escaneo. Para aplicaciones empresariales (inventario, logística, flujos de trabajo de documentos), la cámara del sistema es adecuada. El tutorial del escáner de códigos de barras .NET MAUI cubre el patrón de integración completo para dispositivos iOS y Android, incluyendo la gestión de permisos.

Opciones y configuración de escaneo

El BarcodeScannerScreenConfiguration de Scanbot controla cuáles formatos acepta el escáner y cómo se ve la interfaz de la cámara. El BarcodeReaderOptions de IronBarcode controla cómo se analiza la imagen: velocidad de procesamiento, detección de múltiples códigos de barras y parámetros similares. Los conceptos de configuración se corresponden con diferentes aspectos porque las operaciones subyacentes son diferentes.

Enfoque del SDK de 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

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

No es necesario especificar el formato: IronBarcode detecta automáticamente todos los formatos compatibles. Los parámetros de BarcodeReaderOptions que corresponden más directamente a la configuración de Scanbot son Speed (controla exhaustividad del procesamiento frente al rendimiento) y ExpectMultipleBarcodes (continúa escaneando después de la primera coincidencia).

Procesamiento de PDF del lado del servidor

Este escenario no tiene equivalente en Scanbot. Con IronBarcode, el mismo paquete instalado para la aplicación móvil MAUI puede extraer códigos de barras de archivos PDF en un punto final ASP.NET Core del lado del servidor, lo que proporciona a los equipos una única dependencia de códigos de barras que funciona en ambos contextos de implementación.

Enfoque del SDK de Scanbot:

// SDK de 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.

// SDK de 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.

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

Enfoque de 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 maneja PDFs de múltiples páginas de forma nativa: cada resultado lleva una propiedad PageNumber indicando en cuál página se encontró el código de barras. La guía de extracción de códigos de barras de PDF abarca todas las opciones de lectura de PDF, incluida la selección de rangos de páginas y la optimización del rendimiento para grandes lotes de documentos.

Procesamiento en segundo plano de ASP.NET Core

Para flujos de trabajo por lotes, como Azure Functions o Worker Services que procesan documentos PDF archivados, IronBarcode proporciona la misma API que se utiliza en la aplicación MAUI y en el controlador ASP.NET Core .

Enfoque del SDK de Scanbot:

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

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

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

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

Problema 1: No hay equivalente al visor en directo

SDK de Scanbot: Proporciona un visor de cámara en tiempo real integrado en la experiencia de escaneo, con una superposición de la región de escaneo, retroalimentación háptica y detección continua de códigos de barras en la transmisión de video en vivo.

Solución: Use MediaPicker.CapturePhotoAsync() de MAUI para abrir la cámara del sistema y capturar una imagen fija para su procesamiento:

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

Para aplicaciones empresariales, la cámara del sistema es adecuada. En el caso de las aplicaciones para consumidores donde la superposición en tiempo real es fundamental para la experiencia del usuario, evalúe si este cambio en la experiencia de usuario es aceptable antes de comprometerse con la migración.

Problema 2: Diferencias en los permisos de la cámara

SDK de Scanbot: El paquete Scanbot gestionaba las solicitudes de permisos de la cámara como parte de su flujo de interfaz de usuario, por lo que los permisos de la cámara se gestionaban implícitamente mediante la inicialización del SDK y el lanzamiento del escáner.

Solución: Con MediaPicker, MAUI maneja permisos a través del mecanismo estándar. Verifique que AndroidManifest.xml incluya la declaración de permiso para la cámara y que Info.plist incluya la clave NSCameraUsageDescription. Estas entradas suelen estar presentes en las plantillas de proyectos MAUI con andamiaje. Si la aplicación utilizaba anteriormente solo Scanbot para acceder a la cámara, confirme que estas entradas del manifiesto estén presentes antes de realizar la prueba:

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

Problema 3: Se corrigieron los errores de compilación de Windows.

Scanbot SDK: El paquete ScanbotBarcodeSDK.MAUI está dirigido solo a net10.0-android y net10.0-ios, causando fallas de construcción cuando net10.0-windows está presente en TargetFrameworks.

Solución: Eliminar la referencia al paquete Scanbot resuelve el error de compilación en Windows. IronBarcode se resuelve correctamente en todos los destinos MAUI sin necesidad de configuración condicional de la plataforma:

# 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

Problema 4: Cambio de espacio de nombres de enumeración de formato

Scanbot SDK: Usa valores de enumeración BarcodeFormat como BarcodeFormat.Code128 del espacio de nombres ScanbotBarcodeSDK.MAUI.

Solución: IronBarcode utiliza la enumeración BarcodeEncoding en el espacio de nombres IronBarCode. Actualiza todas las referencias de formato y cualquier código que almacene, compare o cambie según los valores de enumeración de formato:

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

Tenga en cuenta que IronBarcode detecta automáticamente todos los formatos compatibles por defecto: el filtrado explícito de formatos a través de BarcodeReaderOptions solo es necesario para optimización de rendimiento cuando se conoce el formato esperado de antemano.

Tareas previas a la migración

Audita el código fuente para identificar todos los usos del SDK de 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" .

• Documente todos los puntos de llamada de escaneo e indique si se encuentran en código compartido, código específico de la plataforma o controladores de eventos de la interfaz de usuario.
• Identificar si alguna página o flujo depende del visor en tiempo real de Scanbot como interacción principal del usuario.
• Confirme que existan entradas de permiso de cámara en AndroidManifest.xml y Info.plist
• Revise .csproj para cualquier referencia de paquete condicional asociada a Scanbot

Tareas de actualización de código

1. Elimine el paquete NuGet ScanbotSDK.MAUI
2. Elimine cualquier entrada condicional <PackageReference> para Scanbot del .csproj
3. Instale el paquete NuGet IronBarcode
4. Reemplace using ScanbotSDK.MAUI; con using IronBarCode; en todos los archivos
5. Reemplace ScanbotSDK.Initialize(...) con IronBarCode.License.LicenseKey = "key" al inicio de la aplicación
6. Reemplace ScanbotSDKMain.Barcode.StartScannerAsync(configuration) con MediaPicker.CapturePhotoAsync() seguido de copia de flujo y BarcodeReader.Read(bytes) en flujos de cámara MAUI
7. Reemplace ScanbotSDKMain.Barcode.StartScannerAsync(configuration) con BarcodeReader.Read(filePath) o BarcodeReader.Read(stream) en contextos de procesamiento de archivos y del lado del servidor
8. Reemplace las verificaciones result.Status == OperationResult.Ok con results.Any() o results.FirstOrDefault() != null
9. Reemplace las referencias de colección result.Barcodes con el valor de retorno de BarcodeReader.Read()
10. Reemplace el acceso a la propiedad barcode.Text con result.Value
11. Reemplace los valores de enumeración BarcodeFormat.* con los equivalentes BarcodeEncoding.*
12. Reemplace new BarcodeScannerScreenConfiguration() con new BarcodeReaderOptions() donde se necesiten opciones de procesamiento

Pruebas posteriores a la migración

• Verificar que la compilación se realice correctamente en todas las plataformas de destino de MAUI, incluidas Windows y macOS, si están presentes.
• Pruebe el flujo MediaPicker.CapturePhotoAsync() en un dispositivo iOS físico y un dispositivo Android físico
• Confirme que los valores de los códigos de barras decodificados por IronBarcode coinciden con los valores previamente decodificados por Scanbot para los mismos códigos de barras físicos.
• Pruebe la extracción de archivos PDF de varias páginas si el proyecto incluye flujos de trabajo de procesamiento de documentos.
• Verifique que la detección de formatos cubra todos los tipos de códigos de barras previamente configurados en BarcodeScannerScreenConfiguration.BarcodeFormats
• Confirme que los puntos finales del servidor o los trabajos en segundo plano producen resultados correctos en las mismas muestras de documentos.
• Verificar que las solicitudes de permiso de la cámara aparezcan correctamente la primera vez que se inicie en iOS y Android.