Jak wykonać OCR na Androidzie w .NET MAUI

Pakiet IronOCR dla systemu Android

Pakiet IronOcr.Android umożliwia korzystanie z funkcji OCR na urządzeniach z systemem Android poprzez projekty wielopłatformowe .NET. Standardowy pakiet IronOCR nie jest potrzebny.

Zainstaluj pakiet IronOcr.Android

Zainstaluj za pomocą NuGet

Zainstaluj pakiet IronOcr.Android

nuget.org/packages/IronOcr.Android/

Utwórz projekt .NET MAUI

Otworz Visual Studio i kliknij na "Utworz nowy projekt". Wyszukaj MAUI, wybierz .NET MAUI App i "Dalej".

Dodaj bibliotekę IronOcr.Android

Biblioteke można dodac na różne sposoby. Najłatwiej jest uzyc NuGet.

1. W Visual Studio, kliknij prawym przyciskiem myszy na "Dependencies" i wybierz "Manage NuGet Packages ...".
2. Wybierz zakładkę "Przeglądaj" i wyszukaj "IronOcr.Android".
3. Wybierz pakiet "IronOcr.Android" i kliknij "Zainstaluj".

Aby uniknąć problemow z innymi platformami, zmodyfikuj plik csproj, aby uwzględnić pakiet tylko przy celowaniu w platforme Android. Aby to zrobic:

1. Kliknij prawym przyciskiem myszy na projekt i wybierz "Edytuj plik projektu".

2. Utworz nowy element ItemGroup, jak poniżej:

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

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

   XML
3. Przenieś odwołanie do pakietu "IronOcr.Android" do właśnie utworzonej grupy ItemGroup.

Powyższe kroki zapobiegną użyciu pakietu "IronOcr.Android" np. na platformach iOS (w tym celu należy zainstalować IronOcr.iOS).

Edytuj "MainActivity.cs"

• Otwórz plik "MainActivity.cs", przechodząc do Platforms -> Android.
• Dodaj metode MainActivity i wywolaj metode Initialize.

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

Edytuj "MainPage.xaml"

Edytuj plik XAML, aby wyświetlić przycisk i etykietę pokazujące wynik OCR. Na przykład:

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

Edytuj "MainPage.xaml.cs"

Najpierw utworz instancje obiektu IronTesseract. Upewnij sie, ze IronTesseract jest inicjalizowany raz wewnatrz klasy, jak pokazano w kodzie ponizej. Utworzenie instancji w ramach metody może być nieskuteczne i może powodować nieoczekiwane błędy.

Nastepnie uzyj metody FilePicker.PickAsync, aby wybrac plik, a nastepnie otworz strumien odczytu z FileResult. Utworz nowy obiekt OcrInput i zaladuj do niego obraz. Wykonaj OCR na obrazie za pomocą instancji Tesseract i odzyskaj tekst. Na koniec wyświetl wynikowy tekst w etykiecie.

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

Na koniec, w pliku .csproj, upewnij sie, ze tylko budujesz projekt dla Androida. Ponieważ dodany przez nas pakiet jest przeznaczony wyłącznie dla systemu Android, kompilacja projektu dla wszystkich platform zakończy się niepowodzeniem.

Uruchom projekt

Poniżej przedstawiono instrukcję uruchamiania projektu i przeprowadzania OCR.

Pobierz projekt aplikacji .NET MAUI

Możesz pobrać pełny kod do tego przewodnika. Jest dostępny jako spakowany plik, który możesz otworzyć w Visual Studio jako projekt .NET MAUI App.

[Kliknij tutaj, aby pobrać projekt.](/static-assets/ocr/how-to/setup-android/MAUI IronOCRAndroidSample.zip)

Korzystanie z IronOcr.Android w Avalonii

Podobnie jak MAUI, IronOcr.Android może być używany w projekcie Avalonia przy takiej samej konfiguracji, jak opisano powyżej.

Jeśli chcesz przeprowadzić OCR na iOS, przejdź do następującego artykułu, aby dowiedzieć się więcej: "Jak przeprowadzić OCR na iOS w .NET MAUI"