.NET MAUI'de Android'de Word Dokümanlarini Okuma ve Yazma

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

Visual Studio'yu açarak ve yeni bir .NET MAUI Uygulama projesi yaratarak başlayın. Bu proje türü, birçok platform için tek bir kod tabanından uygulama oluşturmayı destekler.

IronWordMauiAndroid gibi net bir proje ismi seçin ve düzenli olun. Bu ayar, platform specific koda en az ihtiyaç duyarak yerel bir Android uygulamasi oluşturma temelini oluşturur.

Adım 2: IronWord NuGet Paketini Ekleyin

IronWord, NuGet paketi araciligi ile .NET projelerinize kolayca entegre edilebilir. NuGet aracılığıyla IronWord'u eklemek için projenize sağ tıklayıp Manage NuGet Packages secenegini secin. "IronWord" arayin ve son stabil surumunu yukleyin.

Alternatif olarak, NuGet Package Manager Console'dan bu satiri calistirarak da kolayca ekleyebilirsiniz:

Install-Package IronWord

Adım 3: UI'yi MainPage.xaml'de Tasanlayin

Kullanicilarin Android'de Word dokümanlari oluşturup kaydedebilmesi icin, XAML kullanarak basit ve temiz bir arayuz tasarimlayacaksiniz. Bu arayuz sunlari icerir:

• Kullanicilarin metin yazabilecegi veya duzeleyebilecegi cift satirli bir metin editoru.
• Anlik metni .docx dosyasina kaydeden "Word Dosyasi Olarak Kaydet" butonu.
• Kullanicıya geri bildirim veya hata mesaji veren durum etiketi.

Iste bu düzeni tanimlayan XAML isaretlemesi:

<?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: MainPage.xaml.cs'de Doküman İşlemlerini Uygulayın

Kullanıcı arabirimi kurulduktan sonra, doküman kaydetme islevi ekleyebilirsiniz. MainPage.xaml.cs'de, kurucu icinde IronWord lisans anahtarınızı ayarlayin, ardindan OnSaveWordClicked metodunu uygulayin.

Butona tiklandiginda, uygulama yeni bir WordDocument oluşturur, Editor'deki metni bir paragrafa ekler ve dosyayi kaydeder. Android'de, Dosyalar klasorune kaydedilir; diğer platformlarda, uygulamanın cache dizinini kullanılır.

Bir try-catch blogu, herhangi bir hata yakalanmasını ve durum etiketinde gösterilmesini saglar.

Iste tam islevli calisan 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

    Public Partial Class MainPage
        Inherits ContentPage

        Public Sub New()
            InitializeComponent()

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

        Private Async Sub OnSaveWordClicked(sender As Object, e As EventArgs)
            Try
                ' Create new Word document
                Dim document As 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: Uygulamanizi Android'de Calistirin

Uygulamanızı bir Android emülatörüne veya fiziksel cihaza Visual Studio'dan kolaylıkla dağıtin. Bu, Word dokümanlarini acmak, icerigini duzenlemek ve herhangi bir değişikligi kaydetmek gibi onemli özellikleri hizlica test etmenize olanak tanir.

Yerel Android dosyası secici ile entegrasyon, kullanicilara sorunsuz ve tanidik bir deneyim sunarak genel kullanilabilirligi artirir.

IronWord tamamen .NET ortamında çalistigindan, ek SDK'lar veya platforma ozel bagimliliklara ihtiyaç duymaz—bu da uygulamanizin geliştirilmesini, bakimını ve dağıtilmasını basitlesdirir.