如何構建.NET MAUI條碼掃描器SDK應用程式

如何在 .NET MAUI 中設置一個條碼掃描器 SDK？

設置一個 .NET MAUI 條碼掃描器 SDK 需要創建一個新項目、安裝 NuGet 套件並配置平台權限。 整個配置過程在 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();

如何從圖像文件中讀取條碼？

任何 MAUI 條碼掃描器的核心功能都是從選定的圖像中讀取條碼。 BarcodeReader.Read() 方法接受一個文件路徑並返回一個 BarcodeResult 對象集合，每個探測到的條碼一個。

<?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.";
        }
    }
}

如何從 PDF 文件中掃描條碼？

將條碼直接從 PDF 文件中讀取是區分 IronBarcode 與眾多替代方案的一個功能。 這是處理文檔工作流的 .NET MAUI 應用所必須的——運送清單、採購訂單、醫療記錄和類似的平台都依賴於 PDF 內嵌條碼。

BarcodeReader.ReadPdf() 方法接受文件路徑並返回圖像讀取器的相同 BarcodeResult 集合，並帶有附加的 PageNumber 屬性，識別條碼來自哪個 PDF 頁面：

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");
    }
}

如何處理多個條碼和 QR 代碼？

生產應用程序通常需要從單個圖像檢測多個條碼或按條碼類型篩選結果。 BarcodeReaderOptions 類公開了控制檢測行為的配置屬性。 將 ExpectMultipleBarcodes 設置為 true 告訴讀取器繼續掃描，直到找到第一個匹配後不停止：

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}");
}

Speed 屬性控制掃描時間與準確性之間的權衡。 ReadingSpeed.Faster 優先於吞吐量，適合批量掃描高質量影像的應用。ReadingSpeed.ExtraSlow 為具有挑戰性的輸入應用更積極的影像校正步驟——低對比、斜角或部分阻塞的代碼。 ReadingSpeed.Balanced 對於大多數應用程序來說，是正確的起點。

BarcodeEncoding 枚舉支持按位組合，因此您可以將掃描限制在與用例相關的符號，而不必因不必要的檢查而削弱性能。

如何從記憶體流中讀取條碼？

文件路徑在大多數場景中效果良好，但一些 .NET MAUI 工作流程會通過內存傳遞圖像數據——例如來自攝像機預覽的捕獲畫框，從 REST API 下載的字節，或進程內生成的圖像數據。 IronBarcode 支持 System.IO.Stream 直接輸入於 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;
}

Stream 重載接受任意的 Stream 子類，包括 FileStream 和網路流。 程式庫在內部處理格式檢測，因此您不需要在調用 Read() 之前指定圖像類型。

如何在 MAUI 應用中生成條碼？

IronBarcode 不僅是讀取，也可以處理條碼生成。 BarcodeWriter 類生成圖像文件、Bitmap 對象或 Stream 實例的條碼，您可在 MAUI 視圖中內嵌顯示。 這對於需要打印或共享條碼的庫存應用而言相當有用，同時具有掃描功能：

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);
}

QRCodeWriter 類支持所有四個 QR 糾錯級別(低、中、Quartile、高)、自訂大小和樣式選項，包括前景/背景顏色控制。 對於非 QR 符號，請使用 BarcodeWriter.CreateBarcode() 及適當的 BarcodeEncoding 值。 條碼生成 API 參考 錄有所有支持的輸出格式。

這個條碼掃描程式庫的主要功能是什麼？

IronBarcode 提供了多個在 .NET MAUI 條碼掃描項目中的優勢，區分於像 ZXing.Net.MAUI 這樣的開源替代方案：

在 .NET MAUI 專案中，"無原生 SDK 依賴"非常重要，因為平台特定的原生程式庫需要每個目標單獨連接步驟。 IronBarcode 完全避免了這種複雜性，這意味著相同的 NuGet 引用為所有三個支持的平台生成工作執行檔，無需額外配置。

欲了解完整的支持條碼格式列表，請參閱 IronBarcode 支持格式文檔。 有關生產部署的定價和授權條款，請查閱 IronBarcode 授權頁面。

生產中的條碼掃描最佳實踐是什麼？

將條碼掃描器部署到生產環境需要關注幾個領域，不僅僅是基本的讀取調用。 以下指南介紹了 .NET MAUI 條碼應用程序中最常見的故障點。

選擇正確的讀取速度。 ReadingSpeed.Balanced 可正確處理大多數現實世界的圖像。 保留 ReadingSpeed.ExtraSlow 用於打印文檔或用戶無法重新捕捉的圖像的掃嬸。 避免 ReadingSpeed.ExtraSlow 用於大批量工作流程，因為每次掃描都需要顯著更長的時間。

按預期類型過濾。 如果應用程序只處理 QR 代碼，請設置 ExpectBarcodeTypes = BarcodeEncoding.QRCode。 限制搜索空間可縮短處理時間，並消除背景圖形中存在其他符號的誤報。

僅在需要時使用 ExpectMultipleBarcodes 。 將其設置為 true 總是會導致讀取器進行額外的通過。 對於單一條碼輸入，請保留默認值 (false)，這樣掃描會在找到第一個有效代碼時立即返回。

優雅地處理空結果。 BarcodeReader.Read() 當未檢測到任何條碼時，將返回空數組而不會拋出異常。 在訪問 .Any() 之前進行檢查， First() 並向用戶顯示明確的信息。 提示重試指引("確保條碼光線充足且居中")比一般錯誤更能改善用戶體驗。

緩存選項對象。 在每次掃描中創建 BarcodeReaderOptions 實例會增加分配量。 在類級別構建選項並跨調用重用。

參閱 IronBarcode 問題排查指南 和 條碼讀取器教程 ，以獲得更多診斷掃描故障和優化性能的指南。

你的下一步行動是什麼？

使用 IronBarcode 構建 .NET MAUI 條碼掃描器需要安裝一個單一的 NuGet 套件，配置平台權限，並使用文件路徑或流調用 BarcodeReader.Read()。 同一個 API 針對 Android、iOS 和 Windows，無需平台特定的代碼分支。

要進一步擴展應用程序，請考慮以下資源：

• IronBarcode 全功能列表 —— 所有掃描和生成功能的目錄
• 條碼讀取器 API 參照 —— 完整的方法和屬性文檔
• MAUI 條碼讀取器逐步教程 —— 包含相機集成的擴展指南
• MAUI 文檔掃瞄指導 —— 文檔掃描用例

開始您的免費試用以獲得開發授權金鑰，或探索生產部署的授權選項。