.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 platformlarla ilgili sorunları önlemek için, yalnızca iOS platformunu hedeflerken paketi içerecek şekilde csproj dosyasını değiştirin. 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. Yeni bir ItemGroup elementi böyle 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'ı, 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="MAUI IronOCRiOSSample.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="MAUI IronOCRiOSSample.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, IronTesseract'i bir sınıfta bir kez başlatmayı unutmayın. Onu doğrudan bir metotta başlatmak etkili değil ve beklenmeyen hatalara yol açabilir. Ardından bir dosya seçmek için FilePicker.PickAsync metodunu kullanın. FileResult'den, okumak için bir akış açın. Yeni bir OcrInput nesnesi oluşturun ve bu nesneyi resmi yüklemek için kullanın. 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 MAUI IronOCRiOSSample;

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 MAUI IronOCRiOSSample;

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 MAUI_IronOCRiOSSample

    Public Partial 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(sender As Object, e As EventArgs)
            Try
                Dim options As New PickOptions With {
                    .PickerTitle = "Please select a file"
                }

                Dim result = Await FilePicker.PickAsync(options)
                If result IsNot Nothing Then
                    Using stream = Await result.OpenReadAsync()
                        ' Instantiate OcrInput
                        Using ocrInput As New OcrInput()
                            ' Load image stream
                            ocrInput.LoadImage(stream)

                            ' Perform OCR
                            Dim ocrResult = ocrTesseract.Read(ocrInput)
                            OutputText.Text = ocrResult.Text
                        End Using
                    End Using
                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.](/static-assets/ocr/how-to/setup-ios/MAUI IronOCRiOSSample.zip)

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