Jak przeprowadzić OCR na iOS w .NET MAUI

Pakiet IronOCR iOS

Pakiet IronOcr.iOS umożliwia funkcje OCR na urządzeniach iOS za pośrednictwem projektów krzyżowoplatformowych .NET. Standardowy pakiet IronOCR nie jest potrzebny.

Install-Package IronOcr.iOS

Zainstaluj za pomocą NuGet

Install-Package IronOcr.iOS

nuget.org/packages/IronOcr.iOS/

Utwórz projekt .NET MAUI

W sekcji "Multiplatform" wybierz opcję "Aplikacja .NET MAUI" i kontynuuj.

Dołącz bibliotekę IronOCR.iOS

Bibliotekę można dodać na różne sposoby. Najłatwiej jest użyć NuGet.

1. W programie Visual Studio kliknij prawym przyciskiem myszy "Zależności > NuGet" i wybierz "Zarządzaj pakietami NuGet...".
2. Wybierz zakładkę "Przeglądaj" i wyszukaj "IronOcr.iOS".
3. Wybierz pakiet "IronOcr.iOS" i kliknij "Dodaj pakiet".

Aby zapobiec problemom z innymi platformami, zmodyfikuj plik csproj, aby uwzględniał pakiet tylko wtedy, gdy celem jest platforma iOS. Aby to zrobić:

1. Kliknij prawym przyciskiem na plik *.csproj w swoim projekcie i wybierz "Edit Project File".

2. Utwórz nowy element ItemGroup w następujący sposób:

   <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. Przenieś odwołanie do pakietu "IronOcr.iOS" do wnętrza ItemGroup, który właśnie stworzyliśmy.

Powyższe kroki zapobiegną użyciu pakietu "IronOcr.iOS" na platformach takich jak Android (w tym celu zainstaluj zamiast tego IronOcr.Android).

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

Edytuj "MainPage.xaml.cs"

Rozpocznij od zainicjowania obiektu IronTesseract. Upewnij się, że zainicjowano IronTesseract raz w klasie, jak pokazano poniżej w kodzie. Zainicjowanie go bezpośrednio w metodzie nie jest efektywne i może prowadzić do nieoczekiwanych błędów. Następnie użyj metody FilePicker.PickAsync, aby wybrać plik. Z FileResult otwórz strumień do odczytu. Utwórz nowy obiekt OcrInput i użyj tego obiektu do załadowania obrazu. Użyj instancji tesseract, aby przeprowadzić OCR na obrazie i zwróć tekst. Na koniec wyświetl wynikowy tekst w etykiecie.

Obecna implementacja jest ograniczona tylko do plików obrazów. Pakiet nie działa jeszcze z dokumentami PDF. Mając to na uwadze, wszelkie konfiguracje związane z dokumentami PDF powinny pozostać wyłączone.

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

Na koniec zmień cel kompilacji na iOS Simulator i uruchom projekt.

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.

Użycie IronOcr.iOS w Avalonia

Konfiguracja IronOcr.iOS w Avalonia jest podobna do MAUI, z jedną kluczową różnicą: oprócz najnowszej wersji SDK .NET musisz również mieć zainstalowane .NET SDK 8.0.101, aby pomyślnie uruchomić IronOcr.iOS. Następnie, IronOcr.iOS można używać w projekcie Avalonia z taką samą konfiguracją, jak opisano powyżej.

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