.NET MAUI ya da .NET Multi-platform App UI, çapraz platform uygulamaları oluşturmak için bir çerçevedir. Geliştiricilere Windows, macOS, iOS, Android ve diğer cihazlarda çalışan tek bir kod tabanı ile uygulamalar oluşturma olanağı tanır. JavaScript yerine C# kullanan React Native'e benzer.

.NET MAUI, C# geliştiricilerinin tek bir ortamdan mobil ve masaüstü uygulamaları zahmetsizce oluşturmalarına olanak tanır. Microsoft .NET MAUI, geliştiricilerin uygulama geliştirme sürecini optimize etmelerine ve düzene sokmalarına yardımcı olmak için kapsamlı belgeler ve kaynaklar sağlar.

Bu makalede, veri çıkartma amaçlı .NET MAUI ile güçlü bir C# ZIP Arşiv Kütüphanesi olan IronZIP entegrasyonunu inceleyeceğiz.

Zip Arşivlerinden Veri Çıkartma Nasıl Yapılır

1. Visual Studio .NET MAUI Projesi Oluşturun
2. C# Zip Kütüphanesini NuGet aracılığıyla yükleyin
3. Veri Çıkarma Uygulaması Arayüzünü Tasarlayın
4. Zip Oluştur ve Extract Zip Metodlarını Uygulayın
5. Uygulamayı çalıştırın ve sonuçları doğrulayın

IronZIP'e Giriş

IronZIP, .NET'te arşivler oluşturma, okuma ve çıkarma işlemleri için tasarlanmış kapsamlı bir C# ZIP arşiv kütüphanesidir. ZIP, TAR, GZIP ve BZIP2 dahil geniş bir arşiv formatı yelpazesini destekler. IronZIP, .NET 7, 6, 5, Core, Standard ve Framework gibi çeşitli .NET sürümleriyle uyumludur.

C#, F# ve VB.NET uygulamaları için Windows, Linux, Mac, iOS, Android, Docker, Azure ve AWS üzerinde çalışarak platformlar arası destek sağlar.

IronZIP'in Anahtar Özellikleri şunlardır:

• Çeşitli işletim sistemleri için platformlar arası destek.
• Farklı .NET sürümleri ve proje türleriyle uyumluluk.
• ZIP, TAR, GZIP ve BZIP2 arşivleri oluşturma, okuma ve çıkarma desteği.
• Çok platformlu uygulamalar oluşturmak için .NET MAUI ile entegrasyon.

Gereksinimler

Başlamadan önce, aşağıdaki ön gereksinimlerin mevcut olduğundan emin olun:

1. .NET MAUI iş yükü yüklü Visual Studio.
2. IronZIP kütüphanesi .NET MAUI projenize eklendi.

Visual Studio'da .NET MAUI Uygulaması Oluşturma Adımları

1. Visual Studio'yu açın ve "Yeni proje oluştur"a tıklayın.
2. .NET MAUI Uygulama proje şablonunu seçin ve Sonraki'yi tıklayın.

3. Proje Ayarlarını, Proje Adını ve Konumunu yapılandırın. İleri'ye tıklayın.

4. Ek Bilgilerden doğru .NET Framework'ü seçin. IronZIP en son .NET Framework sürümünü destekler, bu yüzden onu seçebilirsiniz.

5. IronZIP kütüphanesini kullanarak Zip Veri Çıkartma için .NET MAUI Uygulaması oluşturmak için Oluştur'a tıklayın.

IronZIP Yükleme

IronZIP'i .NET MAUI projenize entegre etmek için, bu adımları izleyin:

1. Çözüm Gezgini'ni Görünüm menüsünden açın.

2. Çözüm Gezgini'nde projenize sağ tıklayın.
3. "Çözüm için NuGet Paketlerini Yönet" seçeneğini seçin.

4. NuGet tarama sekmesinde "IronZIP" arayın ve projeniz için paketi yükleyin.

5. Preview Changes Dialog kutusunda, değişiklikleri yapmak için "Uygula"ya tıklayın ve ardından IronZIP Lisansını kabul etmek için "Kabul Et"'e tıklayın.
6. NuGet kurulumunu tamamlayacak ve bir onay mesajı görünecektir.

Şimdi her şey kurulu ve ayarlanmış olduğuna göre, .NET MAUI'de bir Zip Extractor oluşturma veri çıkarma görevine geçelim.

Bir Zip Extractor Oluşturma Adımları

Adım 1: Uygulamanın Arayüzünü Tasarlayın

Bu bölümde, .NET MAUI uygulamanız için kullanıcı arayüzünü tasarlamaya odaklanacağız. Proje klasörünüzdeki MainPage.xaml dosyasını açın ve kullanıcı dostu bir arayüz oluşturmak için gerekli XAML kodunu ekleyin.

Burada, zip dosyalarını oluşturmak için bir düğme ve başka birini zip dosyalarını çıkartmak için olacak şekilde iki düğmeye ihtiyacımız olacak. Uygun mesajlar vermek için birkaç etiket de gereklidir. Aşağıdaki kod örneği, tasarımın XAML kodunu göstermektedir:

<?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="MauiAppDataExtraction.MainPage">
    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">
            <Label
                Text="IronZIP - A Zip Library to Create and Extract Zip Content!"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="32"
                HorizontalOptions="Center" />
            <Label
                Text="Welcome to .NET Multi-platform App UI"
                SemanticProperties.HeadingLevel="Level2"
                SemanticProperties.Description="Welcome to dot net Multi platform App U I"
                FontSize="18"
                HorizontalOptions="Center" />
            <Button
                x:Name="OpenFileBtn"
                Text="Extract Zip File"
                SemanticProperties.Hint="Opens the File Picker"
                Clicked="OnSelectFileButtonClicked"
                HorizontalOptions="Center" />
            <Button
                 x:Name="OpenFilesBtn"
                 Text="Create Zip"
                 SemanticProperties.Hint="Opens the File Picker"
                 Clicked="OnSelectFilesButtonClicked"
                 HorizontalOptions="Center" />  
        </VerticalStackLayout>
    </ScrollView>
</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="MauiAppDataExtraction.MainPage">
    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">
            <Label
                Text="IronZIP - A Zip Library to Create and Extract Zip Content!"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="32"
                HorizontalOptions="Center" />
            <Label
                Text="Welcome to .NET Multi-platform App UI"
                SemanticProperties.HeadingLevel="Level2"
                SemanticProperties.Description="Welcome to dot net Multi platform App U I"
                FontSize="18"
                HorizontalOptions="Center" />
            <Button
                x:Name="OpenFileBtn"
                Text="Extract Zip File"
                SemanticProperties.Hint="Opens the File Picker"
                Clicked="OnSelectFileButtonClicked"
                HorizontalOptions="Center" />
            <Button
                 x:Name="OpenFilesBtn"
                 Text="Create Zip"
                 SemanticProperties.Hint="Opens the File Picker"
                 Clicked="OnSelectFilesButtonClicked"
                 HorizontalOptions="Center" />  
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

Uygulamayı çalıştırın ve ekranda normal Windows formları olarak çıktıyı göreceksiniz.

Adım 2: Kodu Uygulama

1. Zip Oluştur

MainPage.xaml.cs dosyasını açın ve "Create Zip" işlevini oluşturun. OnSelectFilesButtonClicked metodunu, kullanıcıların FilePicker açmasına ve bir zip dosyası oluşturmak için herhangi bir türde birden fazla dosya seçmesine izin verecek şekilde uygulayın.

Daha sonra seçilen tüm dosyaların yollarından bir liste oluşturun. Son olarak, IronZIP'in tüm dosya yollarını kullanarak bir zip dosyası oluşturduğu CreateZip metoduna bir saniyenin altında sorunsuz bir şekilde iletin.

Aşağıdaki kod örneği, bu görevi gerçekleştirme adımlarını gösterir.

private async void OnSelectFilesButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select multiple files of any type
        var results = await FilePicker.PickMultipleAsync();
        if (results != null)
        {
            var selectedFilePaths = new List<string>();
            foreach (var file in results)
            {
                // Add file full path to the list one by one
                selectedFilePaths.Add(file.FullPath);
            }
            CreateZip(selectedFilePaths);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

private async void OnSelectFilesButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select multiple files of any type
        var results = await FilePicker.PickMultipleAsync();
        if (results != null)
        {
            var selectedFilePaths = new List<string>();
            foreach (var file in results)
            {
                // Add file full path to the list one by one
                selectedFilePaths.Add(file.FullPath);
            }
            CreateZip(selectedFilePaths);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

Private Async Sub OnSelectFilesButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
	Try
		Dim status = Await Permissions.RequestAsync(Of Permissions.StorageRead)()
		If status <> PermissionStatus.Granted Then
			Await DisplayAlert("Alert!", "Storage Access Denied", "Ok")
			Return
		End If
		' Select multiple files of any type
		Dim results = Await FilePicker.PickMultipleAsync()
		If results IsNot Nothing Then
			Dim selectedFilePaths = New List(Of String)()
			For Each file In results
				' Add file full path to the list one by one
				selectedFilePaths.Add(file.FullPath)
			Next file
			CreateZip(selectedFilePaths)
		End If
	Catch ex As Exception
		Console.WriteLine($"Error: {ex.Message}")
	End Try
End Sub

Private Async Sub OnSelectFilesButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
	Try
		Dim status = Await Permissions.RequestAsync(Of Permissions.StorageRead)()
		If status <> PermissionStatus.Granted Then
			Await DisplayAlert("Alert!", "Storage Access Denied", "Ok")
			Return
		End If
		' Select multiple files of any type
		Dim results = Await FilePicker.PickMultipleAsync()
		If results IsNot Nothing Then
			Dim selectedFilePaths = New List(Of String)()
			For Each file In results
				' Add file full path to the list one by one
				selectedFilePaths.Add(file.FullPath)
			Next file
			CreateZip(selectedFilePaths)
		End If
	Catch ex As Exception
		Console.WriteLine($"Error: {ex.Message}")
	End Try
End Sub

Sonrasında, CreateZip metodunu uygulayın. IronZIP'in IronArchive sınıfı, zip dosyasının oluşturulacağı yeri alır. Seçilen dosya yollarının her birinde döngü kullanarak, Add metodu tarafından zip dosyasına eklenirler.

Dosyalar eklendikten sonra, DisplayAlert kullanarak bir onay mesajı görüntülenir.

private async void CreateZip(List<string> selectedFilePaths)
{
    var path = "E:\\output.zip";
    // Create a Zip
    using (var archive = new IronArchive(path))
    {
        // Add files to the ZIP
        foreach (var file in selectedFilePaths)
        {
            archive.Add(file);
        }
    }
    await DisplayAlert("Congratulations", "All files added to " + path, "Ok");
}

private async void CreateZip(List<string> selectedFilePaths)
{
    var path = "E:\\output.zip";
    // Create a Zip
    using (var archive = new IronArchive(path))
    {
        // Add files to the ZIP
        foreach (var file in selectedFilePaths)
        {
            archive.Add(file);
        }
    }
    await DisplayAlert("Congratulations", "All files added to " + path, "Ok");
}

Private Async Sub CreateZip(ByVal selectedFilePaths As List(Of String))
	Dim path = "E:\output.zip"
	' Create a Zip
	Using archive = New IronArchive(path)
		' Add files to the ZIP
		For Each file In selectedFilePaths
			archive.Add(file)
		Next file
	End Using
	Await DisplayAlert("Congratulations", "All files added to " & path, "Ok")
End Sub

Private Async Sub CreateZip(ByVal selectedFilePaths As List(Of String))
	Dim path = "E:\output.zip"
	' Create a Zip
	Using archive = New IronArchive(path)
		' Add files to the ZIP
		For Each file In selectedFilePaths
			archive.Add(file)
		Next file
	End Using
	Await DisplayAlert("Congratulations", "All files added to " & path, "Ok")
End Sub

Mevcut zip dosyasına dosya oluşturma, ekleme ve bir zip'i çıkartma hakkında daha ayrıntılı bilgi için, lütfen bu kılavuz sayfasını ziyaret edin.

2. Zip'i Çıkar

Şimdi, "Extract Zip" işlevini oluşturacağız. Tekrar, MainPage.xaml.cs dosyasında, OnSelectFileButtonClicked metodunu, bir zip dosyasını çıkarmak için tek bir zip dosyası seçmeye izin verecek şekilde FilePicker'ı açan hale getirin.

Seçilen dosyanın tam yolu bir dize değişkenine atanır ve IronZIP'in çıkartmayı gerçekleştirdiği ExtractZip metoduna gönderilir. Kod şöyle devam ediyor:

private async void OnSelectFileButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select a single file of any type
        var result = await FilePicker.PickAsync();
        if (result != null)
        {
            // Add File Full Path to the list one by one
            var selectedFile = result.FullPath;
            ExtractZip(selectedFile);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

private async void OnSelectFileButtonClicked(object sender, EventArgs e)
{
    try
    {
        var status = await Permissions.RequestAsync<Permissions.StorageRead>();
        if (status != PermissionStatus.Granted)
        {
            await DisplayAlert("Alert!", "Storage Access Denied", "Ok");
            return;
        }
        // Select a single file of any type
        var result = await FilePicker.PickAsync();
        if (result != null)
        {
            // Add File Full Path to the list one by one
            var selectedFile = result.FullPath;
            ExtractZip(selectedFile);
        }
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

Private Async Sub OnSelectFileButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
	Try
		Dim status = Await Permissions.RequestAsync(Of Permissions.StorageRead)()
		If status <> PermissionStatus.Granted Then
			Await DisplayAlert("Alert!", "Storage Access Denied", "Ok")
			Return
		End If
		' Select a single file of any type
		Dim result = Await FilePicker.PickAsync()
		If result IsNot Nothing Then
			' Add File Full Path to the list one by one
			Dim selectedFile = result.FullPath
			ExtractZip(selectedFile)
		End If
	Catch ex As Exception
		Console.WriteLine($"Error: {ex.Message}")
	End Try
End Sub

Private Async Sub OnSelectFileButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
	Try
		Dim status = Await Permissions.RequestAsync(Of Permissions.StorageRead)()
		If status <> PermissionStatus.Granted Then
			Await DisplayAlert("Alert!", "Storage Access Denied", "Ok")
			Return
		End If
		' Select a single file of any type
		Dim result = Await FilePicker.PickAsync()
		If result IsNot Nothing Then
			' Add File Full Path to the list one by one
			Dim selectedFile = result.FullPath
			ExtractZip(selectedFile)
		End If
	Catch ex As Exception
		Console.WriteLine($"Error: {ex.Message}")
	End Try
End Sub

Sonra, ExtractZip metodunu oluşturun. Bu metodda, dosyaları çıkartmak istediğiniz hedef klasöre yolu ayarlayın.

IronZIP'in ExtractArchiveToDirectory metodunu kullanarak, seçilen dosya yolunu ve çıkış yolu verin. Bu metod, ziptaki tüm dosyaları sorunsuz bir şekilde dönüşüm ve transfer için çıkış klasörüne taşır. Son olarak, başarılı bir çıkartmada bir onay mesajı gösterilir.

Kod şöyle devam ediyor:

private async void ExtractZip(string selectedFilePath)
{
    var path = "E:\\Extracted Files";
    IronArchive.ExtractArchiveToDirectory(selectedFilePath, path);
    await DisplayAlert("Congratulations", "All files extracted to " + path, "Ok");
}

private async void ExtractZip(string selectedFilePath)
{
    var path = "E:\\Extracted Files";
    IronArchive.ExtractArchiveToDirectory(selectedFilePath, path);
    await DisplayAlert("Congratulations", "All files extracted to " + path, "Ok");
}

Private Async Sub ExtractZip(ByVal selectedFilePath As String)
	Dim path = "E:\Extracted Files"
	IronArchive.ExtractArchiveToDirectory(selectedFilePath, path)
	Await DisplayAlert("Congratulations", "All files extracted to " & path, "Ok")
End Sub

Private Async Sub ExtractZip(ByVal selectedFilePath As String)
	Dim path = "E:\Extracted Files"
	IronArchive.ExtractArchiveToDirectory(selectedFilePath, path)
	Await DisplayAlert("Congratulations", "All files extracted to " & path, "Ok")
End Sub

Adım 3: Uygulamayı Çalıştırın

IronZIP ile birlikte kodu başarıyla entegre ettikten sonra, veri çıkarma görevlerini gerçekleştirmek için uygulamayı derleyip çalıştırın. Bir zip dosyası oluşturup bir zip dosyasından dosyaları çıkararak işlevselliği test edin.

Belirlenen dizinlerdeki çıktı ve çıkartılan dosyaları kontrol ederek sonuçları doğrulayın.

Adım 4: Sonuçları Doğrulayın

1. Zip Oluşturma Testi

Öncelikle bir zip dosyası oluşturmayı deneyelim. Create Zip düğmesine tıklayın ve size bir dosya iletişim kutusu sunacaktır. Birden fazla veya tek bir dosya seçerek zipe ekleyebilirsiniz.

Aç'ı tıklayın ve dosyaların başarıyla output.zip'e eklendiğini bildiren bir onay mesajı belirecektir.

Output.zip dosyasına gidip içeriğine bakarsak, eklediğimiz tüm dosyaları göreceğiz.

2. Zip Çıkarma Testi

Şimdi bir zip dosyasını çıkartalım. Extract Zip düğmesine tıklayın ve bir File dialog görünecektir. Çıkarmak istediğiniz zip dosyasını seçin ve aç'ı tıklayın.

Zip dosyasından veri alınması ve istenen klasöre çıkarılması tamamlandığında onay mesajı gösterilir.

Şimdi "Çıkartılmış Dosyalar" klasörüne gidin, ZIP'ten seçtiğimiz dosyaların çıkarıldığını göreceksiniz.

Sonuç

Sonuç olarak, IronZIP'in .NET MAUI ile entegrasyonu, çapraz platform uygulamalarda arşivler oluşturma, okuma ve çıkarma için güçlü bir çözüm sunar.

Verilen örnek, IronZIP ile birden fazla dosyayı seçme, bir zip arşivi oluşturma ve .NET MAUI içinde bir zip arşivinden dosya çıkarma işlemlerinin nasıl yapıldığını göstermektedir.

Bu teknoloji kombinasyonu, çeşitli platformlarda arşivleri yönetme ve manipüle etme konusunda geliştiricilere sorunsuz bir deneyim sunar.

Daha detaylı bilgi ve kod örnekleri için lütfen bu belge sayfasını ziyaret edin.

IronZIP, bir ücretsiz deneme sunmaktadır. Kütüphaneyi buradan indirip deneyebilirsiniz.