Jak zbudować aplikację SDK do skanowania kodów kreskowych w .NET MAUI

Jak skonfigurować SDK skanera BARCODE w .NET MAUI?

Konfiguracja zestawu SDK skanera kodów kreskowych .NET MAUI wymaga utworzenia nowego projektu, zainstalowania pakietu NuGet oraz skonfigurowania uprawnień platformy. Cały proces konfiguracji zajmuje kilka minut w Visual Studio.

Install-Package BarCode

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

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

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

using IronBarCode;

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

return builder.Build();

using IronBarCode;

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });

// Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE";

return builder.Build();

Imports IronBarCode

Dim builder = MauiApp.CreateBuilder()
builder _
    .UseMauiApp(Of App)() _
    .ConfigureFonts(Sub(fonts)
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular")
    End Sub)

' Activate IronBarcode before the app starts
License.LicenseKey = "YOUR_LICENSE_KEY_HERE"

Return builder.Build()

Jak odczytywać BarCodes z plików graficznych?

Podstawową funkcją każdego skanera BARCODE MAUI jest odczytywanie BARCODE-ów z wybranych obrazów. Metoda BarcodeReader.Read() przyjmuje sciezke do pliku i zwraca kolekcje obiektow BarcodeResult, jeden na kazdy wykryty kod kreskowy.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

using IronBarCode;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });

        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);

            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);

            ResultLabel.Text = barcodes.Any()
                ? $"Found: {barcodes.First().Value}"
                : "No barcodes detected in selected image.";
        }
    }
}

using IronBarCode;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });

        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);

            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);

            ResultLabel.Text = barcodes.Any()
                ? $"Found: {barcodes.First().Value}"
                : "No barcodes detected in selected image.";
        }
    }
}

Imports IronBarCode

Public Partial Class MainPage
    Inherits ContentPage

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Async Sub OnSelectImageClicked(sender As Object, e As EventArgs)
        Dim result = Await FilePicker.PickAsync(New PickOptions With {
            .FileTypes = FilePickerFileType.Images,
            .PickerTitle = "Select a barcode image"
        })

        If result IsNot Nothing Then
            ' Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath)

            ' Read barcodes from the image file
            Dim barcodes = BarcodeReader.Read(result.FullPath)

            ResultLabel.Text = If(barcodes.Any(), $"Found: {barcodes.First().Value}", "No barcodes detected in selected image.")
        End If
    End Sub
End Class

Jak skanować BarCodes z dokumentów PDF?

Jedną z funkcji, która wyróżnia IronBarcode spośród wielu alternatywnych rozwiązań, jest odczytywanie kodów kreskowych bezpośrednio z plików PDF. Ma to kluczowe znaczenie dla aplikacji .NET MAUI obsługujących przepływ dokumentów — listy przewozowe, zamówienia zakupu, dokumentacja medyczna i podobne przypadki użycia opierają się na BARCODES-ach osadzonych w plikach PDF.

Metoda BarcodeReader.ReadPdf() przyjmuje sciezke do pliku i zwraca taka sama kolekcje BarcodeResult jak czytnik obrazow, z dodatkowa wlasciwoscia PageNumber identyfikujaca, z ktorej strony PDF pochodzi kazdy kod kreskowy:

using IronBarCode;

private async void OnSelectPdfClicked(object sender, EventArgs e)
{
    var result = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select a PDF with barcodes"
    });

    if (result != null)
    {
        // Read barcodes from every page of the PDF
        var barcodes = BarcodeReader.ReadPdf(result.FullPath);

        var output = string.Join("\n", barcodes.Select(b =>
            $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"));

        await DisplayAlert("Scan Results", output.Length > 0 ? output : "No barcodes found.", "OK");
    }
}

using IronBarCode;

private async void OnSelectPdfClicked(object sender, EventArgs e)
{
    var result = await FilePicker.PickAsync(new PickOptions
    {
        PickerTitle = "Select a PDF with barcodes"
    });

    if (result != null)
    {
        // Read barcodes from every page of the PDF
        var barcodes = BarcodeReader.ReadPdf(result.FullPath);

        var output = string.Join("\n", barcodes.Select(b =>
            $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"));

        await DisplayAlert("Scan Results", output.Length > 0 ? output : "No barcodes found.", "OK");
    }
}

Imports IronBarCode

Private Async Sub OnSelectPdfClicked(sender As Object, e As EventArgs)
    Dim result = Await FilePicker.PickAsync(New PickOptions With {
        .PickerTitle = "Select a PDF with barcodes"
    })

    If result IsNot Nothing Then
        ' Read barcodes from every page of the PDF
        Dim barcodes = BarcodeReader.ReadPdf(result.FullPath)

        Dim output = String.Join(vbLf, barcodes.Select(Function(b) $"Page {b.PageNumber}: [{b.BarcodeType}] {b.Value}"))

        Await DisplayAlert("Scan Results", If(output.Length > 0, output, "No barcodes found."), "OK")
    End If
End Sub

Jak radzisz sobie z wieloma kodami kreskowymi i kodami QR?

Aplikacje produkcyjne często muszą wykrywać wiele BARCODE-ów na jednym obrazie lub filtrować wyniki według typu BARCODE-a. Klasa BarcodeReaderOptions ujawnia wlasciwosci konfiguracji, ktore kontroluja zachowanie wykrywania. Ustawienie ExpectMultipleBarcodes na true nakazuje czytnikowi kontynuowanie skanowania po pierwszym dopasowaniu, zamiast wczesnego zatrzymania:

using IronBarCode;

// Configure the reader for multi-barcode detection with type filtering
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}");
}

using IronBarCode;

// Configure the reader for multi-barcode detection with type filtering
var options = new BarcodeReaderOptions
{
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    Speed = ReadingSpeed.Balanced
};

var barcodes = BarcodeReader.Read(imagePath, options);

foreach (var barcode in barcodes)
{
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}");
}

Imports IronBarCode

' Configure the reader for multi-barcode detection with type filtering
Dim options As New BarcodeReaderOptions With {
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128,
    .Speed = ReadingSpeed.Balanced
}

Dim barcodes = BarcodeReader.Read(imagePath, options)

For Each barcode In barcodes
    Console.WriteLine($"Type: {barcode.BarcodeType}, Value: {barcode.Value}")
Next

Wlasciwosc Speed kontroluje kompromis miedzy czasem skanowania a dokladnoscia. ReadingSpeed.Faster stawia na przepustowosc, co odpowiada aplikacjom skanujacym hurtowe ilosci wysokiej jakosci obrazow. ReadingSpeed.ExtraSlow stosuje bardziej agresywne sposoby korekcji obrazu przy trudnych danych wejsciowych -- niskim kontraście, przekatnych katow lub czesciowo przeslonietych kodach. ReadingSpeed.Balanced jest odpowiednim punktem wyjscia dla wiekszosci aplikacji.

Wyliczenie BarcodeEncoding wspiera kombinacje bitowe, co pozwala ograniczyc skanowanie do konkretnych symbologii istotnych dla przypadku uzycia, nie obciazajac wydajnosci niepotrzebnymi sprawdzaniami.

Jak odczytywać BarCodes ze strumieni pamięci?

Ścieżki plików sprawdzają się w większości scenariuszy, ale niektóre przepływy pracy .NET MAUI przekazują dane obrazu przez pamięć — klatki przechwycone z podglądu kamery, bajty pobrane z REST API lub dane obrazu generowane w trakcie procesu. IronBarcode obsluguje bezposrednie dane wejściowe System.IO.Stream na przeciazeniu BarcodeReader.Read():

using IronBarCode;
using System.IO;

// Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
private BarcodeResult[] ReadFromStream(Stream imageStream)
{
    return BarcodeReader.Read(imageStream);
}

// Example: download an image and scan without writing to disk
private async Task<string> ScanDownloadedBarcode(string imageUrl)
{
    using var httpClient = new HttpClient();
    using var stream = await httpClient.GetStreamAsync(imageUrl);
    using var memoryStream = new MemoryStream();

    await stream.CopyToAsync(memoryStream);
    memoryStream.Position = 0;

    var barcodes = BarcodeReader.Read(memoryStream);
    return barcodes.Any() ? barcodes.First().Value : string.Empty;
}

using IronBarCode;
using System.IO;

// Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
private BarcodeResult[] ReadFromStream(Stream imageStream)
{
    return BarcodeReader.Read(imageStream);
}

// Example: download an image and scan without writing to disk
private async Task<string> ScanDownloadedBarcode(string imageUrl)
{
    using var httpClient = new HttpClient();
    using var stream = await httpClient.GetStreamAsync(imageUrl);
    using var memoryStream = new MemoryStream();

    await stream.CopyToAsync(memoryStream);
    memoryStream.Position = 0;

    var barcodes = BarcodeReader.Read(memoryStream);
    return barcodes.Any() ? barcodes.First().Value : string.Empty;
}

Imports IronBarCode
Imports System.IO
Imports System.Net.Http
Imports System.Threading.Tasks

' Read a barcode from a MemoryStream (e.g., an in-memory image buffer)
Private Function ReadFromStream(imageStream As Stream) As BarcodeResult()
    Return BarcodeReader.Read(imageStream)
End Function

' Example: download an image and scan without writing to disk
Private Async Function ScanDownloadedBarcode(imageUrl As String) As Task(Of String)
    Using httpClient As New HttpClient()
        Using stream As Stream = Await httpClient.GetStreamAsync(imageUrl)
            Using memoryStream As New MemoryStream()
                Await stream.CopyToAsync(memoryStream)
                memoryStream.Position = 0

                Dim barcodes = BarcodeReader.Read(memoryStream)
                Return If(barcodes.Any(), barcodes.First().Value, String.Empty)
            End Using
        End Using
    End Using
End Function

Przeciazenie strumienia przyjmuje kazda podklase Stream, w tym MemoryStream, FileStream i strumienie sieciowe. Biblioteka obsluguje wewnetrzna detekcje formatu, wiec nie musisz okreslac typu obrazu przed wywolaniem Read().

Jak generować BarCodes w aplikacji MAUI?

IronBarcode obsługuje zarówno generowanie, jak i odczytywanie kodów kreskowych. Klasa BarcodeWriter tworzy kody kreskowe jako pliki obrazu, obiekty Bitmap lub instancje Stream, ktore mozesz wyswietlac bezposrednio w widoku MAUI. Jest to przydatne w aplikacjach do zarządzania zapasami, które oprócz funkcji skanowania wymagają drukowania lub udostępniania BarCodes:

using IronBarCode;

// Generate a QR code and display it in a MAUI Image control
private async void OnGenerateQrClicked(object sender, EventArgs e)
{
    // Create a QR code barcode
    var qrCode = QRCodeWriter.CreateQrCode(
        value: "https://ironsoftware.com/csharp/barcode/",
        qrCodeSize: 500,
        errorCorrection: QRCodeWriter.QrErrorCorrectionLevel.Medium
    );

    // Save to a temporary file and display
    var tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png");
    qrCode.SaveAsPng(tempPath);

    GeneratedImageView.Source = ImageSource.FromFile(tempPath);
}

using IronBarCode;

// Generate a QR code and display it in a MAUI Image control
private async void OnGenerateQrClicked(object sender, EventArgs e)
{
    // Create a QR code barcode
    var qrCode = QRCodeWriter.CreateQrCode(
        value: "https://ironsoftware.com/csharp/barcode/",
        qrCodeSize: 500,
        errorCorrection: QRCodeWriter.QrErrorCorrectionLevel.Medium
    );

    // Save to a temporary file and display
    var tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png");
    qrCode.SaveAsPng(tempPath);

    GeneratedImageView.Source = ImageSource.FromFile(tempPath);
}

Imports IronBarCode

' Generate a QR code and display it in a MAUI Image control
Private Async Sub OnGenerateQrClicked(sender As Object, e As EventArgs)
    ' Create a QR code barcode
    Dim qrCode = QRCodeWriter.CreateQrCode(
        value:="https://ironsoftware.com/csharp/barcode/",
        qrCodeSize:=500,
        errorCorrection:=QRCodeWriter.QrErrorCorrectionLevel.Medium
    )

    ' Save to a temporary file and display
    Dim tempPath = Path.Combine(FileSystem.CacheDirectory, "generated-qr.png")
    qrCode.SaveAsPng(tempPath)

    GeneratedImageView.Source = ImageSource.FromFile(tempPath)
End Sub

Klasa QRCodeWriter obsluguje wszystkie cztery poziomy korekcji bledow w kodach QR (Niski, Sredni, Kwartyl, Wysoki), niestandardowe rozmiary oraz opcje stylizacji, w tym kontrole koloru tla/przedniego planu. Dla symbologii innych niz QR, uzyj BarcodeWriter.CreateBarcode() z odpowiednia wartoscia BarcodeEncoding. Dokumentacja API generowania kodów kreskowych zawiera informacje o wszystkich obsługiwanych formatach wyjściowych.

Jakie są kluczowe możliwości tej biblioteki skanera BarCode?

IronBarcode zapewnia kilka korzyści dla projektów skanowania kodów kreskowych .NET MAUI, które odróżniają go od alternatywnych rozwiązań open source, takich jak ZXing.Net.MAUI:

Kwestia "braku zależności od natywnego SDK" ma znaczenie w projektach .NET MAUI, ponieważ biblioteki natywne specyficzne dla platformy wymagają oddzielnych etapów łączenia dla każdego celu. IronBarcode całkowicie eliminuje tę złożoność, co oznacza, że to samo odwołanie NuGet generuje działające pliki binarne dla wszystkich trzech obsługiwanych platform bez dodatkowej konfiguracji.

Pełna lista obsługiwanych formatów kodów kreskowych znajduje się w dokumentacji dotyczącej formatów obsługiwanych przez IronBarcode. Aby zapoznać się z cenami i warunkami licencji dotyczącymi wdrożenia produkcyjnego, przejrzyj stronę licencyjną IronBarcode.

Jakie są najlepsze praktyki dotyczące skanowania BarCodes w produkcji?

Wdrożenie skanera BARCODE do środowiska produkcyjnego wymaga zwrócenia uwagi na kilka obszarów wykraczających poza podstawowe wywołanie odczytu. Poniższe wytyczne dotyczą najczęstszych błędów w aplikacjach do obsługi kodów kreskowych .NET MAUI.

Wybierz odpowiednia predkosc czytania. ReadingSpeed.Balanced poprawnie obsluguje wiekszosc obrazow z prawdziwego swiata. Zarezerwuj ReadingSpeed.ExtraSlow dla skanow dokumentow drukowanych lub obrazow, ktorych uzytkownicy nie moga ponownie uchwycic. Unikaj ReadingSpeed.ExtraSlow w przypadku przeplywow z duza iloscia pracy, poniewaz kazde skanowanie zajmuje znacznie dluzej.

Filtrowanie wedlug oczekiwanych typow. Jesli aplikacja przetwarza tylko kody QR, ustaw ExpectBarcodeTypes = BarcodeEncoding.QRCode. Ograniczenie obszaru wyszukiwania skraca czas przetwarzania i eliminuje fałszywe alarmy spowodowane innymi symbolami obecnymi w grafice tła.

Uzywaj ExpectMultipleBarcodes tylko w razie potrzeby. Ustawienie tego na true zawsze powoduje, ze czytnik wykonuje dodatkowe przejscia. Dla danych wejsciowych z jednym kodem kreskowym pozostaw domyslne (false), aby skanowanie zakonczone bylo, gdy tylko zostanie znaleziony pierwszy poprawny kod.

Obsluguj puste wyniki z wdziekiem. BarcodeReader.Read() zwraca pusta tablice, zamiast generowac blad, gdy nie zostana wykryte zadne kody kreskowe. Sprawdz .Any() przed uzyskaniem dostepu do First() i przekaz uzytkownikowi jasny komunikat. Monit o ponowną próbę z instrukcją ("upewnij się, że BarCode jest dobrze oświetlony i wyśrodkowany") poprawia komfort użytkowania bardziej niż ogólny komunikat o błędzie.

Przechowuj w pamieci podręcznej obiekt opcji. Tworzenie instancji BarcodeReaderOptions przy kazdym skanowaniu dodaje alokacje. Zdefiniuj opcje raz na poziomie klasy i wykorzystuj je wielokrotnie w kolejnych wywołaniach.

Aby uzyskać dodatkowe wskazówki dotyczące diagnozowania błędów skanowania i optymalizacji wydajności, zapoznaj się z przewodnikiem rozwiązywania problemów IronBarcode oraz samouczkiem dotyczącym czytnika kodów kreskowych.

Jakie są Twoje kolejne kroki?

Budowanie skanera kodow kreskowych .NET MAUI z IronBarcode wymaga zainstalowania jednej paczki NuGet, skonfigurowania uprawnien platformowych oraz wywolania BarcodeReader.Read() ze sciezka do pliku lub strumieniem. To samo API jest przeznaczone dla systemów Android, iOS i Windows bez gałęzi kodu specyficznych dla danej platformy.

Aby rozszerzyć możliwości aplikacji, warto rozważyć następujące zasoby:

• Pełna lista funkcji IronBarcode — katalog wszystkich możliwości skanowania i generowania
• Dokumentacja API czytnika kodów kreskowych — kompletna dokumentacja metod i właściwości
• Samouczek krok po kroku dotyczący czytnika BARCODE — rozszerzony przewodnik obejmujący integrację z kamerą
• Przewodnik po skanerze dokumentów MAUI — przykłady zastosowań skanowania dokumentów

Bezpłatna próba, aby uzyskać klucz licencyjny do celów programistycznych, lub zapoznaj się z opcjami licencyjnymi dotyczącymi wdrożenia produkcyjnego.