BarcodeScanning.MAUI와 IronBarcode: C# 바코드 라이브러리 비교

실시간 카메라 스캔 패턴

BarcodeScanning.Native.Maui API 패턴 전체는 XAML 컨트롤과 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

이 컨트롤을 통해 사용자는 MAUI 페이지에 내장된 실시간 뷰파인더를 사용할 수 있습니다. 카메라 영상이 활성화되어 있는 동안 바코드 감지가 지속적으로 이루어집니다. "대시하고 스캔"하는 것이 주된 상호작용인 소비자 앱에 매우 적합한 사용자 경험(UX)을 제공합니다. 제한 사항은 이 라이브러리가 지원하는 유일한 상호 작용 방식이라는 점입니다. iOS 또는 Android에서 실시간 카메라 감지 이상의 요구 사항이 발생하는 순간, BarcodeScanning.Native.Maui는 제공할 수 있는 것이 없습니다.

상세 기능 비교

바코드 스캐닝.MAUI 접근 방식

BarcodeScanning.Native.Maui는 각 플랫폼의 네이티브 카메라 감지 파이프라인을 래핑합니다. 안드로이드에서 ML Kit는 프레임을 처리합니다. iOS에서는 Apple의 Vision 프레임워크가 프레임을 처리합니다. 라이브러리는 이를 CameraView 이벤트가 있는 MAUI OnDetectionFinished 컨트롤로 표시합니다. 애플리케이션 코드는 이미지 바이트를 직접 처리하지 않고, 이벤트에서 나오는 감지된 바코드 값만 처리합니다.

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

이러한 설계의 결과로 다른 진입로는 없습니다. 카메라는 선택 사항이 아닙니다. 라이브러리가 알고 있는 유일한 입력 장치입니다. 서버, 파일, PDF 파일, 윈도우 컴퓨터 — 이 라이브러리에서 요구하는 의미의 카메라는 이 중 어느 것에도 없습니다.

IronBarcode접근법

IronBarcode는 BarcodeReader.Read() 정적 메서드를 통해 이미지 데이터를 수신합니다. 호출자는 어떤 출처에서든 데이터를 제공하고, 라이브러리는 이를 디코딩합니다. MAUI에서 데이터는 MediaPicker에서 가져옵니다; 서버에서는 폼 업로드를 통해 데이터가 생성됩니다. 데스크톱 애플리케이션에서는 파일 대화 상자에서 나옵니다.

//IronBarcodein 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;
}

//IronBarcodein 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

'IronBarcode in MAUI: capture a photo, then read barcodes from it
' NuGet: dotnet add package IronBarcode

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

이 코드는 iOS, Android 및 Windows MAUI에서 동일하게 실행됩니다. 서버 측의 경우, 동일한 BarcodeReader.Read() 메서드를 사용하여 업로드된 파일의 바이트 배열 또는 PDF 경로를 사용할 수 있습니다. IronBarcode 설명서에는 지원되는 모든 입력 유형이 나와 있습니다.

바코드 스캐닝.MAUI 접근 방식

BarcodeScanning.Native.Maui는 MAUI에서 Windows 대상을 지원하지 않습니다. 이는 일시적인 공백이 아니라 도서관 건축 구조의 구조적 결과입니다. 이 라이브러리는 iOS 전용(Vision 프레임워크) 및 Android 전용(ML Kit) 네이티브 API를 래핑합니다. Windows용 API는 없습니다. iOS, Android 및 Windows를 대상으로 하는 MAUI 애플리케이션을 개발하는 팀(표준적인 다중 대상 시나리오)은 세 가지 대상 모두에 대해 바코드 솔루션으로 BarcodeScanning.Native.Maui를 사용할 수 없습니다. 그들은 윈도우용 플랫폼별 코드를 별도로 구현하거나 라이브러리를 완전히 교체해야 합니다.

IronBarcode접근법

IronBarcode의 BarcodeReader.Read() 호출은 플랫폼별 코드 없이 Windows, iOS, Android 및 macOS MAUI대상에서 작동합니다. #if WINDOWS 블록, 조건부 종속성 로딩, 스텁 구현이 필요하지 않습니다. 파일 및 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");

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

IronBarcode MAUI 통합 가이드는 모든 MAUI 타겟에 대한 완벽한 설정 지침을 제공합니다.IronBarcodeBarcodeScanning.Native.Maui에 경로가 전혀 없는 ASP.NET, Docker, Azure Functions 및 AWS Lambda 환경에서 서버 측 배포도 지원합니다.

바코드 스캐닝.MAUI 접근 방식

iOS에서 BarcodeScanning.Native.Maui의 기본 감지 기능(Apple Vision)은 UPC-A 바코드에 대해 13자리 숫자를 반환합니다. UPC-A는 12자리 형식입니다. 앞에 추가된 0은 EAN-13 인코딩과 일치합니다. 라이브러리는 이 원시 값을 수정 없이 그대로 전달합니다. UPC-A 값을 데이터베이스에 저장하는 애플리케이션은 불필요하게 앞에 0이 붙은 레코드가 누적될 수 있습니다.

문서화된 해결 방법은 형식을 확인하고 값을 다듬는 것입니다.

// 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

이 임시 해결책은 형식 검사를 생략할 경우 0으로 시작하는 EAN-13 바코드를 조용히 손상시킵니다. PDF417은 GitHub 이슈에서 "매우 문제가 많음 - 대부분의 스캔이 이루어지지 않음"으로 별도로 문서화되어 있으며, 배송 라벨, 운전면허증 및 탑승권에 영향을 미칩니다.

IronBarcode접근법

IronBarcode 수동 정규화 없이 정확한 12자리 UPC-A 값을 반환합니다. PDF417은 안정적으로 읽을 수 있는 지원되는 형식입니다. 생성 기능 또한 IronBarcode의 API를 통해 이용할 수 있습니다.

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

바코드 데이터 정확도가 재고 조회, POS 거래 또는 공급망 통합에 직접적인 영향을 미치는 애플리케이션의 경우, IronBarcode의 올바른 형식 처리 기능은 BarcodeScanning.Native.Maui가 애플리케이션 코드에 남기는 일종의 프로덕션 버그를 제거합니다. IronBarcode 바코드 판독 설명서 에는 형식별 동작 방식이 자세히 설명되어 있습니다.

윈도우 마우이 타겟이 빌드에 추가되었습니다.

MAUI 애플리케이션은 일반적으로 iOS 및 Android를 대상으로 시작하여 애플리케이션이 성숙해지거나 Enterprise 배포 요구 사항이 확장됨에 따라 Windows를 추가합니다. Windows 타겟이 추가되면 BarcodeScanning.Native.Maui가 즉시 문제가 됩니다. Windows 구현이 없으며 라이브러리 내에 해결 방법도 없기 때문입니다. 이러한 상황에 처한 팀은 다른 라이브러리를 사용하여 Windows용으로 별도의 바코드 구현을 유지하거나, 전체 바코드 레이어를 모든 MAUI 대상에서 일관되게 작동하는 라이브러리로 마이그레이션해야 합니다. 두 번째 방법은 운영상 더 간단하며 플랫폼별 분기에 따른 유지 관리 부담을 없애줍니다.

파일 업로드 또는 PDF 처리 요구 사항이 추가되었습니다.

모바일 애플리케이션은 처음에는 카메라 실시간 스캔을 유일한 입력 방식으로 사용하다가 나중에는 업로드된 이미지나 문서를 입력받는 기능으로 확장되는 경우가 많습니다. 사용자가 갤러리의 사진, 이메일로 받은 이미지, 또는 선적 명세서나 탑승권이 포함된 PDF 파일에서 바코드를 스캔해야 할 경우, BarcodeScanning.Native.Maui는 제공할 수 있는 코드 경로가 없습니다. 이러한 요구 사항에 도달하는 팀은 두 가지 선택에 직면하게 됩니다. 파일 및 PDF 입력을 위해 BarcodeScanning.Native.Maui와 함께 두 번째 바코드 라이브러리를 추가하거나, 모든 입력 유형을 처리하는 단일 라이브러리로 마이그레이션하는 것입니다. 서로 다른 API, 결과 유형 및 형식 지원 테이블을 가진 두 개의 바코드 패키지를 관리하는 것은 장기적으로 복잡성을 증가시키지만, 단일 패키지 솔루션은 이러한 복잡성을 방지합니다.

서버 측 바코드 처리 기능 도입

모바일 기기에서 바코드를 스캔하는 애플리케이션은 종종 서버 측 구성 요소를 개발합니다. 예를 들어 바코드를 검증하는 ASP.NET API 엔드포인트, PDF를 처리하는 백그라운드 작업 또는 업로드된 문서에서 추적 번호를 추출하는 클라우드 함수 등이 있습니다. BarcodeScanning.Native.Maui는 카메라 하드웨어 컨텍스트에 의존하는 UI 컨트롤 라이브러리입니다. 서버 프로세스에서는 실행될 수 없습니다. 모바일과 서버 모두에서 동일한 바코드 인식 로직이 필요한 팀은 서버 측에 서로 다른 라이브러리를 사용해야 합니다. 서버 측 요구 사항이 발생하면 팀은 모바일과 서버를 모두 지원하는 단일 라이브러리로 통합하는 것이 두 개의 별도 구현을 유지하는 것보다 나은지 여부를 자주 평가합니다.

UPC-A 데이터 정확도가 생산 문제로 대두되고 있습니다.

iOS UPC-A 13자리 표기법의 특성은 개발 과정에서 항상 포착되는 것은 아닙니다. 개발 과정에서 스캔한 UPC-A 바코드는 정상적으로 작동하는 것처럼 보일 수 있지만, Apple의 Vision 프레임워크에서 추가된 선행 0이 데이터베이스에 나타납니다. 재고 기록, POS 시스템 또는 공급망 통합에서 13자리 UPC-A 값을 발견하는 팀은 코드 문제 외에도 데이터 수정 문제에 직면하게 됩니다. BarcodeScanning.Native.Maui의 GitHub 이슈에 설명된 해결 방법은 새 스캔은 수정하지만 과거 데이터는 수정하지 않습니다. 데이터 품질 문제의 범위가 명확해지면, 애플리케이션 수준의 정규화 없이 올바른 UPC-A 값을 반환하는 라이브러리로 마이그레이션하는 것이 장기적으로 더 깔끔한 해결책인 경우가 많습니다.

PDF417 문서 스캔 필요

PDF417은 북미 지역에서 배송 라벨, 운전면허증, 탑승권 등에 사용되는 바코드 형식입니다. 이것들은 물류, 신원 확인 및 여행 애플리케이션에서 흔히 사용되는 스캔 대상입니다. BarcodeScanning.Native.Maui의 GitHub 이슈 트래커에는 PDF417이 "매우 문제가 많으며 대부분의 스캔이 이루어지지 않는다"고 기록되어 있습니다. PDF417의 안정성이 선택 사항이 아닌 필수 기능인 애플리케이션의 경우, 이 알려진 문제는 개발을 가로막는 직접적인 장애물이 되어 다른 라이브러리를 검토해야만 합니다.

카메라 이벤트에서 MediaPicker 및 정적 읽기로의 전환

마이그레이션의 핵심 구조적 변화는 연속 카메라 이벤트 패턴을 MediaPicker 캡처에 이어 BarcodeReader.Read()로 대체하는 것입니다. 코드-51087--@@ 이벤트 핸들러, 코드-51088--@@ XAML 컨트롤, 코드-51089--@@ XML 네임스페이스 선언은 모두 제거되었습니다. 대신 버튼을 누르면 MediaPicker.CapturePhotoAsync()이 트리거되고 결과 사진 바이트가 BarcodeReader.Read()로 전달됩니다. 이를 통해 사용자 경험이 실시간 연속 뷰파인더에서 시스템 카메라 화면으로 변경되며, 이는 대부분의 비즈니스 애플리케이션에 적합합니다.

스레드 마샬링 변경 사항

BarcodeScanning.Native.Maui는 백그라운드 스레드에서 OnDetectionFinished를 실행하므로 UI 요소를 업데이트하는 모든 기존 핸들러는 업데이트를 MainThread.BeginInvokeOnMainThread()로 래핑합니다. IronBarcode에서 사용하는 MediaPicker + 비동기 패턴을 사용하면 await 뒤의 연속은 일반적으로 메인 스레드인 호출 컨텍스트에서 반환됩니다. 대부분의 경우 MainThread.BeginInvokeOnMainThread() 래퍼를 제거하여 이벤트 핸들러 코드를 간소화할 수 있습니다.

UPC-A 우회 방법 제거

바코드스캐닝.네이티브.마우이의 iOS UPC-A 13자리 동작을 처리하는 모든 코드베이스에는 BarcodeFormat.UPC_A를 확인하고 Substring(1)를 호출하여 앞의 0을 제거하는 코드가 있습니다. 마이그레이션 후 이 코드를 삭제해야 합니다.IronBarcode올바른 12자리 값을 반환하며, 임시 해결 방법을 그대로 두면 유효한 UPC-A 판독값에서 첫 번째 자리가 잘못 제거됩니다.

마우이 허가

BarcodeScanning.Native.Maui는 패키지 설정의 일부로 Android 및 iOS 매니페스트에 카메라 권한을 자동으로 추가합니다. 코드-51099--@@를 사용하는 IronBarcode의 경우 @@--코드-51100--@@ 및 @@--코드-51101--@@의 표준 MAUI 카메라 권한이 필요하며, 이는 모든 MAUI 앱이 @@--코드-51102--@@에 필요한 권한과 동일합니다. 이러한 권한은 일반적으로 카메라를 어떤 용도로든 사용하는 MAUI 프로젝트에 이미 존재합니다.