İlk WinUI uygulamanızı oluşturma

İlk WinUI uygulamanızı oluşturun ve Windows hayata geçirildi. Bu hızlı başlangıç sizi araç kurulumundan çalışan bir uygulamaya götürür ve ardından ilk arabirim güncelleştirmenizde size yol gösterir.

Başlamadan önce

Ne öğreneceksiniz?

  • Geliştirme araçlarınızı seçin ve ayarlayın.
  • WinUI uygulaması oluşturun ve çalıştırın.
  • Arabirimi güncelleştirin ve çalışan uygulamada değişikliğinizi görün.

Geliştirme araçlarınızı seçin

Bu hızlı başlangıçta önerilen yollardan birini izleyin:

  • winapp CLI: Tercih ettiğiniz düzenleyicide terminal üzerinden çalışın. Bu komut satırı iş akışı, ajan tabanlı kodlama için de gayet iyi çalışır.
  • Visual Studio: Tümleşik geliştirme ve hata ayıklama ortamını kullanın.

Araçlarınız zaten yüklüyse, İlk uygulamanızı oluşturma bölümüne gidin.

Araçları yükleme

  1. Geliştirici Modu'nu etkinleştirin. Geliştirici ayarları ile ayarlarını açabilirsiniz.

  2. .NET 10 SDK'sını ve Windows Uygulaması Geliştirme CLI'sını yükleyin. WinGet kullanıyorsanız şunu çalıştırın:

    winget install --id Microsoft.DotNet.SDK.10 --exact --source winget
winget install --id Microsoft.WinAppCli --exact --source winget

    Gerekli araç zaten yüklüyse yüklemeyi atlayın.

  3. Yüklü komutları algılaması için yeni bir terminal açın, ardından sürümleri kontrol edin:

    dotnet --version
winapp --version

    Bu iş akışı için .NET SDK 10 veya sonraki bir sürümünü ve winapp CLI 0.6 veya sonraki bir sürümünü kullanın.

Note

winapp CLI genel kullanıma açık önizlemededir. winapp new WinUI proje şablonlarını yönetir, ancak .NET SDK'sını yüklemez. Yeni proje ve çalıştırma komutları için CLI 0.6 duyurusunu inceleyin.

İlk uygulamanızı oluşturun

Projeyi oluşturmak ve başlatmak için yukarıda yüklediğiniz iş akışını kullanın.

Projelerinizi tuttuğunuz bir klasörden şunu çalıştırın:

winapp new --name MyWinUIApp --template winui --use-defaults
cd MyWinUIApp
winapp run

winapp new boş WinUI uygulamasını oluşturur. winapp run projeyi derler ve başlatır; ayrı bir derleme veya paket kaydetme komutuna ihtiyacınız yoktur.

Başka bir başlangıç şablonu seçmek, kilitlenme hatalarını ayıklamak, kullanıcı arabirimini otomatikleştirmek veya uygulamanızı komut satırından paketlemek için bkz. WinUI ile winapp CLI kullanma.

Uygulamanız bir masaüstü penceresi açar. Devam etmek için aşağıdaki Değişiklik yap seçeneğini kullanın.

Değişiklik yapma

Az önce oluşturduğunuz projeyi saklayın. Mevcut arayüzüne bir mesaj ekleyin:

  1. Çalışan uygulamayı kapatın. MainPage.xaml düzenleyicide açın. Şablonunuz bu dosyayı içermiyorsa, onun yerine MainWindow.xaml dosyasını açın.

  2. Uygulamanın içeriğini barındıran düzen panelini bulun. Mevcut CLI boş şablonunda, MainPage.xaml boş bir <Grid /> içerir. Bu boş ızgarayı şununla değiştirin:

    <Grid>
    <TextBlock
        Text="Hello, WinUI!"
        HorizontalAlignment="Center"
        VerticalAlignment="Center" />
</Grid>

    Panelde zaten denetimler varsa, yalnızca TextBlock öğesini o panelin içine ekleyin. Mevcut denetimleri, adları ve olay işleyicilerini koruyun. çevresindeki Page veya öğesini ya Windowda içindeki MainWindow.xamlçerçeveyi ve başlık çubuğunu değiştirmeyin.

  3. Dosyayı kaydedin. Proje klasöründen yeniden çalıştırın winapp run veya Visual Studio F5 tuşuna basın.

Tebrikler! İlk WinUI uygulamanızı oluşturdunuz, çalıştırıp güncelleştirdiniz. Pencerede artık Hello, WinUI! görüntüleniyor

Sorun giderme

Sorun Denetlenecek şeyler
winapp veya dotnet tanınmıyor. Yüklemeden sonra terminali yeniden açın. Her iki aracının da kullanılabilir olduğunu onaylamak için CLI sekmesindeki sürüm komutlarını kullanın.
winapp new tanınmıyor. Bu iş akışı, winapp CLI 0.6 veya sonraki bir sürümü gerektirir. Seçtiğiniz kurulum yöntemini kullanarak CLI'yi güncelleştirin.
WinUI şablonları Visual Studio görünmez. Visual Studio Yükleyicisi'ni açın, Değiştir'i seçin ve WinUI uygulama geliştirme iş yükünün yüklü olduğunu doğrulayın. Daha sonra Visual Studio yeniden başlatın.
Derleme işlemi bir SDK veya geri yükleme hatası bildiriyor. Seçili iş akışının önkoşullarını ve derleme çıkışındaki ilk hatayı denetleyin. Proje özelliklerini değiştirmeden önce sürüm gereksinimlerini kontrol etmek için Windows Uygulama SDK'sı desteği kullanın.
Dağıtım, Geliştirici Modu'nun devre dışı bırakıldığını bildiriyor. Geliştirici Modu'nu etkinleştirin, ardından uygulamayı yeniden çalıştırın.
Yeni mesajınız görünmüyor. XAML dosyasını kaydedin ve projeyi yeniden başlatın. MainPage.xaml içeren şablonlarda, pencerenin ana çerçevesini değiştirmek yerine mesajı o sayfaya ekleyin.

Sonraki adımlar

Not uygulaması oluşturma

Notlar öğreticisi, sayfaları, gezinmeyi, veri bağlamayı ve yerel depolamayı öğretmek amacıyla ayrı bir WinUINotes proje kullanır.

Terminalden çalışıyorsanız WinAPP CLI'yi WinUI ile kullanmak tam komut satırı iş akışını kapsar: şablonlar, dotnet runhata ayıklama, UI otomasyonu, test ve paketleme.

Odaklı denetim örneklerini Kod örnekleri ve WinUI Galerisi'nde de bulabilirsiniz.

  • Son güncelleştirme: