.NET MAUI에서 iOS에 OCR 수행하는 방법

IronOCR iOS 패키지

IronOcr.iOS 패키지는 iOS 기기에서 .NET 크로스 플랫폼 프로젝트를 통해 OCR 기능을 사용할 수 있게 합니다. 기본 IronOCR 패키지는 필요 없습니다.

Install-Package IronOCR.iOS

### NuGet을 사용하여 설치하세요

Install-Package IronOCR.iOS

nuget.org/packages/IronOcr.iOS/

.NET MAUI 프로젝트를 생성합니다.

멀티플랫폼 섹션에서 .NET MAUI 앱을 선택하고 계속합니다.

IronOCR.iOS 라이브러리 포함

라이브러리는 다양한 방법으로 추가할 수 있습니다. 가장 쉬운 방법은 아마도 NuGet을 사용하는 것입니다.

1. Visual Studio 내에서, "Dependencies > NuGet"을 우클릭하고 "Manage NuGet Packages ..."를 선택합니다.
2. "Browse" 탭을 선택하고 "IronOcr.iOS"를 검색합니다.
3. "IronOcr.iOS" 패키지를 선택하고 "Add Package"를 클릭합니다.

다른 플랫폼과의 문제를 방지하려면 csproj 파일을 수정하여 iOS 플랫폼을 대상으로 할 때만 해당 패키지를 포함하도록 하십시오. 이를 수행하려면:

1. 프로젝트의 *.csproj 파일을 우클릭하고 "Edit Project File"을 선택합니다.

2. 다음과 같이 새로운 ItemGroup 요소를 생성합니다.

   <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. "IronOCR.iOS" PackageReference를 방금 생성한 ItemGroup 안으로 이동합니다.

위의 단계는 "IronOcr.iOS" 패키지가 안드로이드 플랫폼에서는 사용되지 않도록 합니다 (그 목적을 위해서는 대신 IronOcr.Android를 설치하십시오).

'MainPage.xaml' 편집하기

XAML 파일을 편집하여 버튼과 OCR 결과를 표시할 레이블을 만듭니다. 예를 들어:

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

'MainPage.xaml.cs' 편집하기

먼저 IronTesseract 객체를 인스턴스화합니다. 아래 코드에 나와 있는 것처럼 클래스 내에서 IronTesseract를 한 번만 초기화해야 합니다. 메소드 내에서 직접 인스턴스화하는 것은 효과적이지 않으며 예기치 않은 오류로 이어질 수 있습니다. 다음으로, FilePicker.PickAsync 메서드를 사용하여 파일을 선택합니다. FileResult에서 읽기용 스트림을 엽니다. 새로운 OcrInput 객체를 생성하고 이 객체를 사용하여 이미지를 로드합니다. Tesseract 인스턴스를 사용하여 이미지에서 OCR을 수행하고 텍스트를 반환합니다. 마지막으로, 얻은 텍스트를 레이블에 표시합니다.

현재 구현은 이미지 파일에만 제한됩니다. 패키지는 아직 PDF 문서와 작동하지 않습니다. 이를 염두에 두고, PDF 문서와 관련된 모든 구성은 비활성화된 상태로 유지해야 합니다.

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);
        }
    }
}

$vbLabelText   $csharpLabel

마지막으로, 빌드 대상을 iOS 시뮬레이터로 전환하고 프로젝트를 실행하세요.

프로젝트 실행

이것은 프로젝트를 실행하고 OCR을 수행하는 방법을 보여줄 것입니다.

.NET MAUI App 프로젝트 다운로드

이 가이드의 전체 코드를 다운로드할 수 있습니다. 이는 Visual Studio에서 .NET MAUI App 프로젝트로 열 수 있는 압축된 파일 형태로 제공됩니다.

프로젝트를 다운로드하려면 여기를 클릭하십시오.

Avalonia에서 IronOcr.iOS 사용하기

Avalonia에서 IronOcr.iOS를 설정하는 것은 MAUI와 유사하지만 중요한 차이점이 하나 있습니다: 최신 .NET SDK 버전 외에도 IronOcr.iOS가 성공적으로 실행되려면 .NET SDK 8.0.101이 설치되어 있어야 합니다. 그 후, IronOcr.iOS는 위에서 설명한 동일한 설정으로 Avalonia 프로젝트에서 사용할 수 있습니다.

안드로이드에서 OCR을 수행하려면, 더 많은 내용을 배우기 위해서는 다음 문서로 이동하십시오: ".NET MAUI에서 안드로이드에 OCR 수행하는 방법"