IronOCR a Azure OCR PDF: które rozwiązanie lepiej wyodrębnia tekst?

Zablokowanie MAUI w kodzie

W momencie gdy wywołujesz AddTesseractOcr(), logika OCR jest powiązana z hostem aplikacji MAUI. Nie ma możliwości wyodrębnienia jej do wspólnej biblioteki:

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

Jeśli Twój produkt rozrośnie się i będzie zawierał backendowe API, które wymaga tej samej logiki OCR — do przetwarzania przesłanych dokumentów, sprawdzania poprawności zeskanowanych formularzy lub generowania plików PDF z możliwością wyszukiwania po stronie serwera — ten kod nie będzie nadawał się do ponownego wykorzystania. Żadna z tych bibliotek nie kompiluje się poza projektem MAUI. Napisz to od nowa, używając innej biblioteki.

Szczegółowe porównanie funkcji

Podejście TesseractOcrMaui

TesseractOcrMaui nie może być kompilowana poza hostem MAUI. Interfejs ITesseract jest rozwiązywany z kontenera DI MAUI; nie ma fabryki, statycznego punktu wejścia ani samodzielnego konstruktóra. Obsługiwany jest wyłącznie następujący wzorzec:

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

Zespół, który musi przeprowadzić OCR przesłanych dokumentów w kontrolerze API ASP.NET Core, nie może wywołać tej klasy. Dodają drugą bibliotekę OCR — zazwyczaj inną nakładkę na Tesseract lub interfejs API w chmurze — i powielają konfigurację językową, obsługę błędów oraz prace związane z dostosowywaniem dokładności. Dwie biblioteki, dwa ścieżki konserwacji, dwa zestawy błędów do naprawienia.

Podejście IronOCR

IronOCR nie nakłada żadnych ograniczeń dotyczących rodzaju projektu. Ta sama klasa kompiluje się bez modyfikacji w aplikacji MAUI, kontrolerze ASP.NET Core, funkcji Azure oraz bibliotece klas .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

Umieść tę klasę w bibliotece klas .NET Standard 2.1 lub net8.0 i odnieś się do niej jednocześnie z projektu MAUI, projektu API i pracownika w tle. Jedna implementacja, jedna powierzchnia konserwacji, jeden zestaw testów. Przewodnik konfiguracji IronTesseract omawia opcje konfiguracyjne, które mają identyczne zastosowanie dla wszystkich celów.

Dla scenariuszy specyficznych dla urządzeń mobilnych, IronOcr.Android i IronOcr.iOS dostarczają zoptymalizowane natywne binaria na platformie przy jednoczesnym wystawianiu identycznego API IronTesseract — dzięki czemu wspólna biblioteka klas działa niezmieniona na urządzeniach mobilnych. Dla wdrożeń serwerowych przewodniki wdrożeniowe Docker i Linux pokrywają konfigurację kontenera. Dostępny jest również specjalny samouczek dotyczący MAUI OCR, przedstawiający konfigurację przeznaczoną dla urządzeń mobilnych.

Podejście TesseractOcrMaui

W przypadkuTesseractOcrMauinie ma podejścia po stronie serwera. Biblioteka celuje w net8.0-ios, net8.0-android, i net8.0-windows (tylko MAUI). ProjektASP.NET Coreodwołujący się do TesseractOcrMaui nie zostanie zbudowany. Nie jest to kwestia konfiguracji; pakiet po prostu nie zawiera elementów docelowych, które środowiska uruchomieniowe serwera mogą załadować.

Metoda ProcessPdfAsync w dokumentacji własnej biblioteki wyraźnie potwierdza lukę:

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

Nawet w aplikacji MAUI nie można bezpośrednio przekazywać dokumentów PDF. Każda strona musi być renderowana do tymczasowego pliku obrazu przez drugą bibliotekę, zapisywana w pamięci podręcznej urządzenia, przekazywana do RecognizeTextAsync, a następnie czyszczona. W obciążeniach serwera przetwarzających setki dokumentów taka architektura nie jest wykonalna.

Podejście IronOCR

IronOCR obsługuje OCR po stronie serwera przy użyciu tego samego API, co w przypadku urządzeń mobilnych. Wejście PDF jest natywne — bez pośredniej konwersji obrazów, bez plików tymczasowych, bez dodatkowej biblioteki:

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

To samo wystąpienie IronTesseract, które zasila aplikację MAUI, zasila ten punkt końcowy. Zainstalowane pakiety językowe obejmują oba języki docelowe. W przypadku wdrożeńAzure FunctionslubAWS Lambdakonfiguracja została opisana w przewodniku wdrożeniowym Azure oraz przewodniku wdrożeniowym AWS. Instrukcja dotycząca danych wejściowych w formacie PDF obejmuje wszystkie wzorce ładowania plików PDF, w tym zakresy stron, pliki chronione hasłem oraz dane wejściowe typu strumieniowego.

Podejście TesseractOcrMaui

Każdy aspekt utrzymaniaTesseractOcrMauizależy od dostępności i motywacji Henriego Vainio. Za projektem nie stoi żadna firma, nie ma umowy SLA, nie ma gwarantowanego harmonogramu wydawania poprawek bezpieczeństwa i nie ma możliwości eskalacji poza zgłoszeniem problemu na GitHubie. Projekt jest aktywny, ale ryzyko strukturalne jest realne.

Model zarządzania danymi szkoleniowymi potęguje to ryzyko w wymiarze operacyjnym. Deweloperzy muszą pobrać pliki językowe, zadeklarować je jako elementy <MauiAsset>, rozwiązać różnice w ścieżkach specyficznych dla platformy pomiędzy iOS a Android w czasie wykonywania, a także zweryfikować istnienie plików przy starcie:

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

Gdy coś zawiedzie w środowisku produkcyjnym — na konkretnym poziomie API Androida, po aktualizacji iOS lub po przesłaniu do sklepu z aplikacjami — ścieżka debugowania przebiega przez zgłoszenia na GitHubie w projekcie prowadzonym przez jednego programistę. Nie ma adresu e-mail pomocy technicznej, kanału czatu ani możliwości eskalacji przez telefon.

Podejście IronOCR

IronOCR jest rozwijany i utrzymywany przez Iron Software, firmę posiadającą dedykowany zespół inżynierów oraz oferującą komercyjne umowy wsparcia technicznego. Dane językowe dołączane są w pakietach NuGet — dotnet add package IronOcr.Languages.French to cały proces instalacji. Nie ma żadnych plików do zarządzania, ścieżek do konfiguracji ani deklaracji pakietów do utrzymania.

W ten sposób zmniejsza się liczba potencjalnych błędów. Dzięki temu, że nie giną żadne dane szkoleniowe, znika cała kategoria błędów środowiska uruchomieniowego. Model inicjalizacji IronOCR polega na wprowadzeniu pojedynczego klucza licencyjnego podczas uruchamiania:

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

Kwestie związane z pomocą techniczną są obsługiwane za pośrednictwem poczty elektronicznej (w godzinach pracy), czatu na żywo oraz telefonicznie w przypadku planów Enterprise. Strona licencyjna obejmuje wszystkie poziomy; Centrum dokumentacji zawiera ponad 100 stron przewodników. W przypadku pytań dotyczących konkretnych funkcji centrum samouczków zawiera praktyczne przykłady z typowych scenariuszy.

Problem rozbudowy zaplecza

Zespół skupiający się na technologiach mobilnych wprowadza na rynek aplikację do skanowania dokumentów MAUI, wykorzystując TesseractOcrMaui. Funkcja działa. Następnie plan rozwoju produktu dodaje przetwarzanie dokumentów po stronie serwera: przesłane pliki PDF wymagają OCR przed indeksowaniem, portal internetowy potrzebuje tej samej logiki ekstrakcji, a nocne zadanie wsadowe musi przetwarzać setki zeskanowanych formularzy. W żadnym z tych kontekstów nie można odwoływać się do TesseractOcrMaui. Zespół stoi obecnie przed wyborem między utrzymaniem dwóch równoległych baz kodu OCR — jednej dla MAUI, drugiej dla serwera — a migracją wszystkiego do biblioteki, która działa na obu platformach. Koszt migracji pokrywa się jednorazowo; koszt utrzymania dwóch implementacji rośnie w nieskończoność.

Wymagania dotyczące plików PDF na urządzeniach mobilnych

W rzeczywistych mobilnych procesach pracy z dokumentami wykorzystuje się pliki PDF. Użytkownicy fotografują umowy, skanują paragony, które otrzymują w formacie PDF, lub otrzymują dokumenty tożsamości w formacie PDF.TesseractOcrMauizgłasza NotSupportedException dla jakiegokolwiek wejścia PDF — kod źródłowy dokumentuje to wyraźnie. Dodanie drugiej biblioteki do renderowania stron PDF na obrazy, zarządzanie plikami tymczasowymi w pamięci podręcznej urządzenia oraz prawidłowe czyszczenie znacznie zwiększa złożoność i wrażliwość aplikacji mobilnej. Zespoły, które odkryją to ograniczenie po wydaniu początkowej wersji MAUI, staną przed koniecznością znacznej przeróbki, aby obsłużyć typy dokumentów faktycznie wysyłane przez użytkowników.

Dokładność w rzeczywistych zrzutach ekranu z urządzeń mobilnych

TesseractOcrMaui zapewnia surową dokładność Tesseracta w stosunku do każdego obrazu pochodzącego z aparatu. Zdjęcia z aparatów w telefonach rzadko są idealne: niewielkie obrócenie spowodowane kątem trzymania w dłoni, szumy czujnika przy słabym oświetleniu, różna rozdzielczość w zależności od modelu urządzenia.TesseractOcrMauinie zapewnia przetwarzania wstępnego — ręczne dodanie funkcji prostowania, usuwania szumów i poprawiania kontrastu wymaga użycia SkiaSharp lub ImageSharp, wdrożenia algorytmów, zapisywania plików tymczasowych i zarządzania potokiem. Większość zespołów pomija ten etap. Wynik to 40–60% dokładności w słabyćh warunkach oświetleniowych w porównaniu z 85–92% po zastosowaniu przetwarzania wstępnego. W przypadku zastosowań związanych z umowami, paragonami lub dokumentami tożsamości taka luka jest niedopuszczalna.

Skalowanie wykraczające poza możliwości pojedynczego programisty

W aplikacjach produkcyjnych zdarzają się błędy, które wymagają reakcji jeszcze tego samego dnia. Aktualizacja platformy powoduje zakłócenie rozpoznawania bibliotek natywnych w systemie Android. Przesłanie aplikacji do sklepu iOS nie powiodło się z powodu zmiany w pakiecie. Społeczność TesseractOcrMaui, która ma 33 900 pobrań, zapewnia ograniczoną obecność na Stack Overflow oraz kolejkę zgłoszeń na GitHubie prowadzoną przez jednego opiekuna. Zespoły zobowiązane do przestrzegania umów SLA dotyczących produkcji — szczególnie w branżach podlegających regulacjom — potrzebują jasno określonej ścieżki eskalacji. Wsparcie oparte na wolontariacie nie zapewnia takiego wsparcia.

Współdzielenie kodu w ramach zróżnicowanego portfolio

Zespoły programistów w Enterprise rzadko zajmują się utrzymaniem tylko jednej aplikacji. Suite produktów obejmująca aplikację mobilną MAUI, portal internetowy .NET Core, konsolowy procesor wsadowy oraz potok funkcji Azure nie może współdzielić logiki OCR, gdyTesseractOcrMauijest rozwiązaniem mobilnym. Każdy projekt otrzymuje własną integrację OCR. Gdy zmieniają się wymagania dotyczące dokładności — dodanie nowego języka, dostosowanie przetwarzania wstępnego dla nowego typu dokumentu — zmiana musi zostać wprowadzona osobno w każdej integracji. Uniwersalne docelowanie .NET przez IronOCR umożliwia jedną klasę SharedOcrService w bibliotece netstandard, do której odnosi się jednocześnie każdy projekt.

Zastąpienie ITesseract przez IronTesseract

ITesseractTesseractOcrMauijest rozwiązywany przez kontener DI MAUI i musi być wstrzyknięty. IronTesseractIronOCR to zwykła instancjowalna klasa. Usuń parametr konstruktora i wywołanie InitAsync; zamień RecognizeTextAsync na 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

Asynchroniczny wzorzec zTesseractOcrMauimożna zachować przy użyciu Task.Run(() => ocr.Read(input)), jeśli potrzebny jest ze względu na kwestie wątków UI w MAUI, ale ścieżka synchroniczna jest czysta i wystarczająca dla scenariuszy serwerowych. Instrukcja wprowadzania obrazów dokumentuje wszystkie warianty ładowania OcrInput.

Usunięcie infrastruktury Traineddata

TesseractOcrMaui wymaga folderu Resources/Raw/tessdata/, pobranych plików .traineddata, deklaracji pliku projektu <MauiAsset>, kodu rozwiązywania ścieżek specyficznych dla platformy i sprawdzenia walidacji przy starcie. Wszystko to jest usuwane podczas migracji do IronOCR. Pakiety językowe instaluje się za pośrednictwem 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

Usuń folder Resources/Raw/tessdata/ i usuń wpisy <MauiAsset> z pliku projektu. Usuń builder.Services.AddTesseractOcr() z MauiProgram.cs. Klasa walidacji startupowej, która sprawdza brak plików traineddata, nie ma odpowiednika w IronOCR, ponieważ nie ma tam nic, co mogłoby zniknąć. Podręcznik konfiguracji IronTesseract opisuje odpowiedni etap inicjalizacji.

Dodanie przetwarzania wstępnego w celu zapewnienia równowagi dokładności

TesseractOcrMaui nie stosuje żadnego przetwarzania wstępnego. Jeśli istniejąca aplikacja została dostosowana pod kątem surowej dokładności Tesseract, dodanie przetwarzania wstępnego IronOCR poprawi wyniki w przypadku obrazów o niskiej jakości. W przypadku danych z kamer mobilnych trzyfiltrowy proces obejmuje najczęstsze tryby awarii:

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

Poradniki dotyczące korekcji jakości obrazu i korekcji orientacji obrazu szczegółowo wyjaśniają działanie każdego filtra. Przykład skanu o niskiej jakości pokazuje pełny proces przetwarzania trudnych dokumentów z życia codziennego.

Przeniesienie logiki OCR do biblioteki współdzielonej

Gdy zależność specyficzna dla MAUI ITesseract zostanie usunięta, klasa serwisu OCR staje się przenośna. Utwórz nową bibliotekę klas netstandard2.1 lub net8.0, przenieś tam serwis i odnieś się do niej z projektu MAUI i każdego projektu serwerowego w rozwiązaniu. Jest to etap architektoniczny, któryTesseractOcrMauiuniemożliwia strukturalnie, a IronOCR sprawia, że staje się on banalny. Przegląd biblioteki OCR .NET obejmuje kwestie związane z grupą docelową.