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

IronOCR Android 패키지

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

Install-Package IronOcr.Android

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

Install-Package IronOcr.Android

nuget.org/packages/IronOcr.Android/

.NET MAUI 프로젝트 생성

Visual Studio를 열고 'Create a new project'를 클릭합니다. MAUI를 검색하고 .NET MAUI App을 선택한 후 'Next'를 클릭합니다.

IronOcr.Android 라이브러리 포함

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

1. Visual Studio 안에서 'Dependencies'를 마우스 오른쪽 버튼으로 클릭하고 'Manage NuGet Packages ...'를 선택합니다.
2. 'Browse' 탭을 선택하고 'IronOcr.Android'를 검색합니다.
3. 'IronOcr.Android' 패키지를 선택하고 'Install'을 클릭합니다.

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

1. 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 'Edit Project File'을 선택합니다.

2. 새로운 ItemGroup 요소를 만듭니다:

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

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

   XML
3. 우리가 방금 만든 ItemGroup 안에 'IronOcr.Android' PackageReference를 이동합니다.

위 단계를 따르면 'IronOcr.Android' 패키지가 예를 들어 iOS 플랫폼에서 사용되지 않도록 방지할 수 있습니다 (그 목적을 위해서는 IronOcr.iOS를 설치하세요).

'MainActivity.cs' 편집하기

• Platforms -> Android로 이동하여 'MainActivity.cs' 파일을 엽니다.
• MainActivity 메서드를 추가하고 Initialize 메서드를 호출합니다.

using Android.App;
using Android.Content.PM;
using Android.Runtime;
using Android.OS;
using IronOcr;

namespace MAUIIronOCRAndroidSample
{
    [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 MAUIIronOCRAndroidSample
{
    [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);
        }
    }
}

'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="MAUIIronOCRAndroidSample.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="MAUIIronOCRAndroidSample.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을 수행하고 텍스트를 가져옵니다. 마지막으로, 얻은 텍스트를 레이블에 표시합니다.

using IronOcr;
using Microsoft.Maui.Controls;
using System;
using System.Diagnostics;
using System.IO;
using System.Threading.Tasks;

namespace MAUIIronOCRAndroidSample
{
    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 MAUIIronOCRAndroidSample
{
    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);
            }
        }
    }
}

$vbLabelText   $csharpLabel

마지막으로, .csproj 파일에서 프로젝트가 Android용으로만 빌드되는지 확인하십시오. 추가한 패키지는 Android 전용이므로 모든 플랫폼에 대해 프로젝트를 빌드하면 실패합니다.

프로젝트 실행

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

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

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

프로젝트를 다운로드하려면 여기를 클릭하세요.

Avalonia에서 IronOcr.Android 사용

MAUI와 유사하게 IronOcr.Android는 위에서 설명한 동일한 설정으로 Avalonia 프로젝트에서도 사용할 수 있습니다.

iOS에서 OCR을 수행하려면, 다음 기사에서 더 많은 정보를 확인하세요: ".NET MAUI에서 iOS에서 OCR 수행하는 방법"