.NET MAUI'de iOS'ta OCR Nasıl Yapılır

IronOCR iOS Paketi

IronOcr.iOS paketi .NET çapraz platform projeleri aracılığıyla iOS cihazlarda OCR özelliklerini etkinleştirir. Vanilla IronOCR paketi gerekli değildir.

Install-Package IronOcr.iOS

NuGet ile yükleyin

Install-Package IronOcr.iOS

nuget.org/packages/IronOcr.iOS/

Bir .NET MAUI Projesi Oluşturun

Çoklu platform bölümünde, .NET MAUI Uygulaması'nı seçin ve devam edin.

IronOCR.iOS Kütüphanesini Dahil Et

Kütüphane çeşitli şekillerde eklenebilir. Belki de en kolay yol NuGet kullanmaktır.

1. Visual Studio içinde, "Dependencies > NuGet" üzerine sağ tıklayın ve "NuGet Paketlerini Yönet..." seçeneğini seçin.
2. "Gözat" sekmesini seçin ve "IronOcr.iOS" aratın.
3. "IronOcr.iOS" paketini seçin ve "Paket Ekle"ye tıklayın.

Diğer platformlarda sorun yaşamamak için, csproj dosyasını değiştirerek paketi yalnızca iOS platformunu hedeflerken dahil edin. Bunu yapmak için:

1. Projenizin *.csproj dosyası üzerine sağ tıklayın ve "Proje Dosyasını Düzenle" seçeneğini seçin.

2. Şu şekilde yeni bir ItemGroup öğesi oluşturun:

   <ItemGroup Condition="$(TargetFramework.Contains('ios')) == true">
       <PackageReference Include="IronOcr.iOS" Version="YOUR_PACKAGE_VERSION" />
   </ItemGroup>

   <ItemGroup Condition="$(TargetFramework.Contains('ios')) == true">
       <PackageReference Include="IronOcr.iOS" Version="YOUR_PACKAGE_VERSION" />
   </ItemGroup>

   XML
3. "IronOcr.iOS" PackageReference öğesini az önce oluşturduğumuz ItemGroup içine taşıyın.

Yukarıdaki adımlar, "IronOcr.iOS" paketinin örneğin Android platformlarında kullanılmasını önleyecektir (bu amaçla IronOcr.Android yükleyin).

"MainPage.xaml" Düzenle

OCR sonucunu göstermek için bir düğme ve bir etiket görüntülemek üzere XAML dosyasını düzenleyin. Örneğin:

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MAUIIronOCRiOSSample.MainPage">

    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>
        <Button
            Text="Import File"
            Clicked="ReadFileOnImport"
            Grid.Row="0"
            HorizontalOptions="Center"
            Margin="20, 20, 20, 10"/>

        <ScrollView
            Grid.Row="1"
            BackgroundColor="LightGray"
            Padding="10"
            Margin="10, 10, 10, 30">
            <Label x:Name="OutputText"/>
        </ScrollView>
    </Grid>

</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MAUIIronOCRiOSSample.MainPage">

    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>
        <Button
            Text="Import File"
            Clicked="ReadFileOnImport"
            Grid.Row="0"
            HorizontalOptions="Center"
            Margin="20, 20, 20, 10"/>

        <ScrollView
            Grid.Row="1"
            BackgroundColor="LightGray"
            Padding="10"
            Margin="10, 10, 10, 30">
            <Label x:Name="OutputText"/>
        </ScrollView>
    </Grid>

</ContentPage>

"MainPage.xaml.cs" Düzenle

IronTesseract nesnesini oluşturarak başlayın. Aşağıdaki kodda gösterildiği gibi, bir sınıfta IronTesseract öğesini bir kez başlatmayı unutmayın. Onu doğrudan bir metotta başlatmak etkili değil ve beklenmeyen hatalara yol açabilir. Ardından, FilePicker.PickAsync yöntemini kullanarak bir dosya seçin. FileResult'den okuma için bir akış açın. Yeni bir OcrInput nesnesi oluşturun ve bu nesneyi kullanarak görüntüyü yükleyin. Görüntü üzerinde OCR gerçekleştirmek ve metni geri almak için Tesseract örneğini kullanın. Sonuçlanan metni nihayet bir etikete gösterin.

Mevcut uygulama sadece resim dosyaları ile sınırlıdır. Paket henüz PDF belgeleri ile çalışmıyor. Bunu dikkate alarak, PDF belgelerine ilişkin herhangi bir yapılandırmanın devre dışı bırakılması gerekir.

using System;
using IronOcr;
using Microsoft.Maui.Controls;

namespace MAUIIronOCRiOSSample;

public partial class MainPage : ContentPage
{
    // Initialize IronTesseract once in a class
    private IronTesseract ocrTesseract = new IronTesseract();

    public MainPage()
    {
        InitializeComponent();
        // Apply license key
        IronOcr.License.LicenseKey = "IRONOCR-MYLICENSE-KEY-1EF01";
    }

    private async void ReadFileOnImport(object sender, EventArgs e)
    {
        try
        {
            var options = new PickOptions
            {
                PickerTitle = "Please select a file"
            };

            var result = await FilePicker.PickAsync(options);
            if (result != null)
            {
                using var stream = await result.OpenReadAsync();

                // Instantiate OcrInput
                using var ocrInput = new OcrInput();

                // Load image stream
                ocrInput.LoadImage(stream);

                // Perform OCR
                var ocrResult = ocrTesseract.Read(ocrInput);
                OutputText.Text = ocrResult.Text;
            }
        }
        catch (Exception ex)
        {
            // Handle exceptions
            System.Diagnostics.Debug.WriteLine(ex);
        }
    }
}

using System;
using IronOcr;
using Microsoft.Maui.Controls;

namespace MAUIIronOCRiOSSample;

public partial class MainPage : ContentPage
{
    // Initialize IronTesseract once in a class
    private IronTesseract ocrTesseract = new IronTesseract();

    public MainPage()
    {
        InitializeComponent();
        // Apply license key
        IronOcr.License.LicenseKey = "IRONOCR-MYLICENSE-KEY-1EF01";
    }

    private async void ReadFileOnImport(object sender, EventArgs e)
    {
        try
        {
            var options = new PickOptions
            {
                PickerTitle = "Please select a file"
            };

            var result = await FilePicker.PickAsync(options);
            if (result != null)
            {
                using var stream = await result.OpenReadAsync();

                // Instantiate OcrInput
                using var ocrInput = new OcrInput();

                // Load image stream
                ocrInput.LoadImage(stream);

                // Perform OCR
                var ocrResult = ocrTesseract.Read(ocrInput);
                OutputText.Text = ocrResult.Text;
            }
        }
        catch (Exception ex)
        {
            // Handle exceptions
            System.Diagnostics.Debug.WriteLine(ex);
        }
    }
}

Imports System
Imports IronOcr
Imports Microsoft.Maui.Controls

Namespace MAUIIronOCRiOSSample

	Partial Public Class MainPage
		Inherits ContentPage

		' Initialize IronTesseract once in a class
		Private ocrTesseract As New IronTesseract()

		Public Sub New()
			InitializeComponent()
			' Apply license key
			IronOcr.License.LicenseKey = "IRONOCR-MYLICENSE-KEY-1EF01"
		End Sub

		Private Async Sub ReadFileOnImport(ByVal sender As Object, ByVal e As EventArgs)
			Try
				Dim options = New PickOptions With {.PickerTitle = "Please select a file"}

				Dim result = Await FilePicker.PickAsync(options)
				If result IsNot Nothing Then
					Dim stream = Await result.OpenReadAsync()

					' Instantiate OcrInput
					Dim ocrInput As New OcrInput()

					' Load image stream
					ocrInput.LoadImage(stream)

					' Perform OCR
					Dim ocrResult = ocrTesseract.Read(ocrInput)
					OutputText.Text = ocrResult.Text
				End If
			Catch ex As Exception
				' Handle exceptions
				System.Diagnostics.Debug.WriteLine(ex)
			End Try
		End Sub
	End Class
End Namespace

$vbLabelText   $csharpLabel

Son olarak, derleme hedefini iOS Simülatörüne değiştirin ve projeyi çalıştırın.

Projeyi Çalıştırın

Proje nasıl çalıştırılacağını ve OCR işlemi nasıl yapılacağını gösterecektir.

.NET MAUI Uygulama Projesi İndirin

Bu kılavuzun tüm kodunu indirebilirsiniz. Visual Studio'da .NET MAUI Uygulama projesi olarak açabileceğiniz sıkıştırılmış bir dosya olarak gelir.

Projeyi indirmek için buraya tıklayın.

Avalonia'da IronOcr.iOS Kullanımı

Avalonia'da IronOcr.iOS kurulumu, MAUI'ye benzer, ancak bir farkla: en son .NET SDK sürümüne ek olarak .NET SDK 8.0.101 de başarıyla çalıştırmak için kurulu olmalıdır. Daha sonra, yukarıda açıklanan aynı kurulumla IronOcr.iOS, bir Avalonia projesinde kullanılabilir.

Android üzerinde OCR gerçekleştirmek istiyorsanız, daha fazla bilgi edinmek için şu makaleye gidin: ".NET MAUI'da Android Üzerinde OCR Nasıl Yapılır?"