如何在.NET MAUI中對 iOS 裝置執行 OCR

IronOCR iOS 套件

IronOCR.iOS 套件透過.NET跨平台專案在 iOS 裝置上啟用 OCR 功能。 不需要原版IronOCR軟體包。

Install-PackageIronOCR.iOS 套件

### 使用NuGet安裝

Install-PackageIronOCR.iOS 套件

nuget.org/packages/IronOcr.iOS/

建立一個.NET MAUI項目

在"多平台"部分，選擇".NET MAUI應用程式"並繼續。

包含IronOCR.iOS 庫

可以透過多種方式新增庫。 最簡單的方法或許是使用NuGet。

1. 在 Visual Studio 中，右鍵點選"依賴項 > NuGet"，然後選擇"管理NuGet套件..."。
2. 選擇"瀏覽"選項卡，搜尋"IronOCR"。
3. 選擇"IronOCR.iOS"軟體包，然後點選"新增軟體包"。

為防止與其他平台出現問題，請修改 csproj 文件，使其僅在面向 iOS 平台時包含該軟體套件。 為了做到這一點：

1. 右鍵點選專案的 *.csproj 文件，然後選擇"編輯專案文件"。

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"軟體套件在Android等平台上使用(為此，請安裝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應用專案

您可以下載本指南的完整程式碼。它以壓縮檔案的形式提供，您可以在 Visual Studio 中將其作為.NET MAUI應用程式專案開啟。

點擊此處下載項目。

在 Avalonia 中使用IronOCR.iOS

在 Avalonia 中設定IronOCR.iOS 與在 MAUI 中設定 IronOcr .iOS 類似，但有一個關鍵區別：除了最新的.NET SDK 版本之外，您還需要安裝.NET SDK 8.0.101才能成功運行IronOCR.iOS。 之後， IronOCR.iOS 可以在 Avalonia 專案中使用，設定方式與上述相同。

如果您想在 Android 上執行 OCR，請參閱以下文章以了解更多資訊："如何在.NET MAUI中對 Android 執行 OCR "