.NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) Topluluk Araç Seti ile Çalışmaya Başlama

Bu makale, .NET MAUI Community Toolkit projesi kapsamında sağlanan paketleri kullanmaya başlamayı kapsar.

NuGet paketlerini ekleme

Araç seti, Visual Studio kullanılarak mevcut veya yeni herhangi bir projeye eklenebilen bir dizi NuGet paketi olarak kullanılabilir.

1. Var olan bir projeyi açma veya .NET MAUI kurulum belgelerine göre yeni bir proje oluşturma

2. Çözüm Gezgini panelinde proje adınıza sağ tıklayın ve NuGet Paketlerini Yönet'i seçin. CommunityToolkit.Maui için arama yapın ve listeden istediğiniz NuGet Paketini seçin.

   

3. Aşağıdaki seçeneklerden ihtiyaçlarınıza en uygun araç setlerini seçin:

CommunityToolkit.Maui

Bu paket .NET MAUI ile geliştirme için Animasyonlar, Davranışlar, Dönüştürücüler ve Özel Görünümler koleksiyonudur. .NET MAUI ile iOS, Android, macOS ve Windows uygulamaları oluşturan yaygın geliştirici görevlerini basitleştirir ve gösterir.

Paket adı:CommunityToolkit.Maui

Paket url'si:https://www.nuget.org/packages/CommunityToolkit.Maui

Paketi başlatma

İlk olarak using deyiminin MauiProgram.cs dosyanızın en üstüne eklenmesi gerekir

using CommunityToolkit.Maui;

Araç setini doğru UseMauiCommunityToolkit kullanabilmek için, bir uygulama MauiProgram.cs dosyasını önyüklerken yönteminin MauiAppBuildersınıfta çağrılması gerekir. Aşağıdaki örnekte bunun nasıl gerçekleştirebileceğiniz gösterilmektedir.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkit()

Araç setinin özelliklerini kullanmak için lütfen belirli özelliklerin belge sayfalarına bakın.

CommunityToolkit.Maui.Markup

Bu paket, C# dilinde bildirim temelli .NET MAUI kullanıcı arabirimleri oluşturmayı basitleştirmek için bir dizi akıcı yardımcı yöntem ve sınıftır.

Paket adı:CommunityToolkit.Maui.Markup

Paket url'si:https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Paketi başlatma

İlk olarak using deyiminin MauiProgram.cs dosyanızın en üstüne eklenmesi gerekir

using CommunityToolkit.Maui.Markup;

Araç setini doğru UseMauiCommunityToolkitMarkup kullanabilmek için, bir uygulama MauiProgram.cs dosyasını önyüklerken yönteminin MauiAppBuildersınıfta çağrılması gerekir. Aşağıdaki örnekte bunun nasıl gerçekleştirebileceğiniz gösterilmektedir.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMarkup()

Araç setinin özelliklerini kullanmak için lütfen belirli özelliklerin belge sayfalarına bakın.

CommunityToolkit.Maui. Haritalar

Bu paket, .NET MAUI Windows uygulamanızda bir harita görüntülemenizi sağlar.

Paket adı:CommunityToolkit.Maui.Maps

Paket url'si:https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Paketi başlatma

İlk olarak using deyiminin MauiProgram.cs dosyanızın en üstüne eklenmesi gerekir

using CommunityToolkit.Maui.Maps;

Yönteminin doğru şekilde .UseMauiCommunityToolkitMaps kullanılabilmesi için, MauiProgram.cs dosyasının bir uygulamaya önyüklemesi sırasında sınıfında çağrılmalıdırMauiAppBuilder.Map Bu yöntem, Bing Haritalar Portalı aracılığıyla edinebileceğiniz geçerli bir Bing Haritalar API anahtarı bekler.

Aşağıdaki örnekte bunun nasıl gerçekleştirebileceğiniz gösterilmektedir.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")

Windows için .NET MAUI Topluluk Araç Seti Haritası ile normal .NET MAUI Haritalar birlikte kullanırken, her başlatma çağrısının yalnızca ilgili platform için yapıldığından emin olmanız gerekir. Aşağıdaki örnekte bunun nasıl yapıldığını gösterilmektedir.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
#if ANDROID || IOS
    .UseMauiMaps()
#elif WINDOWS
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
#endif

iOS ve Android'de haritayı başlatma ve harita denetimi API'siyle çalışma hakkında daha fazla bilgi için .NET MAUI Haritalar belgelerine bakın.

CommunityToolkit.Maui.MediaElement

Bu paket, .NET MAUI uygulamanızda ses ve video oynatmanızı sağlar.

Paket adı:CommunityToolkit.Maui.MediaElement

Paket url'si:https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Paketi başlatma

İlk olarak using deyiminin MauiProgram.cs dosyanızın en üstüne eklenmesi gerekir

using CommunityToolkit.Maui;

Yönteminin doğru şekilde UseMauiCommunityToolkitMediaElement kullanılabilmesi için, MauiProgram.cs dosyasının bir uygulamaya önyüklemesi sırasında sınıfında çağrılmalıdırMauiAppBuilder.MediaElement Aşağıdaki örnekte bunun nasıl gerçekleştirebileceğiniz gösterilmektedir.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMediaElement()

Araç setinin özelliklerini kullanmak için lütfen belirli özelliklerin belge sayfalarına bakın.

NuGet paketlerini kullanma

4. araç setini içinde MauiProgram.csetkinleştirme:

var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
builder.UseMauiCommunityToolkit();

4.1. Gelişmiş ayarlar için CommunityToolkit.Maui.Options'ı ayarlayın:

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});

5. Belirli özellikleri uygulama hakkında daha fazla bilgi edinmek için diğer belgelere göz atın.

Diğer kaynaklar

.NET MAUI Community Toolkit GitHub Deposu, .NET MAUI uygulaması oluşturmak için araç setini nasıl kullanabileceğinizi göstermek üzere tasarlanmış örnek bir uygulamanın kaynak kodunu içerir. Örnek uygulamayı çalıştırmak için depoyu kopyalamanız veya indirmeniz ve kaynak kodu derlemeniz gerekeceğini lütfen unutmayın.

.NET MAUI'de yeni olan geliştiricilerin .NET MAUI belgelerini ziyaret etmelerini öneririz.

Geçerli kaynak kodunu, sırada neler olduğunu görmek ve depoyu kopyalamak için .NET MAUI Community Toolkit GitHub Deposu'nu ziyaret edin. Topluluk katkıları memnuniyetle karşılanır!