.NET MAUI 사용하여 Android에서 Word 문서를 읽고 쓰는 방법

1단계: .NET MAUI 앱 프로젝트를 생성합니다.

먼저 Visual Studio를 열고 새 .NET MAUI 앱 프로젝트를 생성합니다. 이 프로젝트 유형은 하나의 코드베이스로 여러 플랫폼용 앱을 개발하는 것을 지원합니다.

체계적인 관리를 위해 IronWordMauiAndroid처럼 명확한 프로젝트 이름을 선택하세요. 이러한 설정은 플랫폼별 코드를 최소화하여 네이티브 안드로이드 앱을 구축하기 위한 기반을 마련합니다.

2단계: IronWord NuGet 패키지를 추가합니다.

IronWord NuGet 패키지를 통해 .NET 프로젝트에 원활하게 통합할 수 있습니다. NuGet 통해 IronWord 추가하려면 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 NuGet 패키지 관리를 선택하세요. "IronWord"를 검색하여 최신 안정 버전을 설치하세요.

또는 NuGet 패키지 관리자 콘솔에서 다음 명령어를 실행하여 간편하게 추가할 수도 있습니다.

Install-Package IronWord

3단계: MainPage.xaml에서 UI를 디자인합니다.

Android에서 사용자가 Word 문서를 만들고 저장할 수 있도록 XAML을 사용하여 간단하고 깔끔한 사용자 인터페이스를 디자인해야 합니다. 이 인터페이스에는 다음이 포함됩니다.

• 사용자가 콘텐츠를 입력하거나 편집할 수 있는 여러 줄 텍스트 편집기입니다.
• 현재 텍스트를 .docx 파일로 저장하는 "워드 문서로 저장" 버튼.
• 사용자에게 피드백이나 오류 메시지를 제공하는 상태 레이블입니다.

다음은 이 레이아웃을 정의하는 XAML 마크업입니다.

<?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="IronWordAndroid.MainPage">

    <VerticalStackLayout Padding="20" Spacing="15">
        <Editor x:Name="WordEditor"
                Placeholder="Enter your text..."
                AutoSize="TextChanges"
                HeightRequest="300"/>
        <Button Text="Save as Word Document" Clicked="OnSaveWordClicked"/>
        <Label x:Name="StatusLabel" FontSize="12" TextColor="Gray"/>
    </VerticalStackLayout>
</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="IronWordAndroid.MainPage">

    <VerticalStackLayout Padding="20" Spacing="15">
        <Editor x:Name="WordEditor"
                Placeholder="Enter your text..."
                AutoSize="TextChanges"
                HeightRequest="300"/>
        <Button Text="Save as Word Document" Clicked="OnSaveWordClicked"/>
        <Label x:Name="StatusLabel" FontSize="12" TextColor="Gray"/>
    </VerticalStackLayout>
</ContentPage>

4단계: MainPage.xaml.cs 파일에 문서 처리 기능을 구현합니다.

사용자 인터페이스 설정이 완료되었으므로 이제 문서 저장 처리를 위한 로직을 추가할 수 있습니다. MainPage.xaml.cs 파일의 생성자에서 IronWord 라이선스 키를 설정한 다음 OnSaveWordClicked 메서드를 구현하십시오.

버튼을 탭하면 앱이 새 워드 문서를 만들고 편집기의 텍스트를 단락으로 추가한 다음 파일을 저장합니다. 안드로이드에서는 다운로드 폴더에 저장됩니다. 다른 플랫폼에서는 앱의 캐시 디렉토리를 사용합니다.

try-catch 블록은 모든 오류를 포착하여 상태 레이블에 표시하도록 합니다.

다음은 전체 작동 코드입니다.

using IronWord;
using IronWord.Models;
using Microsoft.Maui.Storage;
using System.Text;

namespace IronWordAndroid;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();

        // Set your IronWord license key
        License.LicenseKey = "YOUR-LICENSE-KEY";
    }

    private async void OnSaveWordClicked(object sender, EventArgs e)
    {
        try
        {
            // Create new Word document
            var document = new WordDocument();
            Paragraph paragraph = new Paragraph(new TextContent(WordEditor.Text));
            // Add basic text content
            document.AddParagraph(paragraph);

            // Generate a filename
            string fileName = $"MyWordDoc_{DateTime.Now:yyyyMMddHHmmss}.docx";

#if ANDROID
            string filePath = Path.Combine("/storage/emulated/0/Download", fileName);
#else
            string filePath = Path.Combine(FileSystem.CacheDirectory, fileName);
#endif

            // Save to path
            document.SaveAs(filePath);

            StatusLabel.Text = $"Saved to: {filePath}";
            await DisplayAlert("Success", $"File saved: {filePath}", "OK");
        }
        catch (Exception ex)
        {
            StatusLabel.Text = $"Error: {ex.Message}";
        }
    }
}

using IronWord;
using IronWord.Models;
using Microsoft.Maui.Storage;
using System.Text;

namespace IronWordAndroid;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();

        // Set your IronWord license key
        License.LicenseKey = "YOUR-LICENSE-KEY";
    }

    private async void OnSaveWordClicked(object sender, EventArgs e)
    {
        try
        {
            // Create new Word document
            var document = new WordDocument();
            Paragraph paragraph = new Paragraph(new TextContent(WordEditor.Text));
            // Add basic text content
            document.AddParagraph(paragraph);

            // Generate a filename
            string fileName = $"MyWordDoc_{DateTime.Now:yyyyMMddHHmmss}.docx";

#if ANDROID
            string filePath = Path.Combine("/storage/emulated/0/Download", fileName);
#else
            string filePath = Path.Combine(FileSystem.CacheDirectory, fileName);
#endif

            // Save to path
            document.SaveAs(filePath);

            StatusLabel.Text = $"Saved to: {filePath}";
            await DisplayAlert("Success", $"File saved: {filePath}", "OK");
        }
        catch (Exception ex)
        {
            StatusLabel.Text = $"Error: {ex.Message}";
        }
    }
}

5단계: 안드로이드에서 앱 실행하기

Visual Studio에서 바로 Android 에뮬레이터 또는 실제 기기에 애플리케이션을 간편하게 배포하세요. 이를 통해 Word 문서 열기, 내용 편집, 변경 사항 저장과 같은 필수 기능을 빠르게 테스트할 수 있습니다.

안드로이드 기본 파일 선택기 통합으로 사용자에게 매끄럽고 친숙한 경험을 제공하여 전반적인 사용성을 향상시킵니다.

IronWord .NET 환경에서 완전히 실행되므로 추가 SDK나 플랫폼별 종속성이 필요하지 않아 앱 개발, 유지 관리 및 배포가 더 간편해집니다.