Le problème fondamental

Le problème structurel est que CameraBarcodeReaderView enferme le développeur dans une boucle d'événements centrée sur la caméra avec une gestion manuelle du cycle de vie et une liste de formats fixes. Pour toute utilisation au-delà de la numérisation de base de la caméra sur iOS et Android avec des formats de code-barres connus, l'architecture atteint sa limite :

// ZXing.Net.MAUI: event loop, format list, lifecycle boilerplate on every scan page
public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode |
                      BarcodeFormats.Code128 |
                      BarcodeFormats.Ean13 |
                      BarcodeFormats.UpcA,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;  // Required — no Dispose() available
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

// ZXing.Net.MAUI: event loop, format list, lifecycle boilerplate on every scan page
public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode |
                      BarcodeFormats.Code128 |
                      BarcodeFormats.Ean13 |
                      BarcodeFormats.UpcA,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;  // Required — no Dispose() available
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

Imports ZXing.Net.MAUI

Public Partial Class ScannerPage
    Inherits ContentPage

    Public ReadOnly Property ReaderOptions As BarcodeReaderOptions

    Public Sub New()
        InitializeComponent()
        ReaderOptions = New BarcodeReaderOptions With {
            .Formats = BarcodeFormats.QRCode Or
                       BarcodeFormats.Code128 Or
                       BarcodeFormats.Ean13 Or
                       BarcodeFormats.UpcA,
            .TryHarder = True,
            .AutoRotate = True
        }
        BindingContext = Me
    End Sub

    Private Sub OnBarcodesDetected(sender As Object, e As BarcodeDetectionEventArgs)
        MainThread.BeginInvokeOnMainThread(Sub()
                                               For Each barcode In e.Results
                                                   ResultLabel.Text = $"{barcode.Format}: {barcode.Value}"
                                               Next
                                           End Sub)
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnDisappearing()
        MyBase.OnDisappearing()
        CameraView.IsDetecting = False ' Required — no Dispose() available
    End Sub

    Protected Overrides Sub OnAppearing()
        MyBase.OnAppearing()
        CameraView.IsDetecting = True
    End Sub
End Class

IronBarcode remplace la boucle d'événements par un simple appel asynchrone lors d'un clic sur un bouton, supprime entièrement la configuration du format et élimine la gestion du cycle de vie de la page :

// NuGet: dotnet add package IronBarcode
// IronBarcode: stateless, all platforms, auto-detection, no lifecycle boilerplate
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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());
        ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
    }
    // Non OnAppearing / OnDisappearing needed
}

// NuGet: dotnet add package IronBarcode
// IronBarcode: stateless, all platforms, auto-detection, no lifecycle boilerplate
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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());
        ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
    }
    // Non OnAppearing / OnDisappearing needed
}

Imports IronBarCode

Public Partial Class ScannerPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    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())
                ResultLabel.Text = If(results.FirstOrDefault()?.Value, "No barcode found")
            End Using
        End Using
    End Sub
    ' Non OnAppearing / OnDisappearing needed
End Class

Étape 1 : Supprimer ZXing .NET.Maui.Controls et nettoyer MauiProgram.cs

Supprimez le package NuGet ZXing .NET .MAUI :

dotnet remove package ZXing.Net.Maui.Controls

dotnet remove package ZXing.Net.Maui.Controls

ZXing.Net.MAUI nécessite un appel d'enregistrement unique dans MauiProgram.cs. Supprimez cette ligne si elle est présente :

// Retirer this line from MauiProgram.cs
builder.UseBarcodeReader();

// Retirer this line from MauiProgram.cs
builder.UseBarcodeReader();

L'importation de using ZXing.Net.Maui; qui supporte cet appel peut également être supprimée de MauiProgram.cs.

Étape 2 : Installer IronBarcode

dotnet add package IronBarcode

dotnet add package IronBarcode

Le tutoriel sur le lecteur de codes-barres .NET MAUI couvre la configuration complète du projet, y compris les entrées d'autorisation de caméra Info.plist pour iOS et les déclarations d'autorisation AndroidManifest.xml pour Android.

Étape 3 : Mise à jour des espaces de noms et initialisation de la licence

Supprimez les importations d'espace de noms ZXing .NET.MAUI de tous les fichiers :

// Retirer these from every .cs file that imported them
using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

// Retirer these from every .cs file that imported them
using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

Ajoutez l'espace de noms Code-barres IronBarcode et initialisez la clé de licence au démarrage de l'application. L'emplacement approprié est MauiProgram.cs ou App.xaml.cs, avant que toute opération de code-barres ne soit effectuée :

using IronBarCode;

// In MauiProgram.cs CreateMauiApp() or App.xaml.cs constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

using IronBarCode;

// In MauiProgram.cs CreateMauiApp() or App.xaml.cs constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

' In MauiProgram.vb CreateMauiApp() or App.xaml.vb constructor
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Remplacement du contrôle de caméra XAML et du code-behind

Le contrôle XAML CameraBarcodeReaderView et son code-behind de support sont les cibles principales de la migration. Ce remplacement supprime la vue caméra de la mise en page et remplace le modèle de balayage événementiel par une capture asynchrone déclenchée par un bouton.

Approche ZXing .NET.MAUI :

XAML :

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <StackLayout>
        <zxing:CameraBarcodeReaderView
            x:Name="CameraView"
            Options="{Binding ReaderOptions}"
            BarcodesDetected="OnBarcodesDetected"
            VerticalOptions="FillAndExpand" />
        <Label x:Name="ResultLabel" Text="Scanning..." />
    </StackLayout>
</ContentPage>

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <StackLayout>
        <zxing:CameraBarcodeReaderView
            x:Name="CameraView"
            Options="{Binding ReaderOptions}"
            BarcodesDetected="OnBarcodesDetected"
            VerticalOptions="FillAndExpand" />
        <Label x:Name="ResultLabel" Text="Scanning..." />
    </StackLayout>
</ContentPage>

Code-behind :

using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode | BarcodeFormats.Code128 | BarcodeFormats.Ean13,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

using ZXing.Net.Maui;
using ZXing.Net.Maui.Controls;

public partial class ScannerPage : ContentPage
{
    public BarcodeReaderOptions ReaderOptions { get; }

    public ScannerPage()
    {
        InitializeComponent();
        ReaderOptions = new BarcodeReaderOptions
        {
            Formats = BarcodeFormats.QRCode | BarcodeFormats.Code128 | BarcodeFormats.Ean13,
            TryHarder = true,
            AutoRotate = true
        };
        BindingContext = this;
    }

    private void OnBarcodesDetected(object sender, BarcodeDetectionEventArgs e)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            foreach (var barcode in e.Results)
                ResultLabel.Text = $"{barcode.Format}: {barcode.Value}";
        });
        CameraView.IsDetecting = false;
    }

    protected override void OnDisappearing()
    {
        base.OnDisappearing();
        CameraView.IsDetecting = false;
    }

    protected override void OnAppearing()
    {
        base.OnAppearing();
        CameraView.IsDetecting = true;
    }
}

Imports ZXing.Net.Maui
Imports ZXing.Net.Maui.Controls

Public Partial Class ScannerPage
    Inherits ContentPage

    Public ReadOnly Property ReaderOptions As BarcodeReaderOptions

    Public Sub New()
        InitializeComponent()
        ReaderOptions = New BarcodeReaderOptions With {
            .Formats = BarcodeFormats.QRCode Or BarcodeFormats.Code128 Or BarcodeFormats.Ean13,
            .TryHarder = True,
            .AutoRotate = True
        }
        BindingContext = Me
    End Sub

    Private Sub OnBarcodesDetected(sender As Object, e As BarcodeDetectionEventArgs)
        MainThread.BeginInvokeOnMainThread(Sub()
                                               For Each barcode In e.Results
                                                   ResultLabel.Text = $"{barcode.Format}: {barcode.Value}"
                                               Next
                                           End Sub)
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnDisappearing()
        MyBase.OnDisappearing()
        CameraView.IsDetecting = False
    End Sub

    Protected Overrides Sub OnAppearing()
        MyBase.OnAppearing()
        CameraView.IsDetecting = True
    End Sub
End Class

Approche IronBarcode :

XAML :

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
    <StackLayout>
        <Button Text="Scan Barcode" Clicked="ScanButton_Clicked" />
        <Label x:Name="ResultLabel" Text="Tap to scan..." />
    </StackLayout>
</ContentPage>

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui">
    <StackLayout>
        <Button Text="Scan Barcode" Clicked="ScanButton_Clicked" />
        <Label x:Name="ResultLabel" Text="Tap to scan..." />
    </StackLayout>
</ContentPage>

Code-behind :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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.Format}: {first.Value}"
            : "No barcode found";
    }

    // Non OnAppearing or OnDisappearing required — no camera state exists between scans
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

public partial class ScannerPage : ContentPage
{
    public ScannerPage() => InitializeComponent();

    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.Format}: {first.Value}"
            : "No barcode found";
    }

    // Non OnAppearing or OnDisappearing required — no camera state exists between scans
}

Imports IronBarCode

Public Partial Class ScannerPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    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 = New MemoryStream()
                Await stream.CopyToAsync(ms)

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

    ' Non OnAppearing or OnDisappearing required — no camera state exists between scans
End Class

L'espace de noms XAML zxing:, la liste de formats BarcodeReaderOptions, le wrapper MainThread.BeginInvokeOnMainThread(), et les deux surcharges du cycle de vie sont complètement éliminés. La continuation de la méthode async s'exécute dans le contexte de l'appelant – qui est le thread principal pour un gestionnaire d'événements UI – donc aucun régime explicite de threads n'est nécessaire.

Suppression des spécifications de format

Tous les blocs de configuration BarcodeReaderOptions dispersés sur plusieurs pages ou scénarios de numérisation dans la base de code sont supprimés. Code-barres IronBarcode effectue une détection automatique du format parmi plus de 50 formats pris en charge, sans préconfiguration.

Approche ZXing .NET.MAUI :

// ZXing.Net.MAUI: every anticipated format must be listed explicitly
// Formats not listed here will silently fail to detect
var readerOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.DataMatrix |
              BarcodeFormats.Aztec |
              BarcodeFormats.Pdf417 |
              BarcodeFormats.Code128 |
              BarcodeFormats.Code39 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA |
              BarcodeFormats.Codabar,
    TryHarder = true
};

// ZXing.Net.MAUI: every anticipated format must be listed explicitly
// Formats not listed here will silently fail to detect
var readerOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.DataMatrix |
              BarcodeFormats.Aztec |
              BarcodeFormats.Pdf417 |
              BarcodeFormats.Code128 |
              BarcodeFormats.Code39 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA |
              BarcodeFormats.Codabar,
    TryHarder = true
};

' ZXing.Net.MAUI: every anticipated format must be listed explicitly
' Formats not listed here will silently fail to detect
Dim readerOptions As New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.DataMatrix Or
               BarcodeFormats.Aztec Or
               BarcodeFormats.Pdf417 Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Code39 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA Or
               BarcodeFormats.Codabar,
    .TryHarder = True
}

Approche IronBarcode :

// IronBarcode: no format configuration needed
// All formats are detected automatically on every read call
var results = BarcodeReader.Read(imageBytes);

// Optional: restrict to specific formats for performance tuning (not required for correctness)
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};
var tunedResults = BarcodeReader.Read(imageBytes, options);

// IronBarcode: no format configuration needed
// All formats are detected automatically on every read call
var results = BarcodeReader.Read(imageBytes);

// Optional: restrict to specific formats for performance tuning (not required for correctness)
var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};
var tunedResults = BarcodeReader.Read(imageBytes, options);

Imports IronBarcode

' IronBarcode: no format configuration needed
' All formats are detected automatically on every read call
Dim results = BarcodeReader.Read(imageBytes)

' Optional: restrict to specific formats for performance tuning (not required for correctness)
Dim options As New BarcodeReaderOptions With {
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}
Dim tunedResults = BarcodeReader.Read(imageBytes, options)

Des indications de format sont disponibles dans Code-barres IronBarcode pour les scénarios sensibles aux performances, mais elles sont facultatives. Un code-barres dont le format ne figure pas dans un objet d'options sera tout de même détecté et renvoyé.

Suppression de la gestion du cycle de vie IsDetecting

Toutes les surcharges OnAppearing et OnDisappearing qui existent pour basculer CameraView.IsDetecting sont supprimées. Si ces surcharges de méthodes contiennent d'autres logiques de cycle de vie des pages, conservez cette logique et supprimez uniquement les lignes IsDetecting.

Approche ZXing .NET.MAUI :

// Required boilerplate on every page — omitting this causes camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

// Required boilerplate on every page — omitting this causes camera resource leaks
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

' Required boilerplate on every page — omitting this causes camera resource leaks
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False
    End If
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = True
    End If
End Sub

Approche IronBarcode :

// Delete both methods if they contain only IsDetecting management.
// If they contain other logic, remove only the IsDetecting lines and keep the rest.
// Code-barres IronBarcode is stateless — there is no camera view running between button taps.

// Delete both methods if they contain only IsDetecting management.
// If they contain other logic, remove only the IsDetecting lines and keep the rest.
// Code-barres IronBarcode is stateless — there is no camera view running between button taps.

' Delete both methods if they contain only IsDetecting management.
' If they contain other logic, remove only the IsDetecting lines and keep the rest.
' Code-barres IronBarcode is stateless — there is no camera view running between button taps.

Windows MAUI : Même code, aucune compilation conditionnelle

Avec ZXing .NET.MAUI, l'ajout d'une cible Windows à un projet échouait soit à la compilation, soit nécessitait des stubs spécifiques à la plateforme, car l'implémentation Windows n'avait jamais été écrite. Avec IronBarcode, le même code qui fonctionne sur iOS et Android se compile et s'exécute sur Windows sans modification.

Approche ZXing .NET.MAUI :

// Windows MAUI: either fails to compile or requires a platform-specific stub
// There is no documented path to Windows support
#if ANDROID || IOS
    // ZXing.Net.MAUI scanning — Windows has no implementation
#endif

// Windows MAUI: either fails to compile or requires a platform-specific stub
// There is no documented path to Windows support
#if ANDROID || IOS
    // ZXing.Net.MAUI scanning — Windows has no implementation
#endif

Approche IronBarcode :

// NuGet: dotnet add package IronBarcode
// Non platform conditionals — same code runs on iOS, Android, Windows, and macOS
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());
    ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
}

// NuGet: dotnet add package IronBarcode
// Non platform conditionals — same code runs on iOS, Android, Windows, and macOS
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());
    ResultLabel.Text = results.FirstOrDefault()?.Value ?? "No barcode found";
}

' NuGet: dotnet add package IronBarcode
' Non platform conditionals — same code runs on iOS, Android, Windows, and macOS
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())
            ResultLabel.Text = If(results.FirstOrDefault()?.Value, "No barcode found")
        End Using
    End Using
End Sub

Sur Windows, MediaPicker.CapturePhotoAsync() se mappe au sélecteur de fichiers de Windows, permettant à l'utilisateur de sélectionner un fichier image — un comportement approprié pour un environnement de bureau. Le guide des codes-barres MAUI pour ordinateur de bureau couvre en détail la configuration de MAUI sous Windows et macOS.

Lecture des codes-barres PDF (Nouvelle fonctionnalité)

ZXing .NET.MAUI ne dispose pas d'API pour la lecture des codes-barres dans les documents PDF. S'il s'agit d'une nouvelle exigence permise par la migration, le modèle suivant s'applique :

Approche ZXing .NET.MAUI :

// ZXing.Net.MAUI: no API for PDF or file-based barcode reading
// Cannot fulfill this requirement — a separate library is required

// ZXing.Net.MAUI: no API for PDF or file-based barcode reading
// Cannot fulfill this requirement — a separate library is required

' ZXing.Net.MAUI: no API for PDF or file-based barcode reading
' Cannot fulfill this requirement — a separate library is required

Approche IronBarcode :

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read all barcodes from all pages of a PDF
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in pdfResults)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
private async void ReadFileButton_Clicked(object sender, EventArgs e)
{
    var file = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select image or PDF"
    });
    if (file == null) return;

    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read all barcodes from all pages of a PDF
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in pdfResults)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
private async void ReadFileButton_Clicked(object sender, EventArgs e)
{
    var file = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select image or PDF"
    });
    if (file == null) return;

    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

Imports IronBarCode

' Read all barcodes from all pages of a PDF
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each barcode In pdfResults
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

' Read from a user-selected file using MAUI FilePicker
Private Async Sub ReadFileButton_Clicked(sender As Object, e As EventArgs)
    Dim file = Await FilePicker.PickAsync(New PickOptions With {
        .PickerTitle = "Select image or PDF"
    })
    If file Is Nothing Then Return

    Dim fileResults = BarcodeReader.Read(file.FullPath)
    For Each result In fileResults
        ResultLabel.Text &= $"\n{result.Format}: {result.Value}"
    Next
End Sub

Le flux de travail complet de lecture des codes-barres PDF — y compris les documents multipages, les métadonnées de numéro de page et les documents de format mixte — est documenté dans le guide de lecture des codes-barres PDF .

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

ZXing.Net.MAUI : La CameraBarcodeReaderView affiche un flux continu de la caméra dans la mise en page de la page, montrant à l'utilisateur un aperçu en direct avec un retour de numérisation superposé.

Solution : Code-barres IronBarcode ne propose pas de commande de visée en direct. Le modèle de remplacement utilise MediaPicker.CapturePhotoAsync(), qui ouvre l'interface utilisateur de l'appareil photo système de la plateforme. La caméra système offre sa propre prévisualisation en direct et un indicateur de mise au point. Après que l'utilisateur a capturé l'image et confirmé, le résultat est transmis à BarcodeReader.Read(). Si un viseur intégré persistant dans l'application est un élément UX requis qui ne peut pas être remplacé par l'interface utilisateur de l'appareil photo système, la couche d'intégration de la caméra doit être construite séparément en utilisant Microsoft.Maui.Media ou les API de caméra de la plateforme, avec Code-barres IronBarcode gérant l'étape de décodage.

Problème n° 2 : Déclarations d'autorisation de prise de vue

ZXing .NET.MAUI : Les autorisations d'accès à la caméra ont peut-être été déclarées dans le projet dans le cadre des instructions d'installation de ZXing .NET.MAUI.

Solution : Les autorisations de caméra restent nécessaires pour l'appel MediaPicker.CapturePhotoAsync() que le modèle MAUI d'IronBarcode utilise. Vérifiez que NSCameraUsageDescription est présent dans Info.plist pour iOS et que <uses-permission android:name="android.permission.CAMERA" /> est présent dans AndroidManifest.xml pour Android. Code-barres IronBarcode lui-même n'accède pas directement à la caméra — il traite les images — mais l'appel MediaPicker qui lui fournit des images nécessite une autorisation de la caméra. La configuration des autorisations est abordée dans le tutoriel sur le lecteur de codes-barres .NET MAUI .

Problème n° 3 : La compilation Windows réussit désormais là où elle échouait auparavant.

ZXing .NET.MAUI : Les projets qui tentaient d'inclure une cible Windows avec ZXing .NET.MAUI rencontraient généralement des erreurs de compilation ou nécessitaient que la bibliothèque soit exclue de la compilation Windows via une logique MSBuild conditionnelle.

Solution : Après avoir supprimé ZXing .NET.MAUI et installé IronBarcode, la compilation de MAUI pour Windows réussit sans aucune condition de plateforme. Supprimez tout #if ANDROID || Les gardes d'iOS qui entouraient les appels ZXing .NET.MAUI étaient destinés à les exclure de la compilation Windows. L'appel BarcodeReader.Read() d'IronBarcode se compile et s'exécute sur tous les frameworks cibles. Si MediaPicker.CapturePhotoAsync() a été exclu des builds Windows, cette exclusion peut également être supprimée — la méthode est prise en charge sur Windows MAUIet se mappe au sélecteur de fichiers. Vérifiez que la solution complète se compile correctement pour tous les frameworks cibles après la suppression des conditions.

Problème 4 : Références à l'énumération BarcodeFormats

ZXing.Net.MAUI : L'énumération BarcodeFormats de ZXing.Net.Maui est largement utilisée dans les configurations BarcodeReaderOptions. Une fois le paquet supprimé, toute référence restante provoque des erreurs de compilation.

Solution : Supprimez tous les blocs d'initialisation BarcodeReaderOptions qui étaient utilisés pour configurer les listes de formats. Code-barres IronBarcode ne nécessite pas de spécification de format pour fonctionner correctement. Si un code restant fait référence à des valeurs BarcodeFormats pour les besoins de journalisation, d'affichage ou de comparaison, remplacez-les par des valeurs BarcodeEncoding de l'espace de noms IronBarCode. Exécutez grep -rn "BarcodeFormats\." --include="*.cs" . pour trouver toutes les références restantes après la suppression du package.

Tâches préalables à la migration

Avant d'apporter des modifications, vérifiez l'ensemble des utilisations de ZXing .NET.MAUI dans le code source :

grep -rn "ZXing.Net.Maui" --include="*.cs" --include="*.xaml" .
grep -rn "CameraBarcodeReaderView" --include="*.cs" --include="*.xaml" .
grep -rn "BarcodeDetectionEventArgs" --include="*.cs" .
grep -rn "BarcodeReaderOptions" --include="*.cs" .
grep -rn "BarcodeFormats\." --include="*.cs" .
grep -rn "IsDetecting" --include="*.cs" .
grep -rn "UseBarcodeReader" --include="*.cs" .
grep -rn "zxing:" --include="*.xaml" .
grep -rn "e\.Results" --include="*.cs" .

grep -rn "ZXing.Net.Maui" --include="*.cs" --include="*.xaml" .
grep -rn "CameraBarcodeReaderView" --include="*.cs" --include="*.xaml" .
grep -rn "BarcodeDetectionEventArgs" --include="*.cs" .
grep -rn "BarcodeReaderOptions" --include="*.cs" .
grep -rn "BarcodeFormats\." --include="*.cs" .
grep -rn "IsDetecting" --include="*.cs" .
grep -rn "UseBarcodeReader" --include="*.cs" .
grep -rn "zxing:" --include="*.xaml" .
grep -rn "e\.Results" --include="*.cs" .

Documentez toutes les pages numérisées identifiées par l'audit. Notez quelles surcharges OnAppearing et OnDisappearing contiennent uniquement une gestion IsDetecting (à supprimer) par rapport à celles qui contiennent d'autres logiques (à modifier partiellement). Notez toutes les instances BarcodeReaderOptions qui peuvent contenir des listes de formats utilisées au-delà de la configuration de détection.

Tâches de mise à jour du code

1. Supprimez le package NuGet ZXing.Net.Maui.Controls du fichier de projet
2. Supprimez builder.UseBarcodeReader() de MauiProgram.cs
3. Supprimez les importations d'espaces de noms using ZXing.Net.Maui; et using ZXing.Net.Maui.Controls; de tous les fichiers
4. Installez le package NuGet IronBarcode
5. Ajoutez using IronBarCode; à tous les fichiers qui utiliseront la lecture des codes-barres
6. Ajoutez IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"; au démarrage de l'application
7. Supprimez la déclaration d'espace de noms xmlns:zxing de tous les fichiers XAML
8. Supprimez tous les éléments <zxing:CameraBarcodeReaderView> des fichiers XAML
9. Remplacez la vue de l'appareil photo supprimée par un contrôle <Button> dans chaque fichier XAML
10. Ajoutez Clicked="ScanButton_Clicked" à chaque bouton de numérisation
11. Supprimez les méthodes de gestion d'événements OnBarcodesDetected de tous les fichiers de code-behind
12. Ajoutez des méthodes async void ScanButton_Clicked implémentant MediaPicker.CapturePhotoAsync() + BarcodeReader.Read() à chaque page
13. Supprimez tous les blocs d'initialisation BarcodeReaderOptions
14. Supprimez toutes les surcharges OnDisappearing et OnAppearing qui existent uniquement pour la gestion de IsDetecting
15. Supprimez les lignes IsDetecting de toute surcharge OnDisappearing et OnAppearing qui contiennent d'autres logiques
16. Supprimez toute directive #if ANDROID || Les mécanismes de compilation conditionnelle d'iOS qui isolaient ZXing .NET.MAUI des compilations Windows
17. Remplacez toutes les références d'énumération BarcodeFormats.X restantes par leurs équivalents BarcodeEncoding.X

Test de post-migration

Une fois la migration compilée sans problème, vérifiez les points suivants :

• Android MAUI : le bouton de scan ouvre l'appareil photo du système, prend une photo et affiche un code-barres correct ; veuillez vérifier avec le guide de scan Android.
• iOS MAUI : le même processus fonctionne sur iOS, y compris sur l'iPhone 15 Pro où le problème de mise au point automatique s'était produit auparavant.
• Windows MAUI : la version Windows se compile sans erreur et le bouton de numérisation ouvre le sélecteur de fichiers et renvoie un résultat correct à partir d'une image sélectionnée.
• Formats : testez la numérisation de codes-barres dans des formats qui n'étaient pas inclus dans l'ancienne liste BarcodeFormats pour confirmer la détection automatique
• Navigation entre les pages : naviguez plusieurs fois entre la page de numérisation et la page précédente et vérifiez qu'aucun problème de mémoire ou d'initialisation de l'appareil photo ne survient.
• Lecture de PDF : si la migration ajoute la lecture des codes-barres PDF comme nouvelle fonctionnalité, vérifiez que les PDF multipages renvoient des résultats avec des métadonnées de numéro de page correctes.