Cómo realizar OCR en iOS en .NET MAUI

Paquete IronOCR para iOS

El paquete IronOcr.iOS habilita funciones de OCR en dispositivos iOS vía proyectos multiplataforma de .NET. No se necesita el paquete IronOCR estándar.

Paquete de instalación IronOcr.iOS

Instalar con NuGet

Paquete de instalación IronOcr.iOS

nuget.org/packages/IronOcr.iOS/

Crear un proyecto .NET MAUI

En la sección Multiplataforma, selecciona .NET MAUI App y continúa.

Incluir la biblioteca IronOCR.iOS

La biblioteca se puede agregar de varias maneras. La más fácil es quizás usando NuGet.

1. Dentro de Visual Studio, haz clic derecho en "Dependencies > NuGet" y selecciona "Manage NuGet Packages ...".
2. Seleccione la pestaña "Examinar" y busque "IronOCR.iOS".
3. Seleccione el paquete "IronOCR.iOS" y haga clic en "Agregar Paquete".

Para evitar problemas con otras plataformas, modifica el archivo csproj para incluir el paquete solo cuando se dirija a la plataforma iOS. Para hacerlo:

1. Haz clic derecho en el archivo *.csproj de tu proyecto y selecciona "Editar archivo del proyecto".

2. Crea un nuevo elemento ItemGroup de esta manera:

   <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. Mueve la referencia del paquete "IronOcr.iOS" dentro del ItemGroup que acabamos de crear.

Los pasos anteriores evitarán que el paquete "IronOCR.iOS" se use en, por ejemplo, plataformas Android (para ese propósito, instale IronOcr.Android en su lugar).

Editar "MainPage.xaml"

Edite el archivo XAML para mostrar un botón y una etiqueta para mostrar el resultado del OCR. Por ejemplo:

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

Editar "MainPage.xaml.cs"

Comienza instanciando el objeto IronTesseract. Asegúrate de inicializar IronTesseract una vez en una clase, como se muestra en el código a continuación. Instanciarlo directamente en un método no es efectivo y podría llevar a errores inesperados. Luego, utiliza el método FilePicker.PickAsync para seleccionar un archivo. Desde el FileResult, abre un flujo para leer. Crea un nuevo objeto OcrInput y usa este objeto para cargar la imagen. Use la instancia de Tesseract para realizar OCR en la imagen y devolver el texto. Finalmente, muestre el texto resultante en una etiqueta.

La implementación actual está limitada solo a archivos de imagen. El paquete aún no funciona con documentos PDF. Con esto en mente, cualquier configuración relacionada con documentos PDF debería permanecer desactivada.

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

Por último, cambia el objetivo de compilación a iOS Simulator y ejecuta el proyecto.

Ejecutar el proyecto

Esto le mostrará cómo ejecutar el proyecto y realizar OCR.

Descargar proyecto de aplicación .NET MAUI

Puede descargar el código completo de esta guía. Viene como un archivo comprimido que puede abrir en Visual Studio como un proyecto de aplicación .NET MAUI.

Haga clic aquí para descargar el proyecto.

Casos de uso regulatorios españoles en iOS

Una vez configurado IronOCR iOS en tu aplicación .NET MAUI, puedes implementar los siguientes casos de uso para el mercado español:

Verificación DNI/NIE/TIE on-device: usa ocrInput.LoadImage(stream) para cargar la imagen del documento capturada con la cámara del iPhone. IronOCR extraerá los campos de texto de la MRZ (Zona de Lectura Mecánica) del documento. Dado que el procesamiento se realiza en el dispositivo, la imagen del DNI o NIE no se transmite a ningún servidor, cumpliendo con la LOPDGDD y las directrices de la AEPD para el tratamiento de documentos de identidad.

Facturae en aplicaciones empresariales iOS: los ejecutivos y comerciales que necesitan capturar facturas de proveedor con su iPhone pueden utilizar IronOCR para extraer NIF del proveedor, base imponible y cuota de IVA directamente en la aplicación, sincronizando los datos con el sistema ERP de la empresa sin intermediarios de nube que tengan acceso a los documentos fiscales.

TicketBAI en iPhone: las aplicaciones de TPV para iOS en el País Vasco pueden leer el código QR de TicketBAI de tickets impresos. Activa ocrTesseract.Configuration.ReadBarCodes = true y el identificador único del ticket se capturará automáticamente para su almacenamiento y trazabilidad.

Nota sobre limitaciones del paquete iOS: el paquete IronOcr.iOS actual no soporta el procesamiento de documentos PDF. Si necesitas procesar facturas Facturae en formato PDF desde iOS, considera una arquitectura híbrida donde la captura se realiza en iOS y el procesamiento PDF se delega a un servicio backend en Azure Spain Central.

Uso de IronOcr.iOS en Avalonia

Configurar IronOCR.iOS en Avalonia es similar a MAUI, con una diferencia crucial: además de la última versión del SDK de .NET, también necesita .NET SDK 8.0.101 instalado para ejecutar IronOCR.iOS exitosamente. Después, IronOcr.iOS se puede usar en un proyecto Avalonia con la misma configuración descrita anteriormente.

Si desea realizar OCR en Android, navegue al siguiente artículo para obtener más información: "Cómo realizar OCR en Android en .NET MAUI"