Android'de .NET MAUI ile Word Belgeleri Nasıl Okunur ve Yazılır

Adım 1: .NET MAUI Uygulama Projenizi Oluşturun

Visual Studio'yu açarak yeni bir .NET MAUI App projesi oluşturun. Bu proje türü, tek bir kod tabanından birden fazla platform için uygulama geliştirmeyi destekler.

Organize kalmak için IronWordMauiAndroid gibi net bir proje adı seçin. Bu kurulum, platforma özgü minimum kodla yerel bir Android uygulaması geliştirmek için temel oluşturur.

Adım 2: IronWord NuGet Paketini Ekleyin

IronWord, NuGet paketi aracılığıyla .NET projelerinize sorunsuz bir şekilde entegre edilebilir. IronWord'i NuGet üzerinden eklemek için, projenize sağ tıklayın ve NuGet Paketlerini Yönet'i seçin. "IronWord"u arayın ve en son kararlı sürümü yükleyin.

Alternatif olarak, NuGet Paket Yöneticisi Konsolu'nu kullanarak kolayca ekleyebilirsiniz, bu satırı çalıştırarak:

Install-Package IronWord

Adım 3: MainPage.xaml'de Arayüz Tasarlama

Android üzerinde kullanıcıların Word belgeleri oluşturup kaydetmelerine olanak tanımak için XAML kullanarak basit ve temiz bir kullanıcı arayüzü tasarlayacaksınız. Bu arayüz şunları içermektedir:

• Kullanıcıların içerik yazabileceği veya düzenleyebileceği çok satırlı bir metin düzenleyici.
• Mevcut metni bir .docx dosyasına kaydetmeyi tetikleyen bir "Word Belgesi Olarak Kaydet" butonu.
• Kullanıcıya geri bildirim veya hata mesajları sağlamak için bir durum etiketi.

Bu düzeni tanımlayan XAML işaretlemesi:

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

Adım 4: Ana Sayfa.xaml.cs'de Belge İşlemesini Uygulama

Arayüzü kurduktan sonra, artık belgelerin kaydedilmesini sağlamak için mantık ekleyebilirsiniz. MainPage.xaml.cs dosyasında, IronWord lisans anahtarınızı yapıcıda ayarlayın, ardından OnSaveWordClicked yöntemini uygulayın.

Butona dokunulduğunda, uygulama yeni bir WordDocument oluşturur, Editör'deki metni bir paragraf olarak ekler ve dosyayı kaydeder. Android'de, İndirilenler klasörüne kaydedilir; diğer platformlarda, uygulamanın önbellek dizinini kullanır.

Bir try-catch bloğu, herhangi bir hatanın yakalanmasını ve durum etiketinde gösterilmesini sağlar.

İşte tam çalışan kod:

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

Adım 5: Uygulamanızı Android'de Çalıştırın

Uygulamanızı Visual Studio'dan doğrudan bir Android emülatörüne veya fiziksel cihaza zahmetsizce dağıtın. Bu, Word belgelerini açma, içeriklerini düzenleme ve yapılan değişiklikleri kaydetme gibi temel özellikleri hızlı bir şekilde test etmenizi sağlar.

Yerel Android dosya seçicinin entegrasyonu, kullanıcılar için kusursuz ve tanıdık bir deneyim sunarak genel kullanılabilirliği artırır.

IronWord tamamen .NET ortamında çalıştığı için ek SDK'lara veya platforma özgü bağımlılıklara gerek yoktur—bu da uygulamanızın geliştirilmesini, bakımını ve dağıtımını daha basit hale getirir.