Öğretici: XAML ve C ile Visual Studio'da ilk Windows Uygulama SDK uygulamanızı oluşturma#
Visual Studio tümleşik geliştirme ortamına (IDE) bu girişte, herhangi bir Windows 10 veya üzeri cihazda çalışan bir "Merhaba Dünya" uygulaması oluşturacaksınız. Bunu yapmak için bir Windows Uygulama SDK'sı (WinUI 3) proje şablonu, Genişletilebilir Uygulama Biçimlendirme Dili (XAML) ve C# programlama dili kullanacaksınız.
Not
WinUI 3, Windows Uygulama SDK'sı (Windows SDK'larından tamamen ayrılmış) ile birlikte gelen yerel ui platformu bileşenidir. Daha fazla bilgi için bkz . WinUI 3.
Visual Studio'yu henüz yüklemediyseniz Visual Studio indirmeleri sayfasına giderek ücretsiz yükleyin.
Bir proje oluştur
İlk olarak bir WinUI 3 projesi oluşturun. Proje türü, herhangi bir şey eklemeden önce ihtiyacınız olan tüm şablon dosyalarıyla birlikte gelir!
Önemli
Visual Studio 2019 yalnızca Windows Uygulama SDK 1.1 ve önceki sürümleri destekler. Windows Uygulama SDK'sının tüm sürümleriyle uygulama geliştirmek için Visual Studio 2022 önerilir.
Windows Uygulama SDK'sı 1.1.x şablonları visual studio uzantısı (VSIX) yüklenerek kullanılabilir.
Not
Windows Uygulama SDK'sı Visual Studio uzantısı (VSIX) zaten yüklüyse, başka bir sürümü yüklemeden önce bu uzantıyı kaldırın. Yönergeler için bkz . Visual Studio için uzantıları yönetme.
- Visual Studio'dan en son kararlı 1.1.x sürümü VSIX'i yükleyebilirsiniz. Uzantılar>Uzantıları Yönet'i seçin, Windows Uygulama SDK'sını arayın ve Windows Uygulama SDK'sı uzantısını indirin. Visual Studio'yu kapatıp yeniden açın ve uzantıyı yüklemek için istemleri izleyin. Windows Uygulama SDK'sı 1.1 için şablonları yüklediğinizden emin olun.
- Alternatif olarak, uzantıyı doğrudan Visual Studio Market'ten indirebilir ve yükleyebilirsiniz:
Şablonlar uzantısı yüklendikten sonra ilk projenizi oluşturabilirsiniz. Visual Studio 2019 desteği hakkında daha fazla bilgi için bkz . Windows Uygulama SDK'sı için araçları yükleme. Bu öğreticinin geri kalanında Visual Studio 2022 kullandığınız varsayılır.
Visual Studio'yu açın ve başlangıç penceresinde Yeni proje oluştur'u seçin.
Yeni proje oluştur ekranında, arama kutusuna WinUI yazın, Boş Uygulama, Paketlenmiş (Masaüstünde WinUI 3) için C# şablonunu seçin ve ardından İleri'yi seçin.
Not
Boş Uygulama, Paketlenmiş (Masaüstünde WinUI 3) proje şablonunu görmüyorsanız Daha fazla araç ve özellik yükle bağlantısına tıklayın.
Visual Studio Yükleyicisi başlatılır. .NET Masaüstü Geliştirme iş yükünü seçin, ardından yükleme iletişim kutusunun Yükleme ayrıntıları bölmesinde Windows Uygulama SDK'sı C# Şablonları'nı (listenin en altında) seçin. Şimdi Değiştir'i seçin.
Projeye HelloWorld adını verin ve Oluştur'u seçin.
Not
Windows Uygulama SDK'sı uygulaması oluşturmak için Visual Studio'yu ilk kez kullanıyorsanız, bir Ayarlar iletişim kutusu görüntülenebilir. Geliştirici modu'nu ve ardından Evet'i seçin.
Visual Studio sizin için ek bir Geliştirici Modu paketi yükler. Paket yüklemesi tamamlandığında Ayarlar iletişim kutusunu kapatın.
Uygulamayı oluşturma
Geliştirmeye başlamanın zamanı geldi. Düğme denetimi ekleyeceksiniz, düğmeye bir eylem ekleyeceksiniz ve ardından nasıl göründüğünü görmek için "Merhaba Dünya" uygulamasını çalıştıracaksınız.
Tasarım tuvaline düğme ekleme
Çözüm Gezgini MainWindow.xaml'e çift tıklayarak XAML işaretleme düzenleyicisini açın.
XAML Düzenleyicisi, işaretleme ekleyebileceğiniz veya değiştirebileceğiniz yerdir. UWP projelerinin aksine WinUI 3'de Tasarım görünümü yoktur.
Pencerenin kökündeki StackPanel içinde iç içe yerleştirilmiş Düğme denetimini gözden geçirin.
Düğmedeki etiketi değiştirme
XAML Düzenleyicisi'nde Düğme İçeriği değerini "Bana tıklayın" yerine "Merhaba Dünya!" olarak değiştirin.
Düğmenin myButton_Click adlı bir Click olay işleyicisi de belirtildiğine dikkat edin. Sonraki adımda bu adıma geçeceğiz.
Olay işleyicisini değiştirme
"Olay işleyicisi" karmaşık görünebilir, ancak bir olay gerçekleştiğinde çağrılan kod için başka bir addır. Bu durumda, "Merhaba Dünya!" düğmesi tarafından tetiklenen bir eylem ekler.
Çözüm Gezgini'da mainWindow.xaml.cs dosyasına çift tıklayın( arka planda kod sayfası).
Açılan C# düzenleyicisi penceresinde olay işleyici kodunu düzenleyin.
burada işler ilginçleşiyor. Varsayılan olay işleyicisi şöyle görünür:
Şunun gibi görünmesi için değiştirelim:
Kopyalayıp yapıştırmak için gereken kod şu şekildedir:
private async void myButton_Click(object sender, RoutedEventArgs e) { var welcomeDialog = new ContentDialog() { Title = "Hello from HelloWorld", Content = "Welcome to your first Windows App SDK app.", CloseButtonText = "Ok", XamlRoot = myButton.XamlRoot }; await welcomeDialog.ShowAsync(); }
Az önce ne yaptık?
Kod, geçerli pencere içindeki kalıcı bir açılan denetimde karşılama iletisi görüntülemek için ContentDialog denetimini kullanır. (kullanma Microsoft.UI.Xaml.Controls.ContentDialog
hakkında daha fazla bilgi için bkz . ContentDialog Sınıfı.)
Uygulamayı çalıştırma
Nasıl göründüğünü görmek için "Merhaba Dünya" Windows Uygulama SDK'sı uygulamasını oluşturmanın, dağıtmanın ve başlatmanın zamanı geldi. Bunu nasıl yapacağınızı buradan öğrenebilirsiniz.
Uygulamayı yerel makinede başlatmak için Yürüt düğmesini (HelloWorld (Paket) metnini içeriyor) kullanın.
(Alternatif olarak,Menü çubuğundan Hata Ayıklamayı Başlat'ta hata ayıklayın>veya uygulamanızı başlatmak için F5 tuşuna basın.)
Bir giriş ekranı kaybolduktan hemen sonra görünen uygulamanızı görüntüleyin. Uygulama şu görüntüye benzer görünmelidir:
Merhaba Dünya düğmesini seçin.
Windows 10 veya üzeri cihazınızda "HelloWorld'den Merhaba" başlığıyla "İlk Windows Uygulama SDK uygulamanıza hoş geldiniz" yazan bir ileti görüntülenir. İletiyi kapatmak için Tamam'a tıklayın.
Uygulamayı kapatmak için araç çubuğunda Hata Ayıklamayı Durdur düğmesini seçin. (Alternatif olarak,Hata ayıklama>Menü çubuğundan hata ayıklamayı durdurun veya Shift+F5 tuşlarına basın.)
Sonraki adımlar
Bu öğreticiyi tamamladıktan sonra tebrikler! Windows Uygulama SDK'sı, WinUI 3 ve Visual Studio IDE hakkında bazı temel bilgileri öğrendiğinizi umuyoruz. Daha fazla bilgi edinmek için aşağıdaki öğreticiyle devam edin: