Windows Community Toolkit Gallery, Windows uygulaması geliştiren kişilerin kontrol, yardımcı araç ve örnek kodları etkileşimli olarak incelemesini sağlayan bir gösterim uygulamasıdır. Bu ürün genel amaçlı bir bilgisayar temizleyicisi ya da son kullanıcıya yönelik ofis programı değildir. Temel değeri; farklı arayüz bileşenlerinin görünümünü, kullanım örneklerini ve geliştirici seçeneklerini bir arada göstermesidir. Güncel kaynak koduna ve Microsoft Store bağlantısına proje deposundan ulaşılabilir.
İçindekiler
Gallery ile Toolkit arasındaki fark
Windows Community Toolkit birden fazla yardımcı kitaplık ve kontrol içeren geliştirici ekosistemidir; Gallery ise bu bileşenleri gösteren örnek uygulamadır. Galeriyi kurmak, bütün proje bağımlılıklarını bir uygulamaya otomatik eklemez. Gerçek uygulamanızda kullanmak istediğiniz kontrol için ilgili NuGet paketi, hedef framework ve sürüm notları ayrıca incelenmelidir.
Doğru resmî sürüme ulaşma
Geliştirici projesinin güncel GitHub deposu, örnek uygulamanın Microsoft Store sayfasına ve belgelere bağlantı verir. Arşivlenmiş eski Windows Community Toolkit depoları güncel dalı temsil etmeyebilir; özellikle 8.x sonrası mimari değişikliklerde yeni depo kullanılır. Uygulamayı kurmadan önce Windows ve geliştirme ortamı gereksinimlerini kontrol edin.
Kontrolleri uygulamada inceleme
Önce ilgilendiğiniz kullanıcı arayüzü davranışını belirleyin: gezinme, kart yerleşimi, giriş doğrulama, görüntüleme veya etkileşim. Gallery içinde örnekleri çalıştırın; yalnız ekran görüntüsüne bakmak yerine klavye ve dar pencere genişliği gibi durumları da deneyin. Daha sonra örneğin kaynak kodunu ve ilgili API belgelerini proje bağlamınızda doğrulayın.
WinUI Gallery ile karıştırmayın
Microsoft’un WinUI 3 Gallery adlı farklı bir örnek uygulaması da bulunur. İki uygulama Windows geliştirme ekosistemine hizmet etse de aynı ürün değildir. Sayfanın başlığını ve geliştirici bağlantısını kontrol ederek aradığınızın Windows Community Toolkit Gallery olduğundan emin olun. Bağımlılıkları doğrudan uygulamadan kopyalamak yerine güncel dökümantasyonu kullanın.
Yeni başlayanlar için deneme önerisi
Windows Community Toolkit Gallery ile çalışmaya başlarken bir örneği doğrudan üretim uygulamasına kopyalamak yerine ayrı bir deneme projesi açın. Önce örneğin hedeflediği WinUI sürümünü ve gerekli paketleri kontrol edin. Ardından kontrolü küçük pencerede, klavye kullanarak ve farklı ölçeklendirme ayarlarında sınayın. Bu yaklaşım, görünüşü başarılı bir bileşenin erişilebilirlik veya uyumluluk sorunlarını daha erken fark etmenizi sağlar. Özellikle büyük sürüm geçişlerinde güncel depo dokümantasyonuna ve paket notlarına geri dönmek gereklidir.
Windows Community Toolkit Gallery kimler içindir?
Galeri temel olarak Windows uygulaması geliştirenlerin yararlanması için sunulur. Bir uygulamada hangi arayüz bileşeninin uygun olacağını görmek, kontrol örnekleri üzerinde deneme yapmak ve kaynak kodu incelemek isteyenlere hitap eder. Normal bir kullanıcı bu uygulamayı Windows'u hızlandırmak için yüklemek zorunda değildir. Aracın bir örnek galerisi olduğunu bilmek doğru beklentiyi oluşturur.
WinUI 3 Gallery aynı uygulama mı?
Hayır. WinUI 3 Gallery ve Windows Community Toolkit Gallery ilişkili geliştirme ekosistemlerinin farklı örnek uygulamalarıdır. Her ikisi de arayüz bileşenlerini göstermeye yardımcı olabilir ama sahip oldukları örnekler ve bağlandıkları proje depoları aynı olmak zorunda değildir. Özellikle indirme sırasında uygulamanın tam adını kontrol edin; eski arşivlenmiş depoların güncel sürüm yerine kullanılmadığından emin olun.
Örnek projeyi üretim koduna taşırken
Gallery içinde güzel görünen bir kontrolü kendi uygulamanızda kullanmadan önce desteklediği çerçeveyi ve paket sürümünü doğrulayın. Klavye ile kullanım, ekran okuyucu etiketleri, yüksek kontrast, çok dilli metin uzunlukları ve küçük pencere boyutları gibi koşulları gerçek projede ayrıca sınayın. Bir örnek çalışıyor olsa bile güvenlik, erişilebilirlik ve bakım sorumluluğu uygulama geliştiricisine aittir. Kararlı API ile deneysel özellikleri karıştırmamak için resmî dökümantasyonu izleyin.
Pratik kontrol listesi
- Güncel CommunityToolkit/Windows deposunu esas alın.
- Örnek uygulamayla NuGet paketini birbirine karıştırmayın.
- Geliştirilen ürünün erişilebilirlik ve sürüm testlerini ayrıca yapın.
