IronOCR ve Azure OCR PDF: Hangi Çözüm Daha İyi Metin Çıkarır?

Kodda MAUI Bağımlılığı

AddTesseractOcr() çağırdığınız anda, OCR mantığı MAUI uygulaması ana bilgisayarına bağlanır. Bunu paylaşılan bir kütüphaneye çıkarmanın bir yolu yoktur.

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

Ürününüz büyüyüp aynı OCR mantığına sahip bir arka uç API'yi içerse — yüklenen belgeleri işlemek, taranmış formları doğrulamak ya da sunucu tarafında aranabilir PDF'ler oluşturmak için — bu kod yeniden kullanılabilir değildir. MAUI projeleri dışında hiçbiri derlenemez. Farklı bir kütüphane kullanarak baştan tekrar yazılır.

Ayrıntılı Özellik Karşılaştırması

TesseractOcrMaui Yaklaşımı

TesseractOcrMaui bir MAUI ana bilgisayarı dışında derlenemez. ITesseract arayüzü, MAUI DI konteynerinden çözülür; bir fabrika yoktur, statik giriş noktası yoktur ve bağımsız bir kurucu yoktur. Aşağıdaki model tek desteklenen modeldir:

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

BirASP.NET CoreAPI denetleyicisinde yüklenen belgeleri OCR yapması gereken bir takım bu sınıfı çağıramaz. Farklı bir Tesseract sarmalayıcısı veya bir bulut API'sı olan ikinci bir OCR kütüphanesi ekler ve dil yapılandırmalarını, hata yönetimlerini ve hassasiyet ayarlamaları çalışmalarını kopyalarlar. İki kütüphane, iki bakım hattı, düzeltilecek iki hata seti.

IronOCR Yaklaşımı

IronOCR, proje türü üzerinde sınırlama getirmez. Aynı sınıf, bir MAUI uygulaması, birASP.NET Corekontrolcüsü, bir Azure İşlevi ve bir .NET Standard sınıf kütüphanesi içinde değiştirilmeden derlenir:

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

Bu sınıfı bir .NET Standard 2.1 veya net8.0 sınıf kütüphanesine yerleştirin ve aynı anda MAUI projesinden, API projesinden ve arka plan çalışanından referans alın. Tek bir uygulama, tek bir bakım yüzeyi, tek bir test seti. IronTesseract kurulum kılavuzu tüm hedefler için aynı şekilde geçerli yapılandırma seçeneklerini anlatır.

Mobil özel senaryolar için, IronOcr.Android ve IronOcr.iOS platform için optimize edilmiş yerel ikili dosyalar sağlar ve aynı IronTesseract API'sini açığa çıkarır — dolayısıyla paylaşılan sınıf kitaplığı mobilde değişmeden çalışır. Sunucu dağıtımları için, Docker dağıtım kılavuzu ve Linux dağıtım kılavuzu konteyner yapılandırmasını kapsar. Mobil için özel kurulumun nasıl yapılacağını gösteren özel bir MAUI OCR öğreticis de vardır.

TesseractOcrMaui Yaklaşımı

TesseractOcrMaui ile sunucu-taraflı bir yaklaşım yoktur. Kütüphane sadece net8.0-ios, net8.0-android ve net8.0-windows (MAUI) hedef alır. TesseractOcrMaui referans alan birASP.NET Coreprojesi derlenemez. Bu bir yapılandırma sorunu değildir; paket sadece sunucu çalıştırma zamanlarının yükleyebileceği hedeflere sahip değildir.

Kütüphanenin kendi belgelerindeki ProcessPdfAsync yöntemi bu boşluğu açıkça doğrular:

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

Hatta bir MAUI uygulaması içinde bile PDF belgeleri doğrudan geçirilemez. Her sayfa, ikinci bir kütüphane tarafından geçici bir görüntü dosyasına dönüştürülmeli, cihaz önbelleğine kaydedilmeli, RecognizeTextAsync'a teslim edilmeli, ardından temizlenmelidir. Yüzlerce belgenin işlendiği sunucu iş yüklerinde bu mimari uygun değildir.

IronOCR Yaklaşımı

IronOCR, sunucu-taraflı OCR'yi mobilde kullanılan aynı API ile ele alır. PDF girişi yereldir — ara resim dönüşümü, geçici dosyalar veya ikinci bir kütüphane yoktur:

//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 uygulamasına güç veren aynı IronTesseract örneği bu uç noktaya güç veriyor. Bir defa kurulan dil paketleri her iki hedefi kapsar. Azure İşlevleri veyaAWS Lambdadağıtımları için Azure dağıtım kılavuzu ve AWS dağıtım kılavuzu yapılandırmayı belgeler. PDF girişi nasıl yapılır kılavuzu, sayfa aralıkları, parola korumalı dosyalar ve akış girişleri dahil tüm PDF yükleme modellerini kapsar.

TesseractOcrMaui Yaklaşımı

TesseractOcrMaui'nin bakımının her yönü, Henri Vainio'nun mevcut ve motive kalmasına bağlıdır. Projenin arkasında ticari bir kuruluş yoktur, SLA yoktur, güvenlik yamaları için garanti edilmiş bir zaman çizelgesi yoktur ve bir GitHub sorunu açmaktan öte bir tırmanma yolu yoktur. Proje aktif olmuştur, ancak yapısal risk gerçektir.

Eğitilmiş veri yönetim modeli, bu riski operasyonel olarak artırır. Geliştiriciler dil dosyalarını indirmeli, onları <MauiAsset> öğeleri olarak tanımlamalı, iOS ve Android arasındaki platforma özgü yol farklarını çalışma zamanında çözmeli ve dosyaların başlangıçta mevcut olduğunu doğrulamalıdır:

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

Bu, üretimde çalışmadığında — belirli bir Android API seviyesinde, bir iOS güncellemesinden sonra veya bir uygulama mağazası başvurusu sonrası — hata ayıklama yolunu tek bir geliştirici projesi için GitHub sorunları üzerinden yürütülür. Destek e-postası, sohbet kanalı ve telefon üzerinden tırmanma yoktur.

IronOCR Yaklaşımı

IronOCR, Iron Software tarafından geliştirilen ve bakım yapılan, adanmış bir mühendislik ekibi olan ve ticari destek sözleşmeleri olan bir şirket tarafından geliştirilip bakım yapılmaktadır. Dil verileri NuGet paketleri içinde gönderilir — dotnet add package IronOcr.Languages.French tüm kurulum sürecidir. Yönetilecek dosya yoktur, yapılandırılacak yollar yoktur ve sürdürülmesi gereken paketleme beyanları yoktur.

Hata yüzeyi buna göre küçülür. Hiçbir eğitilmiş veri kaybolmaz, çalışma zamanı hatalarının tüm bir kategorisi ortadan kalkar.IronOCR başlatım modeli başlangıçta tek bir lisans anahtarıdır:

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

Destek sorunları, işletme saatlerinde e-posta ile, canlı sohbet ile ve kurumsal katmanlar için telefonla ele alınır. Lisanslama sayfası tüm katmanları kapsar; belgeleme merkezi 100'den fazla kılavuz sayfası içerir. Özellik tabanlı sorular için öğreticiler merkezi, yaygın senaryolar üzerinden çalışılan örnekler sunar.

Arka Uç Genişleme Sorunu

Mobil öncelikli bir ekip,TesseractOcrMauikullanarak MAUI belge tarama uygulaması sunar. Özellik çalışır. Ardından ürün yol haritası sunucu-tarafı belge işleme ekler: yüklenmiş PDF'ler dizinlemeden önce OCR gerektirir, bir web portalı aynı çıkarım mantığına ihtiyaç duyar, bir gece toplu işi yüzlerce taranmış formu işlemelidir.TesseractOcrMauibu bağlamların hiçbirinden referans alınamaz. Ekip şimdi iki paralel OCR kod tabanını sürdürme — biri MAUI, biri sunucu — ya da her şeyi her iki yerde de çalışan bir kütüphaneye taşımak arasında bir seçimle karşı karşıya. Taşımanın maliyeti bir defaya mahsus ödenir; iki uygulamanın bakım maliyeti süresiz olarak bileşikleşir.

Mobilde PDF Gereksinimleri

Gerçek dünya mobil belge iş akışları PDF'leri içerir. Kullanıcılar sözleşmeleri fotoğraflar, PDF olarak gelen makbuzları tarar veya kimlik belgelerini PDF biçiminde alır. TesseractOcrMaui, her PDF girdiğinde NotSupportedException verir — kaynak kod bunu açıkça belgeler. PDF sayfalarını resimlere dönüştürmek için ikinci bir kütüphane eklemek, cihaz önbelleğinde geçici dosyaları yönetmek ve temizliği doğru şekilde yapmak, mobil bir uygulamaya önemli karmaşıklık ve kırılganlık ekler. İlk MAUI sürümünü gönderildikten sonra bu kısıtlamayı keşfeden ekipler, kullanıcılarının gerçekten gönderdiği belge türlerini işlemek için önemli bir yeniden çalışma ile karşılaşır.

Gerçek Mobil Çekimlerde Doğruluk

TesseractOcrMaui fotoğraf makinesinden gelen görüntüye karşı ham Tesseract doğruluğunu sunar. Mobil kamera görüntüleri nadiren idealdir: el açısı nedeniyle hafif dönüş, düşük ışıkta sensör gürültüsü, cihaz modelleri arasında değişen çözünürlük.TesseractOcrMauiherhangi bir ön işleme sağlamaz — elle deskewing, denoising ve kontrast iyileştirme eklemek SkiaSharp veya ImageSharp'u çekmek, algoritmaları uygulamak, geçici dosyaları kaydetmek ve hattı yönetmek gerektirir. Çoğu ekip bunu geçiştirir. Sonuç, fakir aydınlatma koşullarında %40–60 doğruluk, ön işleme uygulandığında %85–92 olmasıdır. Kullanım durumu sözleşmeler, makbuzlar veya kimlik belgelerini içeriyorsa, bu fark kabul edilemez.

Tek Geliştiricinin Bant Genişliğinin Ötesine Ölçekleme

Üretim uygulamaları zaman zaman aynı gün yanıtlanması gereken hatalarla karşılaşır. Bir platform güncellemesi Android'de yerel kütüphane çözümünü kırar. Bir iOS uygulama mağazası başvurusu, paketleme değişikliği nedeniyle başarısız olur. TesseractOcrMaui'nin 33,900 indirmelik topluluğu sınırlı Stack Overflow kapsamı ve tek bir bakım kişinin GitHub sorunları kuyruğu sunar. Üretim SLA yükümlülüğü olan ekipler — özellikle düzenlenmiş endüstrilerde — tanımlı bir tırmanma yoluna ihtiyaç duyarlar. Gönüllü tabanlı destek bir tırmanma yolu sağlamaz.

Karışık Bir Portföyün Üzerinde Kod Paylaşımı

Kurumsal geliştirme ekipleri nadiren tek bir uygulama sürdürür. Bir MAUI mobil uygulaması, birASP.NET Coreweb portalı, bir konsol toplu işlemcisi ve bir Azure İşlevi hattı içeren bir ürün paketi,TesseractOcrMauimobil seçim olduğunda OCR mantığını paylaşamaz. Her proje kendi OCR entegrasyonunu alır. Doğruluk gereksinimleri değiştiğinde — yeni bir dil eklemek, yeni bir belge türü için ön işlemeyi ayarlamak — değişiklik her bir entegrasyon ayrı ayrı yapılmalıdır. IronOCR'un evrensel .NET hedefleme özelliği, netstandard kütüphanesinde eşzamanlı olarak tüm projeler tarafından referans alınacak tek bir SharedOcrService sınıfı sağlar.

ITesseract'ı IronTesseract ile Değiştirme

TesseractOcrMaui'nin ITesseract'ü MAUI DI konteyneri aracılığıyla çözülür ve enjekte edilmelidir. IronOCR'un IronTesseract'ı düz bir somutlaştırılabilir sınıftır. Kurucu parametresini ve InitAsync çağrısını kaldırın; RecognizeTextAsync'u Read ile değiştirin:

// 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'nin asenkron kalıbı, hesaplamalarda UI iş parçacığı endişeleri için gerekirse Task.Run(() => ocr.Read(input)) kullanılarak korunabilir, ancak eşzamanlı yol sunucu senaryoları için temiz ve yeterlidir. Görüntü girişi nasıl yapılır, tüm OcrInput yükleme varyantlarını belgeliyor.

Eğitilmiş Veri Altyapısını Kaldırma

TesseractOcrMaui, Resources/Raw/tessdata/ klasörüne, indirilmiş .traineddata dosyalarına, <MauiAsset> proje dosyası bildirimlerine, platforma özgü yol çözümleme koduna ve başlangıç doğrulama kontrolüne ihtiyaç duyar. Tüm bunlar IronOCR'ye geçirildiğinde silinir. Dil paketleri NuGet aracılığıyla kurulur:

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/ klasörünü silin ve proje dosyasından <MauiAsset> girişlerini kaldırın. builder.Services.AddTesseractOcr()'yi MauiProgram.cs'dan kaldırın. Eğitilmiş veri dosyalarının eksik olup olmadığını kontrol eden başlangıç doğrulama sınıfının IronOCR'de eşdeğeri yoktur çünkü kaybolacak hiçbir şey yoktur. IronTesseract kurulum kılavuzu eşdeğer başlatım adımını kapsar.

Doğruluk Eşitliği için Ön-İşleme Ekleme

TesseractOcrMaui hiçbir ön işleme uygulamaz. Mevcut uygulama ham Tesseract doğruluğuna göre ayarlanmışsa,IronOCR ön işleme eklemek zayıf kalitede görüntülerde sonuçları iyileştirir. Özellikle mobil kamera girişi için, üç filtreli bir boru hattı en yaygın başarısızlık modlarını kapsar:

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

görüntü kalitesi düzeltme nasıl yapılır ve görüntü yönlendirme düzeltme nasıl yapılır her filtreyi ayrıntılı olarak açıklar. Düşük kalite taramanın örneği zorlu gerçek dünya belgeleri için tam bir boru hattını gösterir.

OCR Mantığını Paylaşılan Bir Kütüphaneye Taşıma

MAUI'ye özel ITesseract bağımlılığı kaldırıldıktan sonra, OCR hizmet sınıfı taşınabilir hale gelir. Yeni bir netstandard2.1 veya net8.0 sınıf kütüphanesi oluşturun, hizmeti oraya taşıyın ve çözümdeki MAUI projesi ve her sunucu tarafı projesinden referans alın. Bu, TesseractOcrMaui'nin yapısal olarak olanaksız hale getirdiği ve IronOCR'nin kolaylaştırdığı mimari adımdır. .NET OCR kütüphanesi genel bakışı hedefleme hususlarını kapsar.