BarcodeScanning.MAUI vs IronBarcode: Porównanie bibliotek kodów kreskowych C#

Wzór skanowania na żywo z kamery

Cały wzorzec API BarcodeScanning.Native.Maui to kontrolka XAML połączona z procedurą obsługi zdarzeń w języku C#:

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Ten element sterujący zapewnia użytkownikom podgląd w czasie rzeczywistym osadzony na stronie MAUI. Wykrywanie BarCode działa w sposób ciągły, gdy kamera jest aktywna. Interfejs użytkownika jest naprawdę dobry w aplikacjach konsumenckich, gdzie podstawową interakcją jest "wyceluj i zeskanuj". Ograniczeniem jest to, że jest to jedyna interakcja obsługiwana przez bibliotekę — w momencie, gdy wymagania wykraczają poza wykrywanie na żywo z kamery w systemie iOS lub Android, BarcodeScanning.Native.Maui nie ma nic do zaoferowania.

Szczegółowe porównanie funkcji

Podejście BarcodeScanning.MAUI

BarcodeScanning.Native.Maui wykorzystuje natywny proces wykrywania aparatu na każdej platformie. W systemie Android ML Kit przetwarza klatki. W systemie iOS klatki są przetwarzane przez framework Apple Vision. Biblioteka udostępnia to jako kontrolkę MAUI CameraView z wydarzeniem OnDetectionFinished. Kod aplikacji nigdy nie obsługuje bezpośrednio bajtów obrazu — obsługuje jedynie wykryte wartości BARCODE, które pojawiają się w zdarzeniu.

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Konsekwencją tego projektu jest brak innego punktu wejścia. Kamera nie jest opcjonalna — jest to jedyne źródło danych, jakie biblioteka rozpoznaje. Serwer, plik, dokument PDF, komputer z systemem Windows — żadne z tych urządzeń nie posiada kamery w rozumieniu tej biblioteki.

Podejście IronBarcode

IronBarcode odbiera dane obrazu poprzez swoją metodę statyczną BarcodeReader.Read(). Użytkownik dostarcza dane — z dowolnego źródła — a biblioteka je dekoduje. W MAUI dane pochodzą z MediaPicker; na serwerze, pochodzi z przesłania formularza; w aplikacji desktopowej pochodzi z okna dialogowego plików.

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO

Private Async Sub ScanBarcodeButton_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())
            For Each result In results
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

Ten kod działa identycznie na systemach iOS, Android i Windows MAUI. W przypadku użycia po stronie serwera ta sama metoda BarcodeReader.Read() akceptuje tablicę bajtów przesłanego pliku lub ścieżkę do pliku PDF. Dokumentacja IronBarcode obejmuje wszystkie obsługiwane typy danych wejściowych.

Podejście BarcodeScanning.MAUI

BarcodeScanning.Native.Maui nie obsługuje środowiska docelowego Windows w MAUI. Nie jest to tymczasowa luka — jest to strukturalna konsekwencja architektury biblioteki. Biblioteka obsługuje natywne interfejsy API specyficzne dla systemów iOS (framework Vision) i Android (ML Kit). System Windows nie posiada żadnego z nich. Zespoły tworzące aplikację MAUI przeznaczoną dla systemów iOS, Android i Windows — standardowy scenariusz wielopłatformowy — nie mogą używać BarcodeScanning.Native.Maui jako rozwiązania do skanowania kodów kreskowych dla wszystkich trzech platform. Muszą oni albo osobno zaimplementować kod specyficzny dla platformy Windows, albo całkowicie zastąpić bibliotekę.

Podejście IronBarcode

Funkcja BarcodeReader.Read() w IronBarcode działa na platformach Windows, iOS, Android i macOS MAUI bez konieczności stosowania kodu specyficznego dla danej platformy. Nie ma bloków #if WINDOWS, nie ma warunkówego ładowania zależności i nie są potrzebne implementacje stubów. W przypadku plików i dokumentów PDF wzór jest również spójny:

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

Przewodnik integracji IronBarcode MAUI zawiera kompletne instrukcje konfiguracji dla wszystkich celów MAUI. IronBarcode obsługuje również wdrażanie po stronie serwera w środowiskach ASP.NET, Docker, Azure Functions i AWS Lambda, gdzie BarcodeScanning.Native.Maui nie ma żadnej ścieżki.

Podejście BarcodeScanning.MAUI

W systemie iOS funkcja wykrywania BarcodeScanning.Native.Maui (Apple Vision) zwraca 13 cyfr dla kodów kreskowych UPC-A. UPC-A to format 12-cyfrowy; dodatkowa zerowa cyfra na początku odpowiada kodowaniu EAN-13. Biblioteka przekazuje tę surową wartość bez korekty. Aplikacje, które przechowują wartości UPC-A w bazie danych, mogą gromadzić rekordy z niepotrzebnym zerem na początku.

Opisane obejście wymaga sprawdzenia formatu i przycięcia wartości:

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

// Workaround required for iOS UPC-A — strip the leading zero manually
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArgs e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormat.UPC_A && value.Length == 13)
        value = value.Substring(1); // strip Apple's prepended leading zero

    ProcessBarcode(value);
}

' Workaround required for iOS UPC-A — strip the leading zero manually
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArgs)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormat.UPC_A AndAlso value.Length = 13 Then
        value = value.Substring(1) ' strip Apple's prepended leading zero
    End If

    ProcessBarcode(value)
End Sub

To obejście w sposób niezauważalny powoduje uszkodzenie barcode'ów EAN-13 zaczynających się od 0, jeśli pominięto sprawdzanie formatu. PDF417 jest oddzielnie udokumentówany w zgłoszeniach GitHub jako "bardzo problematyczny — większość skanów nigdy nie dochodzi do skutku", co ma wpływ na etykiety wysyłkowe, prawa jazdy i karty pokładowe.

Podejście IronBarcode

IronBarcode zwraca prawidłową 12-cyfrową wartość UPC-A bez konieczności ręcznej normalizacji. PDF417 jest obsługiwanym formatem, który odczytuje się niezawodnie. Funkcja generowania jest również dostępna za pośrednictwem API IronBarcode:

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

W aplikacjach, w których dokładność danych kodów kreskowych ma bezpośredni wpływ na wyszukiwanie zapasów, transakcje w punktach sprzedaży lub integrację łańcucha dostaw, poprawna obsługa formatów przez IronBarcode eliminuje kategorię błędów produkcyjnych, które BarcodeScanning.Native.Maui pozostawia w kodzie aplikacji. Dokumentacja dotycząca odczytu kodów kreskowych IronBarcode szczegółowo opisuje zachowanie w zależności od formatu.

Dodano cel Windows MAUI do kompilacji

Aplikacje MAUI zazwyczaj powstają z myślą o systemach iOS i Android, a później, w miarę dojrzewania aplikacji lub rozszerzania się wymagań dotyczących dystrybucji w Enterprise, dodaje się do nich system Windows. Po dodaniu platformy docelowej Windows, BarcodeScanning.Native.Maui staje się natychmiastową przeszkodą — nie ma implementacji dla Windows i nie ma obejścia w bibliotece. Zespoły w tej sytuacji muszą albo utrzymać oddzielną implementację BarCode dla systemu Windows przy użyciu innej biblioteki, albo przenieść całą warstwę BarCode do biblioteki, która działa spójnie we wszystkich środowiskach docelowych MAUI. Druga ścieżka jest prostsza pod względem operacyjnym i eliminuje nakłady związane z utrzymaniem rozgałęzień specyficznych dla platformy.

Dodano wymagania dotyczące przesyłania plików lub przetwarzania plików PDF

Aplikacje mobilne często zaczynają od skanowania na żywo za pomocą kamery jako jedynej metody wprowadzania danych, a później rozszerzają się, aby akceptować przesłane obrazy lub dokumenty. Gdy użytkownik musi zeskanować kod kreskowy ze zdjęcia w swojej galerii, z obrazu otrzymanego pocztą elektroniczną lub z pliku PDF zawierającego listy przewozowe lub karty pokładowe, BarcodeScanning.Native.Maui nie ma do zaoferowania żadnej ścieżki kodu. Zespoły, które osiągają tę granicę wymagań, stają przed wyborem: dodać drugą bibliotekę kodów kreskowych obok BarcodeScanning.Native.Maui dla danych wejściowych w postaci plików i PDF-ów lub przejść na pojedynczą bibliotekę obsługującą wszystkie typy danych wejściowych. Zarządzanie dwoma pakietami kodów kreskowych z różnymi interfejsami API, różnymi typami wyników i różnymi tabelami obsługi formatów powoduje długoterminową złożoność, której pozwala uniknąć rozwiązanie oparte na jednym pakiecie.

Wprowadzenie przetwarzania BarCodes po stronie serwera

Aplikacje skanujące kody kreskowe na urządzeniach mobilnych często wykorzystują komponent po stronie serwera — punkt końcowy API ASP.NET, który weryfikuje kody kreskowe, zadanie w tle przetwarzające pliki PDF lub funkcję w chmurze, która wyodrębnia numery śledzenia z przesłanych dokumentów. BarcodeScanning.Native.Maui to biblioteka elementów interfejsu użytkownika, która opiera się na kontekście sprzętowym kamery; nie może działać w procesie serwera. Zespół, który potrzebuje tej samej logiki odczytu BarCode'ów zarówno na urządzeniach mobilnych, jak i na serwerze, musi użyć innej biblioteki po stronie serwera. Kiedy pojawia się wymóg po stronie serwera, zespoły często oceniają, czy konsolidacja do jednej biblioteki, która obejmuje zarówno urządzenia mobilne, jak i serwer, jest lepszym rozwiązaniem niż utrzymywanie dwóch oddzielnych implementacji.

Dokładność danych UPC-A staje się problemem produkcyjnym

Zachowanie 13-cyfrowego kodu UPC-A w systemie iOS nie zawsze jest wykrywane podczas tworzenia oprogramowania. BARCODE-y UPC-A skanowane podczas tworzenia mogą wydawać się działać poprawnie, ale w bazie danych pojawia się zerowy prefiks wprowadzony przez framework Apple Vision. Zespoły, które wykrywają 13-cyfrowe wartości UPC-A w rejestrach zapasów, systemach kasowych lub integracjach łańcucha dostaw, borykają się nie tylko z problemem kodowania, ale także z problemem korekty danych. Rozwiązanie opisane w zgłoszeniach na GitHubie w sekcji BarcodeScanning.Native.Maui koryguje nowe skany, ale nie naprawia danych historycznych. Kiedy zakres problemu związanego z jakością danych staje się jasny, przejście na bibliotekę, która zwraca poprawne wartości UPC-A bez normalizacji na poziomie aplikacji, jest często czystszym rozwiązaniem w perspektywie długoterminowej.

Wymagane skanowanie dokumentów PDF417

PDF417 to format BARCODE stosowany w etykietach wysyłkowych, prawach jazdy i kartach pokładowych w Ameryce Północnej. Są to typowe cele skanowania w aplikacjach logistycznych, do weryfikacji tożsamości i aplikacjach turystycznych. System śledzenia błędów BarcodeScanning.Native.Maui na GitHubie opisuje format PDF417 jako "bardzo problematyczny — większość skanów nigdy nie dochodzi do skutku". W przypadku każdej aplikacji, w której niezawodność formatu PDF417 jest wymogiem funkcjonalnym, a nie tylko miłym dodatkiem, ta znana usterka stanowi bezpośrednią przeszkodę, która wymusza rozważenie alternatywnych bibliotek.

Zdarzenie kamery do MediaPicker i odczyt statyczny

Podstawową zmianą strukturalną w migracji jest zastąpienie wzorca ciągłego zdarzenia kamery przez przechwycenie MediaPicker, po którym następuje BarcodeReader.Read(). Obsługa zdarzeń OnDetectionFinished, kontrolka XAML CameraView oraz deklaracja przestrzeni nazw XML scanner: zostały usunięte. Zamiast tego przycisk uruchamia MediaPicker.CapturePhotoAsync(), a wynikowe bajty zdjęcia są przekazywane do BarcodeReader.Read(). Zmienia to wrażenia użytkownika z podglądu na żywo na ekran aparatu systemówego — odpowiedni dla większości zastosowań biznesowych.

Zmiany w marshalingu wątków

BarcodeScanning.Native.Maui uruchamia OnDetectionFinished w wątku w tle, więc wszystkie istniejące procedury obsługi, które aktualizują elementy interfejsu użytkownika, zawijają swoje aktualizacje w MainThread.BeginInvokeOnMainThread(). Dzięki wzorcowi asynchronicznemu MediaPicker stosowanemu przez IronBarcode kontynuacja po await powraca do kontekstu wywołującego, którym zazwyczaj jest główny wątek. W większości przypadków można usunąć opakowania MainThread.BeginInvokeOnMainThread(), co upraszcza kod obsługi zdarzeń.

Usunięcie obejścia UPC-A

Każdy kod źródłowy obsługujący zachowanie 13-cyfrowego kodu UPC-A w BarcodeScanning.Native.Maui na iOS będzie zawierał kod sprawdzający BarcodeFormat.UPC_A i wywołujący Substring(1) w celu usunięcia początkowego zera. Ten kod należy usunąć po migracji — IronBarcode zwraca prawidłową 12-cyfrową wartość, a pozostawienie tego obejścia spowodowałoby nieprawidłowe usuwanie pierwszej cyfry z prawidłowych odczytów UPC-A.

Uprawnienia MAUI

BarcodeScanning.Native.Maui automatycznie dodaje uprawnienia do kamery do manifestów systemów Android i iOS w ramach konfiguracji pakietu. W przypadku korzystania z IronBarcode przy użyciu MediaPicker wymagańe są standardowe uprawnienia kamery MAUI w AndroidManifest.xml i Info.plist — te same uprawnienia, których potrzebuje każda aplikacja MAUI do MediaPicker.CapturePhotoAsync(). Uprawnienia te są zazwyczaj już obecne w projektach MAUI, które wykorzystują kamerę w dowolnym celu.