WinUI 3 ile geliştirmeye hazırlanma
Çalışma ortamı
- Windows
-
- pencereler 11
- Görsel Stüdyo
-
- Visual Studio 2022 sürüm 17.9.3
- .NET
-
- .NET 6
- (.NET 8)
- WinUI (Kullanıcı Arayüzü)
-
- WinUI 3 (İngilizce)
- Windows Uygulama SDK'sı
-
- 1.4.230913002
Önkoşullar
Bazı durumlarda, daha düşük sürümler de işe yarayabilir.
- Windows
-
- pencereler 10
- pencereler 11
- Görsel Stüdyo
-
- Visual Studio 2022 sürüm 17.9.3 veya üzeri
- .NET
-
- .NET 6
- (.NET 8)
- Windows Uygulama SDK'sı
-
- 1.4.230913002 veya üzeri
Visual Studio'yu yükleyin ve WinUI'yi ayarlayın
Visual Studio kurulumu ile WinUI 3 geliştirme projeleri eklenebilir. Bu bölüm, Visual Studio yükleme işleminin basitleştirilmiş bir açıklamasını sağlar. Ayrıntılı talimatlar için lütfen aşağıdaki İpuçlarına bakın.
Visual Studio 2022 yükleyicisini İnternet'ten veya medyadan başlatın. Community, Professional veya daha yüksek sürümleri destekler.
İş yükü seçiminde öğesini seçin. NET Masaüstü Geliştirme.
「. NET Masaüstü Geliştirme'ye gidin ve sağdaki Yükleme Ayrıntıları'ndan Windows Uygulama SDK'sı C# Şablonları'nı kontrol edin.
Şimdi sadece kurulumu başlatın. Başka ekranlar da var ama onlar bir proje oluşturana kadar onları anlatmayacağım.
Yükleme tamamlandıktan sonra yeni bir proje oluşturun.
Sağ üstteki arama öğesinde winui bir öğe vardır, bu nedenle onu seçtiğinizde WinUI 3 proje şablonu görüntülenecektir, bu nedenle herhangi bir şablonu seçin ve bir proje oluşturun.
Artık WinUI 3 kullanarak uygulama geliştirebilirsiniz.
"Yüklü olmayan bir .NET sürümü hedefleniyor" mesajını görüyorsanız
Visual Studio 2022 sürümünden 17.9.1 itibaren WinUI 3 için .NET, .NET 6'yı hedefler.
Visual Studio 2022'de herhangi bir ek çalışma zamanı seçmezseniz yalnızca .NET 8 çalışma zamanı yüklenir ve aşağıdaki gibi bir uyarı görebilirsiniz.
Endişeleniyorsanız .NET 6 çalışma zamanını yükleyebilir veya yalnızca uyarıyı kapatabilirsiniz. Hata ayıklamak için .NET 6 çalışma zamanını yüklemeniz gerekmez.
Daha sonra bir WinUI 3 geliştirme ortamı eklemek isterseniz
Önce Visual Studio'yu yüklerseniz, daha sonra bir WinUI 3 geliştirme ortamı ekleyebilirsiniz.
Visual Studio'yu başlatın ve menüden Araçlar > Araçları ve Özellikleri Al'ı seçin.
Visual Studio'yu yüklediğiniz zamankiyle aynı ekran görüntülenir, böylece . ".NET Desktop Development" seçeneğinin işaretli olduğundan emin olun ve sağdaki "Installation Details" (Kurulum Ayrıntıları) kısmından "Windows App SDK C# Template" seçeneğini işaretleyiniz.
Geliştirici modunu etkinleştir
WinUI uygulamaları, diğer masaüstü uygulamalarından farklı olarak güvenliği artırılmış bir ortamda çalışır. Bu nedenle, olduğu gibi çalıştırılamaz. Çalıştırmaya çalıştığınızda, aşağıdaki gibi bir iletişim kutusu göreceksiniz ve "Geliştirici Modu" nu etkinleştirmeniz istenecektir. Bağlantıya tıklarsanız, ayar ekranı görüntülenecektir, bu nedenle lütfen "Geliştirici Modu"nu etkinleştirin.
Visual Studio kullanmıyor olsanız bile, ayarlar ekranından "Geliştirici Modu"nu etkinleştirebilir veya devre dışı bırakabilirsiniz. Başlat menüsünden "Ayarlar" ı seçin.
Sistem menüsünden, Geliştiriciler İçin'i seçin.
"Geliştiriciler için" için bir geçiş var, bu yüzden "Açık" olarak ayarlayın. Bir not görüntülenecektir, bu nedenle etkinleştirmek için "Evet"i seçin.
.NET 8'e geçmek istiyorsanız
Bu şablonla bir proje oluşturursanız, varsayılan olarak .NET 6 olur. Proje özelliklerinden hedef çerçeveyi .NET 8 olarak değiştirsem bile, derleme yine de hataları ve uyarıları gösteriyor. Ancak, 13.03.2024 civarında, Windows Uygulama SDK'sı .NET 8'i resmi olarak destekleyecek şekilde güncelleştirilecektir.
Ancak, şablon hala .NET 6'dadır, bu nedenle projeyi oluşturduktan sonra .NET 8 üzerinde çalışmanız gerekir. Gelecekteki sürüm yükseltmelerinde desteklenme olasılığı olabilir.
İlk olarak bir proje oluşturun ve ardından NuGet'i kullanarak Windows Uygulama SDK'sı ile ilgili sürümleri güncelleştirin.
Aksi takdirde, her şey günceldir. Microsoft.WindowsAppSDK en az 1.5.XXXX olmalıdır.
Proje özelliklerinden hedef çerçeveyi .NET 8 olarak değiştirin.
Bu durumda derleme yapsanız bile, proje ayarları güncel olmadığı için bir hata görüntülenir.
Proje dosyasını kod olarak açın.
RuntimeIdentifiersBir parametre olduğu için, karakterini 10 aşağıdaki Win10 gibi kaldırın.
Değişiklikten Önce
<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
↓
Düzeltmeden sonra
<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
Ayrıca programın yayımlama ayarlarını da yeniden yazar.
Özellikler > PublishProfiles klasöründeki her .pubxml dosyayı açın.
RuntimeIdentifier Benzer şekilde, parametresindeki 'nin 10 karakterini Win10 kaldırın.
Bundan sonra, yeniden oluşturun ve herhangi bir hata veya uyarı olmadığını doğrulayın.
.pubxml (Dosyada bir uyarı olacaktır, ancak bu sorundan farklı bir sözdizimi olduğu için endişelenmenize gerek yoktur.) )
Ancak, bazı nedenlerden dolayı, WinUI sınıf kitaplığı, yukarıdakinin aynısını yapsanız bile uyarmaya devam eder. Şimdilik çalıştırabilirsiniz, bu yüzden bu düzeltilene kadar bekleyelim.