.NET MAUI'de Android Üzerinde OCR Uygulama Yöntemleri

IronOCR Android Paketi

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

Install-Package IronOcr.Android

NuGet ile yükleyin

Install-Package IronOcr.Android

nuget.org/packages/IronOcr.Android/

.NET MAUI projesi oluştur

Visual Studio'yu açın ve "Yeni proje oluştur"a tıklayın. MAUI arayın, .NET MAUI Uygulamasını seçin ve "İleri" tıklayın.

IronOcr.Android 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" üzerine sağ tıklayın ve "NuGet Paketlerini Yönet..." seçeneğini seçin.
2. "Gözat" sekmesini seçin ve "IronOcr.Android" arayın.
3. "IronOcr.Android" paketini seçip "Yükle" üzerine tıklayın.

Diğer platformlarla sorun yaşamamak için csproj dosyanızı yalnızca Android platformunu hedefleyerek paketi dahil edecek şekilde değiştirin. Bunu yapmak için:

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

2. Yeni bir ItemGroup elementi oluşturun:

   <ItemGroup Condition="$(TargetFramework.Contains('android')) == true">
   </ItemGroup>

   <ItemGroup Condition="$(TargetFramework.Contains('android')) == true">
   </ItemGroup>

   XML
3. Yeni oluşturduğumuz ItemGroup içine "IronOcr.Android" PackageReference taşırız.

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

"MainActivity.cs" Düzenle

• Platformlar -> Android dizininden "MainActivity.cs" dosyasını açın.
• MainActivity yöntemini ekleyin ve Initialize yöntemini çağırın.

using Android.App;
using Android.Content.PM;
using Android.Runtime;
using Android.OS;
using IronOcr;

namespace MAUI IronOCRAndroidSample
{
    [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
    public class MainActivity : MauiAppCompatActivity
    {
        public MainActivity()
        {
            // Initialize IronTesseract for OCR purposes
            IronTesseract.Initialize(this);
        }
    }
}

using Android.App;
using Android.Content.PM;
using Android.Runtime;
using Android.OS;
using IronOcr;

namespace MAUI IronOCRAndroidSample
{
    [Activity(Theme = "@style/Maui.SplashTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation | ConfigChanges.UiMode | ConfigChanges.ScreenLayout | ConfigChanges.SmallestScreenSize | ConfigChanges.Density)]
    public class MainActivity : MauiAppCompatActivity
    {
        public MainActivity()
        {
            // Initialize IronTesseract for OCR purposes
            IronTesseract.Initialize(this);
        }
    }
}

Imports Android.App
Imports Android.Content.PM
Imports Android.Runtime
Imports Android.OS
Imports IronOcr

Namespace MAUI_IronOCRAndroidSample

    <Activity(Theme:="@style/Maui.SplashTheme", MainLauncher:=True, ConfigurationChanges:=ConfigChanges.ScreenSize Or ConfigChanges.Orientation Or ConfigChanges.UiMode Or ConfigChanges.ScreenLayout Or ConfigChanges.SmallestScreenSize Or ConfigChanges.Density)>
    Public Class MainActivity
        Inherits MauiAppCompatActivity

        Public Sub New()
            ' Initialize IronTesseract for OCR purposes
            IronTesseract.Initialize(Me)
        End Sub
    End Class

End Namespace

"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 IronOCRAndroidSample.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 IronOCRAndroidSample.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

İlk olarak, IronTesseract nesnesinin bir örneğini oluşturun. Aşağıdaki kodda gösterildiği gibi, sınıf içinde IronTesseract'ün bir kez başlatıldığından emin olun. Bunu bir yöntem içinde örneklemek etkisiz olabilir ve beklenmedik hatalara yol açabilir.

Ardından, bir dosya seçmek için FilePicker.PickAsync yöntemini kullanın, sonra FileResult üzerinden bir okuma akışı açın. Yeni bir OcrInput nesnesi oluşturun ve görüntüyü buna yükleyin. Görüntü üzerinde OCR gerçekleştirin ve metni geri alın. Sonuçlanan metni nihayet bir etikete gösterin.

using IronOcr;
using Microsoft.Maui.Controls;
using System;
using System.Diagnostics;
using System.IO;
using System.Threading.Tasks;

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

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

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

                // Await user's file selection
                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 for OCR processing
                    ocrInput.AddImage(stream);
                    // Perform OCR
                    var ocrResult = ocrTesseract.Read(ocrInput);
                    // Display extracted text
                    OutputText.Text = ocrResult.Text;
                }
            }
            catch (Exception ex)
            {
                // Log and handle exceptions
                Debug.WriteLine(ex);
            }
        }
    }
}

using IronOcr;
using Microsoft.Maui.Controls;
using System;
using System.Diagnostics;
using System.IO;
using System.Threading.Tasks;

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

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

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

                // Await user's file selection
                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 for OCR processing
                    ocrInput.AddImage(stream);
                    // Perform OCR
                    var ocrResult = ocrTesseract.Read(ocrInput);
                    // Display extracted text
                    OutputText.Text = ocrResult.Text;
                }
            }
            catch (Exception ex)
            {
                // Log and handle exceptions
                Debug.WriteLine(ex);
            }
        }
    }
}

Imports IronOcr
Imports Microsoft.Maui.Controls
Imports System
Imports System.Diagnostics
Imports System.IO
Imports System.Threading.Tasks

Namespace MAUI_IronOCRAndroidSample
    Public Partial Class MainPage
        Inherits ContentPage

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

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

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

                ' Await user's file selection
                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 for OCR processing
                            ocrInput.AddImage(stream)
                            ' Perform OCR
                            Dim ocrResult = ocrTesseract.Read(ocrInput)
                            ' Display extracted text
                            OutputText.Text = ocrResult.Text
                        End Using
                    End Using
                End If
            Catch ex As Exception
                ' Log and handle exceptions
                Debug.WriteLine(ex)
            End Try
        End Sub
    End Class
End Namespace

$vbLabelText   $csharpLabel

Son olarak, .csproj dosyasında sadece Android için projeyi derlediğinizden emin olun. Eklediğimiz paket yalnızca Android için olduğundan, projeyi tüm platformlar için derlemek başarısız olacaktır.

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-android/MAUI IronOCRAndroidSample.zip)

Avalonia'da IronOcr.Android Kullanımı

MAUI'ye benzer şekilde, IronOcr.Android, yukarıda açıklanan aynı kurulumla bir Avalonia projesinde kullanılabilir.

iOS üzerinde OCR yapmak isterseniz, daha fazla bilgi edinmek için şu makaleye gidin: ".NET MAUI'de iOS üzerinde OCR Yapma Yöntemleri"