Comment utiliser le logiciel OCR IronOCR sur iOS avec .NET MAUI

Package IronOCR pour iOS

Le package IronOcr.iOS active les fonctionnalités OCR sur les appareils iOS via des projets multiplateformes .NET. Le package IronOCR de base n'est pas nécessaire.

Installer le package IronOcr.iOS

### Installer avec NuGet

Installer le package IronOcr.iOS

nuget.org/packages/IronOcr.iOS/

Créer un projet .NET MAUI

Dans la section Multiplattform, sélectionnez .NET MAUI App et continuez.

Inclure la bibliothèque IronOCR.iOS

La bibliothèque peut être ajoutée de différentes manières. La plus simple est peut-être d'utiliser NuGet.

1. Dans Visual Studio, cliquez avec le bouton droit sur "Dépendances > NuGet" et sélectionnez "Gérer les packages NuGet...".
2. Sélectionnez l'onglet " Parcourir " et recherchez " IronOcr.iOS ".
3. Sélectionnez le package " IronOcr.iOS " et cliquez sur " Ajouter un package ".

Pour éviter les problèmes avec d'autres plateformes, modifiez le fichier csproj pour n'inclure le package que lors du ciblage de la plateforme iOS. Pour ce faire :

1. Faites un clic droit sur le fichier *.csproj de votre projet et sélectionnez " Modifier le fichier projet ".

2. Créez un nouvel élément ItemGroup comme suit :

   <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. Déplacez la référence de package "IronOCR.iOS " à l'intérieur du ItemGroup que nous venons de créer.

Les étapes ci-dessus empêcheront l'utilisation du package " IronOCR.iOS " sur, par exemple, les plateformes Android (pour cela, installez plutôt IronOcr.Android ).

Modifier " MainPage.xaml "

Modifiez le fichier XAML pour afficher un bouton et une étiquette permettant d'afficher le résultat de la reconnaissance optique de caractères (OCR). Par exemple :

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

Modifier " MainPage.xaml.cs "

Commencez par instancier l'objet IronTesseract. Assurez-vous d'initialiser IronTesseract une seule fois dans une classe, comme indiqué dans le code ci-dessous. L'instancier directement dans une méthode n'est pas efficace et pourrait entraîner des erreurs inattendues. Utilisez ensuite la méthode FilePicker.PickAsync pour sélectionner un fichier. À partir de FileResult, ouvrez un flux de lecture. Créez un nouvel objet OcrInput et utilisez cet objet pour charger l'image. Utilisez l'instance tesseract pour effectuer une reconnaissance optique de caractères (OCR) sur l'image et renvoyer le texte. Enfin, affichez le texte obtenu dans une étiquette.

La version actuelle se limite aux fichiers image. Ce logiciel ne fonctionne pas encore avec les documents PDF. Dans cette optique, toute configuration relative aux documents PDF doit rester désactivée.

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

Enfin, changez la cible de build sur iOS Simulator et exécutez le projet.

Exécuter le projet

Ceci vous montrera comment exécuter le projet et effectuer la reconnaissance optique de caractères (OCR).

Télécharger le projet d'application .NET MAUI

Vous pouvez télécharger le code complet pour ce guide. Il vient sous forme d'un fichier zippé que vous pouvez ouvrir dans Visual Studio en tant que projet d'application .NET MAUI.

Cliquez ici pour télécharger le projet.

Utilisation d'IronOcr.iOS à Avalonia

La configuration d'IronOCR.iOS dans Avalonia est similaire à celle de MAUI, à une différence cruciale près : en plus de la dernière version du SDK .NET, vous devez également installer le SDK .NET 8.0.101 pour exécuter IronOCR.iOS correctement. Par la suite, IronOcr.iOS peut être utilisé dans un projet Avalonia avec la même configuration que celle décrite ci-dessus.

Si vous souhaitez effectuer une reconnaissance optique de caractères (OCR) sur Android, consultez l'article suivant pour en savoir plus : " Comment effectuer une OCR sur Android avec .NET MAUI ".