Comment lire et écrire des documents Word sur Android dans .NET MAUI

Étape 1 : Créez votre projet d'application .NET MAUI

Commencez par ouvrir Visual Studio et créer un nouveau projet d'application .NET MAUI. Ce type de projet permet de créer des applications pour plusieurs plateformes à partir d'une seule base de code.

Choisissez un nom de projet clair tel que IronWordMauiAndroid pour rester organisé. Cette configuration pose les bases pour créer une application Android native avec un code spécifique à la plateforme minimal.

Étape 2 : Ajoutez le package NuGet IronWord

IronWord peut être intégré sans effort dans vos projets .NET via son package NuGet. Pour ajouter IronWord via NuGet, cliquez droit sur votre projet et sélectionnez Gérer les packages NuGet. Recherchez "IronWord" et installez la dernière version stable.

Alternativement, vous pouvez l'ajouter facilement en utilisant la console du gestionnaire de packages NuGet en exécutant cette ligne :

Install-Package IronWord

Étape 3 : Concevez l'interface utilisateur dans MainPage.xaml

Pour permettre aux utilisateurs de créer et d'enregistrer des documents Word sur Android, vous allez concevoir une interface utilisateur simple et épurée en utilisant XAML. Cette interface comprend :

• Un éditeur de texte multilignes où les utilisateurs peuvent taper ou modifier le contenu.
• Un bouton "Enregistrer en tant que document Word" qui déclenche l'enregistrement du texte actuel dans un fichier .docx.
• Une étiquette de statut pour fournir des messages de retour ou d'erreur à l'utilisateur.

Voici le balisage XAML qui définit cette mise en page :

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

Étape 4 : Mettez en œuvre le traitement des documents dans MainPage.xaml.cs

Avec l'interface utilisateur configurée, vous pouvez maintenant ajouter la logique pour gérer l'enregistrement des documents. Dans MainPage.xaml.cs, définissez votre clé de licence IronWord dans le constructeur, puis implémentez la méthode OnSaveWordClicked.

Lorsque le bouton est tapé, l'application crée un nouveau WordDocument, ajoute le texte de l'éditeur comme un paragraphe et enregistre le fichier. Sur Android, il est enregistré dans le dossier Téléchargements; sur d'autres plateformes, il utilise le répertoire de cache de l'application.

Un bloc try-catch garantit que toutes les erreurs sont capturées et affichées dans l'étiquette de statut.

Voici le code complet fonctionnel :

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

Étape 5 : Exécutez votre application sur Android

Déployez facilement votre application sur un émulateur Android ou un appareil physique directement depuis Visual Studio. Cela vous permet de tester rapidement des fonctionnalités essentielles telles que l'ouverture de documents Word, l'édition de leur contenu et l'enregistrement de toute modification.

L'intégration du sélecteur de fichiers natif Android offre une expérience transparente et familière pour les utilisateurs, améliorant ainsi la convivialité globale.

Puisqu'IronWord fonctionne entièrement dans l'environnement .NET, il n'y a pas besoin de SDK supplémentaires ou de dépendances spécifiques à la plateforme, rendant votre application plus facile à développer, maintenir et distribuer.