.NET MAUI Skaner kodów QR

Updated: 3 marca 2026

Wprowadzenie

.NET MAUI (.NET Multi-platform App UI) to multiplatformowy framework do tworzenia natywnych aplikacji mobilnych i desktopowych z jednego kodu źródłowego w C#. Jeden projekt może celować w Androida, iOS, macOS i Windows, udostępniając układy interfejsu użytkownika i logikę biznesową na wszystkich platformach. Integracja MAUI z ekosystemem .NET oznacza, że programiści mogą dotrzeć do użytkowników mobilnych bez rezygnacji z znanych narzędzi lub języków.

W tym artykułe wyjaśnimy, jak zbudować natywny skaner kodów QR w aplikacji .NET MAUI, używając IronQR do dekodowania kodów QR wybranych z biblioteki zdjęć urządzenia.

Jak zbudować skaner kodów QR w .NET MAUI

Zainstaluj bibliotekę C# IronQR, aby skanować kody QR na urządzeniach mobilnych
Zaprojektuj układ aplikacji w MainPage.xaml
Użyj FilePicker, aby umożliwić użytkownikowi wybranie obrazu kodu QR z urządzenia
Zaladuj obraz i owin go w QrImageInput
Wywołaj Read i wyświetl zdekodowaną wartość w Label

IronQR: C# Biblioteka kodów QR

Aby odczytywać kody QR w aplikacji, użyjemy biblioteki IronQR dla .NET. Zapewnia ona prosty API do wykrywania i dekodowania kodów QR z dowolnego źródła obrazów, w tym plików wybranych na urządzeniu mobilnym. IronQR działa na wszystkich platformach docelowych MAUI i nie wymaga wiedzy domenowej o kodach kreskowych do integracji.

IronQR może dekodować standardowe kody QR, Micro QR i kody rMQR, przyjmując wejście obrazów jako pliki, strumienie lub bitmapy. Można ją zainstalować w kilka sekund za pomocą Menedżera pakietów NuGet.

Kroki budowy skanera kodów QR w .NET MAUI

Postępuj według tych kroków, aby dodać skanowanie kodu QR do aplikacji .NET MAUI.

Wymagania wstępne

Visual Studio 2022 z zainstalowanym środowiskiem pracy .NET MAUI
Projekt .NET MAUI celujący w Androida lub iOS

Zainstaluj IronQR

Zainstaluj bibliotekę IronQR za pomocą NuGet Package Manager Console w Visual Studio. Nawiguj do Tools > NuGet Package Manager > Package Manager Console i uruchom:

PM > Install-Package IronQR

Install-Package IronQR

Alternatywnie, wyszukaj IronQR na NuGet i zainstaluj najnowsza wersje.

Projektowanie front-endu

Interfejs użytkownika skanera składa się z przycisku do wyzwalania wyboru obrazu, widoku obrazu do podglądu wybranego kodu QR oraz etykiety do wyświetlania zdekodowanego wyniku.

Zastap zawartosc MainPage.xaml nastepujacym:

<?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="MauiQrScanner.MainPage">

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Button
                x:Name="scanButton"
                Text="Select QR Code Image"
                SemanticProperties.Hint="Select Image"
                Clicked="OnScanButtonClicked"
                HorizontalOptions="Center" />

            <Image
                x:Name="qrImage"
                SemanticProperties.Description="Selected QR Code"
                HeightRequest="200"
                HorizontalOptions="Center" />

            <Label
                x:Name="resultLabel"
                Text="Scanned Text: "
                HorizontalOptions="Center"
                VerticalOptions="Center" />

        </VerticalStackLayout>
    </ScrollView>

</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="MauiQrScanner.MainPage">

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Button
                x:Name="scanButton"
                Text="Select QR Code Image"
                SemanticProperties.Hint="Select Image"
                Clicked="OnScanButtonClicked"
                HorizontalOptions="Center" />

            <Image
                x:Name="qrImage"
                SemanticProperties.Description="Selected QR Code"
                HeightRequest="200"
                HorizontalOptions="Center" />

            <Label
                x:Name="resultLabel"
                Text="Scanned Text: "
                HorizontalOptions="Center"
                VerticalOptions="Center" />

        </VerticalStackLayout>
    </ScrollView>

</ContentPage>

XML

Przykładowe dane wejściowe

Użyj poniższego kodu QR jako obrazu testowego. Zapisz to na swoim urządzeniu, a następnie wybierz przez selektor plików aplikacji. Odszyfrowana wartosc powinna wyswietlic sie jako https://ironsoftware.com.

Przykładowy kod QR kodujący https://ironsoftware.com do testowania skanera QR w .NET MAUI

Przykładowy kod QR — koduje https://ironsoftware.com

Skanowanie kodów QR za pomocą IronQR

Po stuknieciu przycisku skanowania, FilePicker otwiera biblioteke obrazow urzadzenia. Po wybraniu zdjecia przez uzytkownika, pelna sciezka jest ladowana do AnyBitmap, ktory jest przekazywany do QrReader.Read(). Zdekodowana wartość z pierwszego wykrytego kodu QR jest wyświetlana w etykiecie wyników.

Dodaj nastepujaca metode do MainPage.xaml.cs:

using IronQr;
using IronSoftware.Drawing;

private async void OnScanButtonClicked(object sender, EventArgs e)
{
    // Start scanning QR codes
    var images = await FilePicker.Default.PickAsync(new PickOptions
    {
        PickerTitle = "Pick image",
        FileTypes = FilePickerFileType.Images
    });
    var imageSource = images.FullPath.ToString();

    var inputBmp = AnyBitmap.FromFile(imageSource);

    // Load the asset into QrImageInput
    QrImageInput imageInput = new QrImageInput(inputBmp);

    // Create a QR Reader object
    QrReader reader = new QrReader();

    // Read the input and get all embedded QR Codes
    IEnumerable<QrResult> results = reader.Read(imageInput);

    // Display the first result
    resultLabel.Text = "Scanned Text: " + results.First().Value;
}

using IronQr;
using IronSoftware.Drawing;

private async void OnScanButtonClicked(object sender, EventArgs e)
{
    // Start scanning QR codes
    var images = await FilePicker.Default.PickAsync(new PickOptions
    {
        PickerTitle = "Pick image",
        FileTypes = FilePickerFileType.Images
    });
    var imageSource = images.FullPath.ToString();

    var inputBmp = AnyBitmap.FromFile(imageSource);

    // Load the asset into QrImageInput
    QrImageInput imageInput = new QrImageInput(inputBmp);

    // Create a QR Reader object
    QrReader reader = new QrReader();

    // Read the input and get all embedded QR Codes
    IEnumerable<QrResult> results = reader.Read(imageInput);

    // Display the first result
    resultLabel.Text = "Scanned Text: " + results.First().Value;
}

Imports IronQr
Imports IronSoftware.Drawing

Private Async Sub OnScanButtonClicked(sender As Object, e As EventArgs)
    ' Start scanning QR codes
    Dim images = Await FilePicker.Default.PickAsync(New PickOptions With {
        .PickerTitle = "Pick image",
        .FileTypes = FilePickerFileType.Images
    })
    Dim imageSource = images.FullPath.ToString()

    Dim inputBmp = AnyBitmap.FromFile(imageSource)

    ' Load the asset into QrImageInput
    Dim imageInput As New QrImageInput(inputBmp)

    ' Create a QR Reader object
    Dim reader As New QrReader()

    ' Read the input and get all embedded QR Codes
    Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

    ' Display the first result
    resultLabel.Text = "Scanned Text: " & results.First().Value
End Sub

Imports IronQr
Imports IronSoftware.Drawing

Private Async Sub OnScanButtonClicked(sender As Object, e As EventArgs)
    ' Start scanning QR codes
    Dim images = Await FilePicker.Default.PickAsync(New PickOptions With {
        .PickerTitle = "Pick image",
        .FileTypes = FilePickerFileType.Images
    })
    Dim imageSource = images.FullPath.ToString()

    Dim inputBmp = AnyBitmap.FromFile(imageSource)

    ' Load the asset into QrImageInput
    Dim imageInput As New QrImageInput(inputBmp)

    ' Create a QR Reader object
    Dim reader As New QrReader()

    ' Read the input and get all embedded QR Codes
    Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

    ' Display the first result
    resultLabel.Text = "Scanned Text: " & results.First().Value
End Sub

FilePicker.Default.PickAsync jest dostarczany przez warstwe abstrakcji platformy MAUI i dziala na Android, iOS i Windows bez jakiegokolwiek kodu specyficznego dla platformy. AnyBitmap.FromFile obsluguje dekodowanie obrazu, a QrReader.Read zwraca IEnumerable<QrResult> z jednym wpisem na kazdy kod QR znaleziony na obrazie.

Wynik

Wybranie obrazu kodu QR wyzwala skanowanie. Zdekodowana wartość pojawia się w etykiecie wyników poniżej podglądu obrazu.

Skaner kodów QR w .NET MAUI z użyciem IronQR — aplikacja wybierająca obraz kodu QR i wyświetlająca zdekodowaną wartość

Kod QR wybrany, a zdekodowana wartość wyświetlona w etykiecie wyniku

Pobierz projekt

Kliknij tutaj, aby pobrać kompletny projekt MauiQrScanner.

Wnioski

W tym artykułe pokazaliśmy, jak zbudować natywny skaner kodów QR w aplikacji .NET MAUI, używając IronQR. API FilePicker zapewnia wybieranie obrazow natywnie na platformach Android, iOS i Windows, natomiast QrReader.Read w IronQR obsluguje dekodowanie jednoczesnie w jednym wywolaniu. To samo podejscie skaluje sie do wielu kodow QR na obraz przez iterowanie nad pelna kolekcja wynikow zamiast wywolywania .First().

IronQR wymaga licencji do użytku w środowisku deweloperskim i komercyjnym. Szczegóły licencji dostępne tutaj.

Aby szczegółowo przyjrzeć się odczytywaniu właściwości kodu QR poza wartością, zobacz przewodniki Read QR Code Value i Read QR Code Type.

Często Zadawane Pytania

O czym jest Samouczek skanera QR kodow .NET MAUI?

Samouczek skanera QR kodow .NET MAUI dostarcza wskazowek dotyczących budowania skanera kodow QR z uzyciem IronQR, z instrukcjami dostosowanymi do aplikacji .NET MAUI na platformach Android, iOS i Windows.

Ktore platformy sa obslugiwane przez skaner kodow QR .NET MAUI?

Skaner kodow QR .NET MAUI obsluguje platformy Android, iOS i Windows, pozwalajac programistom na tworzenie aplikacji wieloplatformowych z uzyciem IronQR.

Jak moge wybrac obrazy do skanowania kodow QR w aplikacji .NET MAUI?

Mozesz uzyc komponentu FilePicker w aplikacji .NET MAUI, aby wybrac obrazy, ktore nastepnie moga byc przetwarzane przez metode QrReader.Read() IronQR do dekodowania kodow QR.

Jaka funkcja jest uzywana do dekodowania kodow QR w samouczku?

W samouczku do dekodowania kodow QR z wybranych obrazow w aplikacji .NET MAUI uzywana jest funkcja QrReader.Read() z IronQR.

Czy moge uzyc IronQR do skanowania kodow QR w aplikacji multiplatformowej?

Tak, IronQR jest zaprojektowane do uzytku w aplikacjach multiplatformowych, a za pomoca frameworka .NET MAUI mozesz tworzyc skanery kodow QR dla platform Android, iOS i Windows.

Czy istnieje specyficzna funkcja czytnika kodow QR dla .NET MAUI?

Tak, samouczek pokazuje, jak uzywac funkcji QrReader.Read() z IronQR w aplikacji .NET MAUI do odczytu i dekodowania kodow QR.

Czy IronQR obsluguje skanowanie kodow QR na urzadzeniach mobilnych?

IronQR obsluguje skanowanie kodow QR na urzadzeniach mobilnych, w tym Android i iOS, co jest widoczne w Samouczku skanera kodow QR .NET MAUI.

Jaka jest rola FilePicker w procesie skanowania kodow QR?

FilePicker sluzy do wyboru obrazow z pamieci urzadzenia, ktore nastepnie sa przekazywane do QrReader.Read() IronQR w aplikacji .NET MAUI do dekodowania kodow QR.

Czy jest mozliwe zintegrowanie skanera kodow QR z aplikacja Windows uzywajac .NET MAUI?

Tak, Samouczek skanera kodow QR .NET MAUI pokazuje, jak zintegrowac skaner kodow QR z aplikacja Windows uzywajac IronQR.

What are the capabilities of the QRReader.Read method in IronQR?

The QrReader.Read method in IronQR can decode QR codes from various image sources like files, streams, or bitmaps and provides the results as an IEnumerable.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...

Czytaj więcej