Como ler e escrever documentos do Word no Android usando .NET MAUI

Passo 1: Crie seu projeto de aplicativo .NET MAUI

Comece abrindo o Visual Studio e criando um novo projeto de aplicativo .NET MAUI . Este tipo de projeto permite a criação de aplicativos para múltiplas plataformas a partir de uma única base de código.

Escolha um nome de projeto claro, como IronWordMauiAndroid, para manter a organização. Essa configuração estabelece as bases para a criação de um aplicativo nativo para Android com o mínimo de código específico da plataforma.

Passo 2: Adicione o pacote NuGet IronWord

O IronWord pode ser integrado perfeitamente aos seus projetos .NET através do seu pacote NuGet . Para adicionar o IronWord via NuGet, clique com o botão direito do mouse no seu projeto e selecione Gerenciar Pacotes NuGet . Procure por "IronWord" e instale a versão estável mais recente.

Alternativamente, você pode adicioná-lo facilmente usando o Console do Gerenciador de Pacotes NuGet executando esta linha:

Install-Package IronWord

Etapa 3: Projete a interface do usuário em MainPage.xaml

Para permitir que os usuários criem e salvem documentos do Word no Android, você projetará uma interface de usuário simples e limpa usando XAML. Esta interface inclui:

• Um editor de texto com várias linhas onde os usuários podem digitar ou editar conteúdo.
• Um botão "Salvar como documento do Word" que salva o texto atual em um arquivo .docx.
• Uma etiqueta de status para fornecer feedback ou mensagens de erro ao usuário.

Aqui está o código XAML que define esse layout:

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

Etapa 4: Implementar o tratamento de documentos em MainPage.xaml.cs

Com a interface do usuário configurada, agora você pode adicionar a lógica para gerenciar o salvamento de documentos. No arquivo MainPage.xaml.cs, defina sua chave de licença do IronWord no construtor e, em seguida, implemente o método OnSaveWordClicked.

Ao tocar no botão, o aplicativo cria um novo documento do Word, adiciona o texto do Editor como um parágrafo e salva o arquivo. No Android, ele é salvo na pasta Downloads; Em outras plataformas, ele usa o diretório de cache do aplicativo.

Um bloco try-catch garante que quaisquer erros sejam capturados e exibidos no rótulo de status.

Aqui está o código completo em funcionamento:

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

Imports IronWord
Imports IronWord.Models
Imports Microsoft.Maui.Storage
Imports System.Text

Namespace IronWordAndroid

	Partial Public Class MainPage
		Inherits ContentPage

		Public Sub New()
			InitializeComponent()

			' Set your IronWord license key
			License.LicenseKey = "YOUR-LICENSE-KEY"
		End Sub

		Private Async Sub OnSaveWordClicked(ByVal sender As Object, ByVal e As EventArgs)
			Try
				' Create new Word document
				Dim document = New WordDocument()
				Dim paragraph As New Paragraph(New TextContent(WordEditor.Text))
				' Add basic text content
				document.AddParagraph(paragraph)

				' Generate a filename
				Dim fileName As String = $"MyWordDoc_{DateTime.Now:yyyyMMddHHmmss}.docx"

#If ANDROID Then
				Dim filePath As String = Path.Combine("/storage/emulated/0/Download", fileName)
#Else
				Dim filePath As String = Path.Combine(FileSystem.CacheDirectory, fileName)
#End If

				' Save to path
				document.SaveAs(filePath)

				StatusLabel.Text = $"Saved to: {filePath}"
				Await DisplayAlert("Success", $"File saved: {filePath}", "OK")
			Catch ex As Exception
				StatusLabel.Text = $"Error: {ex.Message}"
			End Try
		End Sub
	End Class
End Namespace

Etapa 5: Execute seu aplicativo no Android

Implante seu aplicativo sem esforço em um emulador Android ou dispositivo físico diretamente do Visual Studio. Isso permite testar rapidamente funcionalidades essenciais, como abrir documentos do Word, editar o conteúdo e salvar as alterações.

A integração do seletor de arquivos nativo do Android oferece uma experiência perfeita e familiar para os usuários, melhorando a usabilidade geral.

Como o IronWord funciona inteiramente dentro do ambiente .NET , não há necessidade de SDKs adicionais ou dependências específicas da plataforma, o que torna seu aplicativo mais simples de desenvolver, manter e distribuir.