IronOCR 과 Azure OCR PDF 중 어떤 솔루션이 텍스트 추출 성능이 더 뛰어날까요?

MAUI Lock-In 코드

AddTesseractOcr()를 호출하는 순간 OCR 로직이 MAUI 애플리케이션 호스트에 바인딩됩니다. 이를 공유 라이브러리로 추출할 방법이 없습니다:

// MauiProgram.cs — this registration only compiles inside a MAUI project
public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder.UseMauiApp<App>();

    // Registers ITesseract — MAUI DI only, no standalone equivalent
    builder.Services.AddTesseractOcr();

    return builder.Build();
}

// OCR service — ITesseract injected from MAUI container
public class MobileOcrService
{
    private readonly ITesseract _tesseract;

    public MobileOcrService(ITesseract tesseract)
    {
        _tesseract = tesseract; // Cannot be constructed outside MAUI host
    }

    public async Task<string> ExtractTextAsync(string imagePath)
    {
        await _tesseract.InitAsync("eng"); // traineddata must be bundled
        var result = await _tesseract.RecognizeTextAsync(imagePath);
        return result.Success ? result.RecognizedText : string.Empty;
    }
}

// MauiProgram.cs — this registration only compiles inside a MAUI project
public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();
    builder.UseMauiApp<App>();

    // Registers ITesseract — MAUI DI only, no standalone equivalent
    builder.Services.AddTesseractOcr();

    return builder.Build();
}

// OCR service — ITesseract injected from MAUI container
public class MobileOcrService
{
    private readonly ITesseract _tesseract;

    public MobileOcrService(ITesseract tesseract)
    {
        _tesseract = tesseract; // Cannot be constructed outside MAUI host
    }

    public async Task<string> ExtractTextAsync(string imagePath)
    {
        await _tesseract.InitAsync("eng"); // traineddata must be bundled
        var result = await _tesseract.RecognizeTextAsync(imagePath);
        return result.Success ? result.RecognizedText : string.Empty;
    }
}

Imports Microsoft.Maui
Imports Microsoft.Extensions.DependencyInjection

' MauiProgram.vb — this registration only compiles inside a MAUI project
Public Module MauiProgram
    Public Function CreateMauiApp() As MauiApp
        Dim builder = MauiApp.CreateBuilder()
        builder.UseMauiApp(Of App)()

        ' Registers ITesseract — MAUI DI only, no standalone equivalent
        builder.Services.AddTesseractOcr()

        Return builder.Build()
    End Function
End Module

' OCR service — ITesseract injected from MAUI container
Public Class MobileOcrService
    Private ReadOnly _tesseract As ITesseract

    Public Sub New(tesseract As ITesseract)
        _tesseract = tesseract ' Cannot be constructed outside MAUI host
    End Sub

    Public Async Function ExtractTextAsync(imagePath As String) As Task(Of String)
        Await _tesseract.InitAsync("eng") ' traineddata must be bundled
        Dim result = Await _tesseract.RecognizeTextAsync(imagePath)
        Return If(result.Success, result.RecognizedText, String.Empty)
    End Function
End Class

제품이 성장하여 업로드된 문서를 처리하거나, 스캔한 양식을 검증하거나, 서버 측에서 검색 가능한 PDF를 생성하는 등 동일한 OCR 로직이 필요한 백엔드 API를 포함하게 되면, 이 코드는 재사용할 수 없습니다. 이 파일들은 MAUI 프로젝트 외부에서는 컴파일되지 않습니다. 다른 라이브러리를 사용하여 처음부터 다시 작성해야 합니다.

상세 기능 비교

테서랙트OcrMAUI 접근법

TesseractOcrMaui는 MAUI 호스트 외부에서는 컴파일할 수 없습니다. ITesseract 인터페이스는 MAUI DI 컨테이너에서 해결됩니다; 팩토리도 없고, 고정된 진입점도 없고, 독립 실행형 생성자도 없습니다. 다음 패턴만 지원됩니다.

// MAUI-only: will not compile in ASP.NET Core, console, or class library
public class DocumentScanService
{
    private readonly ITesseract _tesseract;

    public DocumentScanService(ITesseract tesseract) // MAUI DI injection only
    {
        _tesseract = tesseract;
    }

    public async Task<string> ProcessAsync(string imagePath)
    {
        await _tesseract.InitAsync("eng");
        var result = await _tesseract.RecognizeTextAsync(imagePath);
        return result.RecognizedText ?? string.Empty;
    }
}

// MAUI-only: will not compile in ASP.NET Core, console, or class library
public class DocumentScanService
{
    private readonly ITesseract _tesseract;

    public DocumentScanService(ITesseract tesseract) // MAUI DI injection only
    {
        _tesseract = tesseract;
    }

    public async Task<string> ProcessAsync(string imagePath)
    {
        await _tesseract.InitAsync("eng");
        var result = await _tesseract.RecognizeTextAsync(imagePath);
        return result.RecognizedText ?? string.Empty;
    }
}

Imports System.Threading.Tasks

' MAUI-only: will not compile in ASP.NET Core, console, or class library
Public Class DocumentScanService
    Private ReadOnly _tesseract As ITesseract

    Public Sub New(tesseract As ITesseract) ' MAUI DI injection only
        _tesseract = tesseract
    End Sub

    Public Async Function ProcessAsync(imagePath As String) As Task(Of String)
        Await _tesseract.InitAsync("eng")
        Dim result = Await _tesseract.RecognizeTextAsync(imagePath)
        Return If(result.RecognizedText, String.Empty)
    End Function
End Class

ASP.NET Core API 컨트롤러에서 업로드된 문서를 OCR 처리해야 하는 팀은 이 클래스를 호출할 수 없습니다. 그들은 두 번째 OCR 라이브러리(일반적으로 다른 Tesseract 래퍼 또는 클라우드 API)를 추가하고 언어 구성, 오류 처리 및 정확도 조정 작업을 중복 수행합니다. 두 개의 라이브러리, 두 개의 유지보수 트랙, 두 세트의 버그 수정.

IronOCR 접근법

IronOCR 프로젝트 유형에 제한을 두지 않습니다. 동일한 클래스가 수정 없이 MAUI 앱, ASP.NET Core컨트롤러, Azure Function 및 .NET Standard 클래스 라이브러리에서 컴파일됩니다.

// Works in every project type — MAUI, ASP.NET Core, console, Azure Functions, Docker
public class SharedOcrService
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public string ExtractText(string imagePath)
    {
        using var input = new OcrInput(imagePath);
        return _ocr.Read(input).Text;
    }

    public string ExtractTextFromBytes(byte[] imageData)
    {
        using var input = new OcrInput(imageData);
        return _ocr.Read(input).Text;
    }
}

// Works in every project type — MAUI, ASP.NET Core, console, Azure Functions, Docker
public class SharedOcrService
{
    private readonly IronTesseract _ocr = new IronTesseract();

    public string ExtractText(string imagePath)
    {
        using var input = new OcrInput(imagePath);
        return _ocr.Read(input).Text;
    }

    public string ExtractTextFromBytes(byte[] imageData)
    {
        using var input = new OcrInput(imageData);
        return _ocr.Read(input).Text;
    }
}

Imports IronTesseract

Public Class SharedOcrService
    Private ReadOnly _ocr As New IronTesseract()

    Public Function ExtractText(imagePath As String) As String
        Using input As New OcrInput(imagePath)
            Return _ocr.Read(input).Text
        End Using
    End Function

    Public Function ExtractTextFromBytes(imageData As Byte()) As String
        Using input As New OcrInput(imageData)
            Return _ocr.Read(input).Text
        End Using
    End Function
End Class

이 클래스를 .NET Standard 2.1 또는 net8.0 클래스 라이브러리에 배치하고 MAUI 프로젝트, API 프로젝트, 백그라운드 워커에서 동시에 참조합니다. 하나의 구현, 하나의 유지 관리 인터페이스, 하나의 테스트 세트. IronTesseract 설정 가이드에서는 모든 대상에 동일하게 적용되는 구성 옵션을 단계별로 안내합니다.

모바일 특화 시나리오에서는 IronOcr.Android 및 IronOcr.iOS이 플랫폼 최적화된 네이티브 바이너리를 제공하면서 동일한 IronTesseract API를 노출합니다 — 따라서 공유 클래스 라이브러리가 모바일에서 변함없이 작동합니다. 서버 배포의 경우, Docker 배포 가이드와 Linux 배포 가이드가 컨테이너 구성에 대해 다룹니다. 모바일 기기에 맞춘 설정 방법을 보여주는 MAUI OCR 전용 튜토리얼 도 있습니다.

테서랙트OcrMAUI 접근법

TesseractOcrMaui에는 서버 측 접근 방식이 없습니다. 이 라이브러리는 net8.0-ios, net8.0-android, 및 net8.0-windows (MAUI)만을 대상으로 합니다. TesseractOcrMaui를 참조하는 ASP.NET Core프로젝트는 빌드에 실패합니다. 이는 설정 문제가 아닙니다. 해당 패키지에는 서버 런타임이 로드할 수 있는 대상이 포함되어 있지 않습니다.

라이브러리 자체 문서의 ProcessPdfAsync 메서드는 명시적으로 그 차이를 확인합니다:

// TesseractOcrMaui: PDF processing throws NotSupportedException
public async Task<List<string>> ProcessPdfAsync(string pdfPath)
{
    // Cannot process PDFs at all — requires manual conversion to images first
    // AND requires a separate PDF library you must add yourself
    throw new NotSupportedException(
        "TesseractOcrMaui does not support PDF processing. " +
        "You must manually convert PDF pages to images first.");
}

// TesseractOcrMaui: PDF processing throws NotSupportedException
public async Task<List<string>> ProcessPdfAsync(string pdfPath)
{
    // Cannot process PDFs at all — requires manual conversion to images first
    // AND requires a separate PDF library you must add yourself
    throw new NotSupportedException(
        "TesseractOcrMaui does not support PDF processing. " +
        "You must manually convert PDF pages to images first.");
}

Imports System
Imports System.Threading.Tasks

Public Class TesseractOcrMaui
    Public Async Function ProcessPdfAsync(pdfPath As String) As Task(Of List(Of String))
        ' Cannot process PDFs at all — requires manual conversion to images first
        ' AND requires a separate PDF library you must add yourself
        Throw New NotSupportedException("TesseractOcrMaui does not support PDF processing. " &
                                        "You must manually convert PDF pages to images first.")
    End Function
End Class

MAUI 앱 내에서도 PDF 문서를 직접 전달할 수는 없습니다. 모든 페이지는 두 번째 라이브러리에 의해 임시 이미지 파일로 렌더링된 다음, 디바이스 캐시에 저장되고, RecognizeTextAsync로 전달되며, 이후 정리됩니다. 수백 개의 문서를 처리하는 서버 워크로드에서는 그 아키텍처가 지속 가능하지 않습니다.

IronOCR 접근법

IronOCR 모바일에서 사용하는 것과 동일한 API로 서버 측 OCR을 처리합니다. PDF 입력은 네이티브 방식으로 이루어지며, 중간 이미지 변환이나 임시 파일, 별도의 라이브러리가 필요하지 않습니다.

// ASP.NET Corecontroller — handles PDF uploads directly
[HttpPost("ocr")]
public async Task<IActionResult> ProcessUpload(IFormFile file)
{
    var ocr = new IronTesseract();

    using var input = new OcrInput();

    if (file.ContentType == "application/pdf")
    {
        using var stream = file.OpenReadStream();
        input.LoadPdf(stream); // direct PDF stream — no temp files
    }
    else
    {
        using var stream = file.OpenReadStream();
        input.LoadImage(stream);
    }

    input.Deskew();   // handle scanned document skew
    input.DeNoise();  // mobile camera noise
    var result = ocr.Read(input);
    return Ok(new { text = result.Text, confidence = result.Confidence });
}

// ASP.NET Corecontroller — handles PDF uploads directly
[HttpPost("ocr")]
public async Task<IActionResult> ProcessUpload(IFormFile file)
{
    var ocr = new IronTesseract();

    using var input = new OcrInput();

    if (file.ContentType == "application/pdf")
    {
        using var stream = file.OpenReadStream();
        input.LoadPdf(stream); // direct PDF stream — no temp files
    }
    else
    {
        using var stream = file.OpenReadStream();
        input.LoadImage(stream);
    }

    input.Deskew();   // handle scanned document skew
    input.DeNoise();  // mobile camera noise
    var result = ocr.Read(input);
    return Ok(new { text = result.Text, confidence = result.Confidence });
}

Imports Microsoft.AspNetCore.Mvc
Imports IronOcr

<HttpPost("ocr")>
Public Async Function ProcessUpload(file As IFormFile) As Task(Of IActionResult)
    Dim ocr As New IronTesseract()

    Using input As New OcrInput()
        If file.ContentType = "application/pdf" Then
            Using stream = file.OpenReadStream()
                input.LoadPdf(stream) ' direct PDF stream — no temp files
            End Using
        Else
            Using stream = file.OpenReadStream()
                input.LoadImage(stream)
            End Using
        End If

        input.Deskew() ' handle scanned document skew
        input.DeNoise() ' mobile camera noise
        Dim result = ocr.Read(input)
        Return Ok(New With {Key .text = result.Text, Key .confidence = result.Confidence})
    End Using
End Function

MAUI 앱을 구동하는 동일한 IronTesseract 인스턴스가 이 엔드포인트도 구동합니다. 한 번 설치된 언어 팩은 두 대상을 모두 지원합니다.Azure Functions또는 AWS 람다 배포의 경우, Azure 배포 가이드 와 AWS 배포 가이드에 구성 방법이 설명되어 있습니다. PDF 입력 방법 안내서는 페이지 범위, 암호로 보호된 파일, 스트림 입력 등 모든 PDF 로드 패턴을 다룹니다.

테서랙트OcrMAUI 접근법

TesseractOcrMaui의 유지 관리의 모든 측면은 Henri Vainio가 계속해서 시간을 내어 적극적으로 참여해 주는 것에 달려 있습니다. 이 프로젝트에는 상업적 주체가 없으며, 서비스 수준 계약(SLA)도 없고, 보안 패치 일정도 보장되지 않으며, GitHub 이슈를 제기하는 것 외에는 문제 해결을 위한 별도의 절차가 없습니다. 프로젝트는 진행 중이지만 구조적 위험은 실제로 존재합니다.

훈련된 데이터 관리 모델은 이러한 위험을 운영상 증폭시킵니다. 개발자는 언어 파일을 다운로드하고, <MauiAsset> 요소로 선언하며, iOS와 Android 간의 플랫폼별 경로 차이를 런타임에 해결하고, 시작 시 해당 파일이 존재하는지 확인해야 합니다:

// Required startup validation — common crash source
public async Task<bool> ValidateTraineddataAsync()
{
    try
    {
        // Fails if eng.traineddata is missing, path-resolved incorrectly,
        // or mismatched with the Tesseract engine version
        await _tesseract.InitAsync("eng");
        return true;
    }
    catch (FileNotFoundException)
    {
        // Need to diagnose: missing file, wrong path, or wrong bundling config?
        Console.WriteLine("ERROR: eng.traineddata not found in bundle");
        return false;
    }
    catch (DllNotFoundException)
    {
        // Native library resolution failure — platform-specific debugging
        Console.WriteLine("Native Tesseract library missing");
        return false;
    }
}

// Required startup validation — common crash source
public async Task<bool> ValidateTraineddataAsync()
{
    try
    {
        // Fails if eng.traineddata is missing, path-resolved incorrectly,
        // or mismatched with the Tesseract engine version
        await _tesseract.InitAsync("eng");
        return true;
    }
    catch (FileNotFoundException)
    {
        // Need to diagnose: missing file, wrong path, or wrong bundling config?
        Console.WriteLine("ERROR: eng.traineddata not found in bundle");
        return false;
    }
    catch (DllNotFoundException)
    {
        // Native library resolution failure — platform-specific debugging
        Console.WriteLine("Native Tesseract library missing");
        return false;
    }
}

Imports System
Imports System.IO
Imports System.Threading.Tasks

Public Class Validator
    ' Required startup validation — common crash source
    Public Async Function ValidateTraineddataAsync() As Task(Of Boolean)
        Try
            ' Fails if eng.traineddata is missing, path-resolved incorrectly,
            ' or mismatched with the Tesseract engine version
            Await _tesseract.InitAsync("eng")
            Return True
        Catch ex As FileNotFoundException
            ' Need to diagnose: missing file, wrong path, or wrong bundling config?
            Console.WriteLine("ERROR: eng.traineddata not found in bundle")
            Return False
        Catch ex As DllNotFoundException
            ' Native library resolution failure — platform-specific debugging
            Console.WriteLine("Native Tesseract library missing")
            Return False
        End Try
    End Function

    Private _tesseract As Tesseract ' Assuming Tesseract is a defined class elsewhere
End Class

프로덕션 환경에서 특정 Android API 레벨에서, iOS 업데이트 후 또는 앱 스토어 제출 후 이러한 문제가 발생하면 디버깅 경로는 단일 개발자 프로젝트의 GitHub 이슈를 통해 진행됩니다. 지원 이메일, 채팅 채널, 전화 문의를 통한 문제 해결 절차는 없습니다.

IronOCR 접근법

IronOCR 전담 엔지니어링 팀과 상업적 지원 계약을 보유한 Iron Software 에서 개발 및 유지 관리합니다. 언어 데이터는 NuGet 패키지에 포함되어 제공되며 — dotnet add package IronOcr.Languages.French가 전체 설치 과정입니다. 관리해야 할 파일도 없고, 구성해야 할 경로도 없으며, 유지 관리해야 할 번들링 선언도 없습니다.

그에 따라 오차면이 축소됩니다. 학습 데이터 손실 문제가 없어지면서 런타임 오류의 한 유형이 완전히 사라집니다.IronOCR초기화 모델은 시작 시 단일 라이선스 키를 사용합니다.

// Application startup — the entire configuration
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

// Then OCR works anywhere, any project type, any file format
var text = new IronTesseract().Read("document.jpg").Text;

// Application startup — the entire configuration
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

// Then OCR works anywhere, any project type, any file format
var text = new IronTesseract().Read("document.jpg").Text;

Imports IronOcr

' Application startup — the entire configuration
IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY"

' Then OCR works anywhere, any project type, any file format
Dim text As String = New IronTesseract().Read("document.jpg").Text

Enterprise 고객의 경우 이메일(업무 시간), 실시간 채팅 및 전화로 지원 문제를 처리합니다. 라이선스 페이지에는 모든 등급이 포함되어 있습니다. 문서 허브에는 100페이지가 넘는 가이드가 포함되어 있습니다. 특정 기능에 대한 질문이 있는 경우, 튜토리얼 허브에서 일반적인 시나리오에 대한 예제를 제공합니다.

백엔드 확장 문제

모바일 우선 개발팀이 TesseractOcrMaui를 사용하여 MAUI 문서 스캔 앱을 출시했습니다. 이 기능은 정상적으로 작동합니다. 그런 다음 제품 로드맵에 서버 측 문서 처리 기능이 추가됩니다. 업로드된 PDF 파일은 색인 생성 전에 OCR 처리가 필요하고, 웹 포털에도 동일한 추출 로직이 필요하며, 야간 배치 작업으로 수백 개의 스캔된 양식을 처리해야 합니다. TesseractOcrMaui는 이러한 컨텍스트에서 참조할 수 없습니다. 이제 팀은 두 개의 병렬 OCR 코드베이스(하나는 MAUI, 하나는 서버)를 유지할지, 아니면 두 시스템 모두에서 작동하는 라이브러리로 모든 것을 마이그레이션할지 선택해야 합니다. 이주 비용은 한 번만 지불하면 됩니다. 두 가지 구현 방식을 유지하는 비용은 무한히 증가합니다.

모바일에서 PDF 요구 사항

실제 모바일 문서 워크플로에는 PDF가 포함됩니다. 사용자는 계약서를 사진으로 찍거나, PDF 형식으로 도착한 영수증을 스캔하거나, 신분증을 PDF 형태로 받습니다. TesseractOcrMaui는 PDF 입력시 NotSupportedException를 던집니다 — 소스 코드는 이를 명시합니다. PDF 페이지를 이미지로 렌더링하는 두 번째 라이브러리를 추가하고, 기기 캐시의 임시 파일을 관리하고, 정리 작업을 올바르게 처리하는 것은 모바일 앱에 상당한 복잡성과 불안정성을 초래합니다. 초기 MAUI 버전을 출시한 후 이러한 제약을 발견한 팀은 사용자가 실제로 전송하는 문서 유형을 처리하기 위해 상당한 재작업에 직면하게 됩니다.

실제 모바일 촬영에서의 정확도

TesseractOcrMaui는 카메라에서 들어오는 모든 이미지에 대해 Tesseract의 정확도를 있는 그대로 제공합니다. 모바일 카메라로 찍은 사진은 손 각도로 인한 미세한 회전, 저조도 환경에서의 센서 노이즈, 기기 모델별 해상도 차이 등 여러 가지 이유로 이상적인 경우가 드뭅니다. TesseractOcrMaui는 전처리 기능을 제공하지 않으므로, 기울기 보정, 노이즈 제거 및 대비 향상을 수동으로 추가하려면 SkiaSharp 또는 ImageSharp를 불러와 알고리즘을 구현하고 임시 파일을 저장하고 파이프라인을 관리해야 합니다. 대부분의 팀은 이 단계를 건너뜁니다. 그 결과, 조명이 좋지 않은 환경에서는 정확도가 40~60%에 불과하지만, 전처리 과정을 거치면 85~92%의 정확도를 보입니다. 계약서, 영수증 또는 신분증과 관련된 사용 사례의 경우, 그러한 격차는 용납할 수 없습니다.

단일 개발자의 대역폭을 넘어 확장하기

실제 운영 환경에서는 당일 대응이 필요한 버그가 종종 발생합니다. 플랫폼 업데이트로 인해 안드로이드에서 네이티브 라이브러리 해상도 기능이 작동하지 않습니다. 번들링 변경으로 인해 iOS 앱 스토어 제출이 실패했습니다. TesseractOcrMaui의 33,900회 다운로드 커뮤니티는 Stack Overflow에서 제한적인 정보만 제공하며, GitHub 단 한 명의 관리자가 관리하는 이슈 큐만 있습니다. 특히 규제 산업 분야에서 생산 SLA 의무를 가진 팀은 명확하게 정의된 문제 해결 경로가 필요합니다. 자원봉사 기반 지원은 그러한 지원을 제공하지 않습니다.

다양한 포트폴리오 전반에 걸친 코드 공유

Enterprise 개발팀이 하나의 애플리케이션만 유지 관리하는 경우는 드뭅니다. MAUI 모바일 앱, ASP.NET Core웹 포털, 콘솔 배치 프로세서 및 Azure Function 파이프라인으로 구성된 제품군 Suite 모바일 앱으로 TesseractOcrMaui를 선택하는 경우 OCR 로직을 공유할 수 없습니다. 각 프로젝트는 자체적인 OCR 통합 기능을 갖게 됩니다. 정확도 요구 사항이 변경될 경우(예: 새 언어 추가, 새 문서 유형에 대한 전처리 조정) 각 통합 작업에서 개별적으로 변경해야 합니다. IronOCR의 범 for .NET 타기팅은 모든 프로젝트가 동시에 참조하는 netstandard 라이브러리에서 단일 SharedOcrService 클래스를 가능하게 합니다.

ITesseract를 IronTesseract로 교체

TesseractOcrMaui의 ITesseract는 MAUI DI 컨테이너를 통해 해결되며 주입되어야 합니다. IronOCR의 IronTesseract는 일반적으로 인스턴스화할 수 있는 클래스입니다. 생성자 매개변수를 제거하고 InitAsync 호출을 제거하십시오; RecognizeTextAsync을 Read로 교체하십시오:

// Before — MAUI DI required
public class OcrService
{
    private readonly ITesseract _tesseract;
    public OcrService(ITesseract tesseract) { _tesseract = tesseract; }

    public async Task<string> ProcessAsync(string imagePath)
    {
        await _tesseract.InitAsync("eng");
        var result = await _tesseract.RecognizeTextAsync(imagePath);
        return result.Success ? result.RecognizedText : string.Empty;
    }
}

// After — works in any project type
public class OcrService
{
    public string Process(string imagePath)
    {
        var ocr = new IronTesseract();
        using var input = new OcrInput(imagePath);
        return ocr.Read(input).Text;
    }
}

// Before — MAUI DI required
public class OcrService
{
    private readonly ITesseract _tesseract;
    public OcrService(ITesseract tesseract) { _tesseract = tesseract; }

    public async Task<string> ProcessAsync(string imagePath)
    {
        await _tesseract.InitAsync("eng");
        var result = await _tesseract.RecognizeTextAsync(imagePath);
        return result.Success ? result.RecognizedText : string.Empty;
    }
}

// After — works in any project type
public class OcrService
{
    public string Process(string imagePath)
    {
        var ocr = new IronTesseract();
        using var input = new OcrInput(imagePath);
        return ocr.Read(input).Text;
    }
}

Imports System.Threading.Tasks

' Before — MAUI DI required
Public Class OcrService
    Private ReadOnly _tesseract As ITesseract

    Public Sub New(tesseract As ITesseract)
        _tesseract = tesseract
    End Sub

    Public Async Function ProcessAsync(imagePath As String) As Task(Of String)
        Await _tesseract.InitAsync("eng")
        Dim result = Await _tesseract.RecognizeTextAsync(imagePath)
        Return If(result.Success, result.RecognizedText, String.Empty)
    End Function
End Class

' After — works in any project type
Public Class OcrService
    Public Function Process(imagePath As String) As String
        Dim ocr = New IronTesseract()
        Using input = New OcrInput(imagePath)
            Return ocr.Read(input).Text
        End Using
    End Function
End Class

TesseractOcrMaui의 비동기 패턴은 필요에 따라 Task.Run(() => ocr.Read(input))을 사용하여 UI 스레드 문제에 대한 솔루션으로 보존할 수 있지만, 동기식 경로는 서버 시나리오에 깨끗하고 충분합니다. 이미지 입력 사용법은 모든 OcrInput 로딩 변형을 문서화합니다.

학습 데이터 인프라 제거

TesseractOcrMaui는 Resources/Raw/tessdata/ 폴더, 다운로드된 .traineddata 파일, <MauiAsset> 프로젝트 파일 선언, 플랫폼별 경로 해결 코드, 시작 시 점검을 필요로 합니다.IronOCR로 마이그레이션할 때 이 모든 것이 삭제됩니다. NuGet 통해 언어 팩을 설치합니다.

dotnet remove package TesseractOcrMaui

dotnet add package IronOcr
dotnet add package IronOcr.Android   # for MAUI Android target
dotnet add package IronOcr.iOS       # for MAUI iOS target
dotnet add package IronOcr.Languages.French  # if French was needed

dotnet remove package TesseractOcrMaui

dotnet add package IronOcr
dotnet add package IronOcr.Android   # for MAUI Android target
dotnet add package IronOcr.iOS       # for MAUI iOS target
dotnet add package IronOcr.Languages.French  # if French was needed

Resources/Raw/tessdata/ 폴더를 삭제하고 프로젝트 파일에서 <MauiAsset> 항목을 제거하십시오. builder.Services.AddTesseractOcr()를 MauiProgram.cs에서 제거하십시오. 학습 데이터 파일이 누락되었는지 확인하는 시작 유효성 검사 클래스는IronOCR에 상응하는 클래스가 없습니다. 왜냐하면 누락될 파일이 없기 때문입니다. IronTesseract 설정 가이드에서 해당 초기화 단계를 다룹니다.

정확도 동등성을 위한 전처리 추가

TesseractOcrMaui는 사전 처리를 적용하지 않습니다. 기존 앱이 테서랙트의 정확도에 맞춰 조정되었다면,IronOCR전처리 기능을 추가하면 저품질 이미지에서도 결과가 향상될 것입니다. 특히 모바일 카메라 입력의 경우, 3단계 필터 파이프라인이 가장 일반적인 오류 모드를 처리합니다.

using var input = new OcrInput(imagePath);
input.Deskew();            // camera angle correction
input.DeNoise();           // sensor noise from low light
input.EnhanceResolution(300); // normalize DPI across device models

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

using var input = new OcrInput(imagePath);
input.Deskew();            // camera angle correction
input.DeNoise();           // sensor noise from low light
input.EnhanceResolution(300); // normalize DPI across device models

var result = new IronTesseract().Read(input);
Console.WriteLine($"Confidence: {result.Confidence}%");

Imports IronOcr

Using input As New OcrInput(imagePath)
    input.Deskew()            ' camera angle correction
    input.DeNoise()           ' sensor noise from low light
    input.EnhanceResolution(300) ' normalize DPI across device models

    Dim result = New IronTesseract().Read(input)
    Console.WriteLine($"Confidence: {result.Confidence}%")
End Using

이미지 품질 보정 방법 과 이미지 방향 보정 방법은 각 필터에 대해 자세히 설명합니다. 저품질 스캔 예시는 까다로운 실제 문서를 처리하는 전체 파이프라인을 보여줍니다.

OCR 로직을 공유 라이브러리로 이전

MAUI 특화 ITesseract 의존성이 제거되면 OCR 서비스 클래스는 휴대 가능합니다. 새 netstandard2.1 또는 net8.0 클래스 라이브러리를 생성하고, 서비스를 거기에 이동하고, MAUI 프로젝트 및 솔루션 내 모든 서버 사이드 프로젝트에서 참조합니다. 이는 TesseractOcrMaui가 구조적으로 불가능하게 만드는 반면IronOCR은 아주 간단하게 만드는 건축적 단계입니다. .NET OCR 라이브러리 개요에서는 대상 지정 시 고려 사항을 다룹니다.