MAUI 바코드 스캐너와 IronBarcode 사용법: 단계별 가이드

MAUI 바코드 스캐너를 구축하기 위한 사전 요구 사항은 무엇입니까?

시작하기 전에 개발 환경을 정비하십시오:

• Visual Studio 2022 (v17.8 이상) 및 .NET MAUI 워크로드 설치
• .NET 10 SDK -- 공식 .NET 사이트에서 다운로드
• 기본 C# 지식 -- async/await 패턴에 대한 친숙함이 도움이 됩니다
• 카메라 테스트를 위한 물리적 기기 또는 에뮬레이터 구성
• IronBarcode 라이선스 -- 평가용 무료 체험판을 사용할 수 있습니다

프로젝트를 생성하기 전에 Visual Studio에 MAUI 워크로드가 설치되어 있는지 확인하면 나중에 문제 해결 시간을 크게 절약할 수 있습니다. Visual Studio 설치 관리자에서 "개별 구성 요소" 아래에서 ".NET Multi-platform App UI development"를 검색하여 이를 확인할 수 있습니다.

MAUI 바코드 스캔 프로젝트를 어떻게 설정합니까?

Visual Studio 2022에서 새로운 .NET MAUI App 프로젝트를 생성하세요. 프로젝트 이름을 BarcodeScannerApp으로 설정하고, 대상 프레임워크로 .NET 10을 선택하세요. Visual Studio는 Android, iOS, macOS 및 Windows에 대한 플랫폼별 폴더가 있는 표준 MAUI 프로젝트 구조를 생성합니다.

Install-Package BarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Android 및 iOS의 카메라 권한을 어떻게 구성합니까?

플랫폼별 카메라 권한은 바코드 스캐닝 기능에 필수적입니다. 각 플랫폼은 성공적인 MediaPicker.CapturePhotoAsync()을 위해 매니페스트 파일에 특정 구성이 필요합니다.

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

바코드 스캐너 인터페이스는 어떻게 만드나요?

스캔 프로세스 중 사용자에게 명확한 피드백을 제공하는 사용자 인터페이스를 MainPage.xaml에 설계하세요. 최소하지만 기능적인 레이아웃에는 이미지 미리보기, 결과 표시 영역 및 스캔 트리거 버튼이 포함됩니다:

<?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="BarcodeScannerApp.MainPage"
             Title="Barcode Scanner">
    <VerticalStackLayout Padding="20" Spacing="20">
        <Label Text="Point the camera at a barcode"
               FontSize="16"
               HorizontalOptions="Center"
               TextColor="#555555" />
        <Image x:Name="CapturedImage"
               HeightRequest="300"
               Aspect="AspectFit"
               BackgroundColor="#F0F0F0" />
        <Label x:Name="ResultLabel"
               Text="Tap Scan to begin"
               FontSize="18"
               HorizontalOptions="Center"
               FontAttributes="Bold" />
        <Label x:Name="FormatLabel"
               Text=""
               FontSize="13"
               HorizontalOptions="Center"
               TextColor="#888888" />
        <Button Text="Scan Barcode"
                Clicked="OnScanClicked"
                BackgroundColor="#007ACC"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
        <Button Text="Load from Gallery"
                Clicked="OnPickFromGalleryClicked"
                BackgroundColor="#5C5C5C"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
    </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="BarcodeScannerApp.MainPage"
             Title="Barcode Scanner">
    <VerticalStackLayout Padding="20" Spacing="20">
        <Label Text="Point the camera at a barcode"
               FontSize="16"
               HorizontalOptions="Center"
               TextColor="#555555" />
        <Image x:Name="CapturedImage"
               HeightRequest="300"
               Aspect="AspectFit"
               BackgroundColor="#F0F0F0" />
        <Label x:Name="ResultLabel"
               Text="Tap Scan to begin"
               FontSize="18"
               HorizontalOptions="Center"
               FontAttributes="Bold" />
        <Label x:Name="FormatLabel"
               Text=""
               FontSize="13"
               HorizontalOptions="Center"
               TextColor="#888888" />
        <Button Text="Scan Barcode"
                Clicked="OnScanClicked"
                BackgroundColor="#007ACC"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
        <Button Text="Load from Gallery"
                Clicked="OnPickFromGalleryClicked"
                BackgroundColor="#5C5C5C"
                TextColor="White"
                CornerRadius="8"
                HeightRequest="50" />
    </VerticalStackLayout>
</ContentPage>

이 레이아웃은 두 개의 스캔 경로를 제공합니다: 카메라로 새로운 사진을 촬영하거나 갤러리에서 기존 이미지를 선택합니다. 이는 사용자가 미리 바코드를 사진 찍거나 이메일을 통해 이미지를 받을 경우에 유용합니다. FormatLabel은 디버깅 및 사용자 확인 중에 감지된 바코드 형식을 디코딩된 값과 함께 표시합니다.

바코드 리더 기능은 어떻게 구현하나요?

MainPage.xaml.cs에서 핵심 스캔 로직을 구현하세요. 아래 코드는 적절한 비동기 패턴과 오류 처리를 통해 카메라 캡처 및 갤러리 선택을 모두 처리합니다:

using IronBarCode;
using IronSoftware.Drawing;

namespace BarcodeScannerApp;

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

    private async void OnScanClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.CapturePhotoAsync());
    }

    private async void OnPickFromGalleryClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.PickPhotoAsync());
    }

    private async Task ScanFromSource(Func<Task<FileResult?>> sourceFunc)
    {
        try
        {
            var photo = await sourceFunc();
            if (photo is null) return;

            using var stream = await photo.OpenReadAsync();
            using var memoryStream = new MemoryStream();
            await stream.CopyToAsync(memoryStream);
            var imageBytes = memoryStream.ToArray();

            // Show the captured image in the UI
            CapturedImage.Source = ImageSource.FromStream(() =>
                new MemoryStream(imageBytes));

            // Process with IronBarcode
            var bitmap = AnyBitmap.FromBytes(imageBytes);
            var options = new BarcodeReaderOptions
            {
                Speed = ReadingSpeed.Balanced,
                ExpectMultipleBarcodes = false
            };

            var results = await BarcodeReader.ReadAsync(bitmap, options);

            if (results.Any())
            {
                var first = results.First();
                ResultLabel.Text = $"Value: {first.Value}";
                FormatLabel.Text = $"Format: {first.BarcodeType}";
            }
            else
            {
                ResultLabel.Text = "No barcode detected";
                FormatLabel.Text = string.Empty;
            }
        }
        catch (FeatureNotSupportedException)
        {
            await DisplayAlert("Unsupported",
                "Camera is not available on this device.", "OK");
        }
        catch (PermissionException)
        {
            await DisplayAlert("Permission Required",
                "Please grant camera permission in Settings.", "OK");
        }
        catch (Exception ex)
        {
            await DisplayAlert("Error",
                $"Scanning failed: {ex.Message}", "OK");
        }
    }
}

using IronBarCode;
using IronSoftware.Drawing;

namespace BarcodeScannerApp;

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

    private async void OnScanClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.CapturePhotoAsync());
    }

    private async void OnPickFromGalleryClicked(object sender, EventArgs e)
    {
        await ScanFromSource(() => MediaPicker.Default.PickPhotoAsync());
    }

    private async Task ScanFromSource(Func<Task<FileResult?>> sourceFunc)
    {
        try
        {
            var photo = await sourceFunc();
            if (photo is null) return;

            using var stream = await photo.OpenReadAsync();
            using var memoryStream = new MemoryStream();
            await stream.CopyToAsync(memoryStream);
            var imageBytes = memoryStream.ToArray();

            // Show the captured image in the UI
            CapturedImage.Source = ImageSource.FromStream(() =>
                new MemoryStream(imageBytes));

            // Process with IronBarcode
            var bitmap = AnyBitmap.FromBytes(imageBytes);
            var options = new BarcodeReaderOptions
            {
                Speed = ReadingSpeed.Balanced,
                ExpectMultipleBarcodes = false
            };

            var results = await BarcodeReader.ReadAsync(bitmap, options);

            if (results.Any())
            {
                var first = results.First();
                ResultLabel.Text = $"Value: {first.Value}";
                FormatLabel.Text = $"Format: {first.BarcodeType}";
            }
            else
            {
                ResultLabel.Text = "No barcode detected";
                FormatLabel.Text = string.Empty;
            }
        }
        catch (FeatureNotSupportedException)
        {
            await DisplayAlert("Unsupported",
                "Camera is not available on this device.", "OK");
        }
        catch (PermissionException)
        {
            await DisplayAlert("Permission Required",
                "Please grant camera permission in Settings.", "OK");
        }
        catch (Exception ex)
        {
            await DisplayAlert("Error",
                $"Scanning failed: {ex.Message}", "OK");
        }
    }
}

이 구현은 공유 ScanFromSource 헬퍼 메서드를 사용하여 카메라와 갤러리 경로 간의 이미지 처리 로직 중복을 피합니다. AnyBitmap.FromBytes 메서드는 JPEG, PNG, WebP 및 기타 일반적인 이미지 형식을 자동으로 처리하므로 수동 형식 감지가 필요 없습니다.

결과 객체는 first.Value (디코딩된 문자열), first.BarcodeType (형식 열거형) 및 first.BarcodeImage (감지된 바코드 영역의 잘린 이미지) 등의 속성을 노출합니다. BarcodeResult 클래스 문서에서 전체 목록을 참조하세요.

고급 스캐닝 옵션은 어떻게 구성하나요?

IronBarcode는 특정 사용 사례에 맞게 감지 동작을 세밀하게 조정할 수 있는 BarcodeReaderOptions 객체를 제공합니다. 이러한 옵션을 이해하면 애플리케이션 필요에 따라 속도와 정확성 간의 균형을 맞출 수 있습니다.

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

일반 문제 해결 시나리오는 어떻게 처리하나요?

잘 구성된 MAUI 바코드 스캐너일지라도 장치별 동작, 이미지 품질 문제 또는 플랫폼 제약으로 인해 문제가 발생할 수 있습니다.

다음 단계는 무엇입니까?

이제 IronBarcode와 함께 작동하는 MAUI 바코드 스캐너가 있으므로, 애플리케이션 요구 사항에 따라 여러 경로가 있습니다:

• 바코드 생성 -- IronBarcode는 문자열 데이터를 사용하여 QR 코드, Code 128 레이블 및 기타 형식을 생성하기 위한 바코드 생성 API를 제공합니다
• 배치 스캔 -- ExpectMultipleBarcodes = true와 함께 BarcodeReader.ReadAsync을(를) 사용하여 여러 이미지 파일을 반복적으로 처리합니다; 배치 스캐닝 예제를 참조하세요
• PDF 바코드 추출 -- IronBarcode는 동일한 BarcodeReader 클래스를 사용하여 PDF 문서에 내장된 바코드를 읽을 수 있습니다; PDF 바코드 읽기 문서를 탐색하십시오
• 스타일링 및 브랜딩 -- 생성된 바코드의 시각적 출력을 색상, 로고, 주석으로 사용자 정의합니다; 바코드 스타일링 옵션을 참조하세요
• 다른 IronSoftware 제품 -- MAUI 앱이 PDF 생성, OCR 또는 스프레드시트 지원이 필요하다면, 전체 Iron Suite를 탐색하여 일관된 크로스 플랫폼 기능을 이용하십시오

제한 없이 배포할 수 있는 무료 체험판 라이선스로 시작하여 평가 기간 동안 사용하십시오. 제품 라이선싱 옵션 및 대량 가격 정보를 보려면 IronBarcode 가격 페이지를 방문하십시오. IronBarcode 문서 포털과 IronBarcode GitHub 리포지토리는 추가 코드 예제와 커뮤니티 지원을 제공합니다.