Wprowadzenie do interfejsu WinUI

WinUI 3 to natywna struktura interfejsu użytkownika do tworzenia aplikacji klasycznych Windows. To część zestawu Zestaw SDK do aplikacji systemu Windows — zbioru interfejsów API i narzędzi, które są niezależne od samego systemu operacyjnego Windows i muszą zostać zainstalowane na komputerze docelowym lub dołączone do aplikacji w pakiecie. Interfejs WinUI 3 obsługuje zarówno języki C#, jak i C++ i nie jest platformą międzyplatformową ani opartą na sieci Web.

Ważna

WinUI 3 różni się od platformy UWP. WinUI 3 używa przestrzeni nazw Microsoft.UI.Xaml i działa jako proces klasyczny; UWP używa Windows.UI.Xaml i uruchamia się w kontenerze aplikacji. WinUI 3 obsługuje dystrybucję spakietowaną (MSIX), spakietowaną z lokalizacją zewnętrzną oraz niespakietowaną — właściwy wybór zależy od scenariusza wdrożenia. Aby uzyskać wskazówki, zobacz Wybieranie metody dystrybucji .

Wybierz ścieżkę

Istnieją dwie obsługiwane ścieżki do tworzenia projektu WinUI 3.

	Visual Studio	Wiersz polecenia
Najlepsze dla	Programiści rozpoczynający pracę z tworzeniem aplikacji dla systemu Windows, projektanci wizualnych interfejsów użytkownika lub osoby, które chcą korzystać z w pełni funkcjonalnego środowiska IDE	Deweloperzy czujący się swobodnie w pracy z terminalem, potokami CI/CD lub skryptową konfiguracją środowiska
Narzędzi	Visual Studio 2026 z zainstalowanymi obciążeniami Zestaw SDK do aplikacji systemu Windows i WinUI	SDK .NET 10 z szablonami dotnet new WinUI
Tworzenie projektu	Kreator Nowy projekt — wybierz szablon Pusta aplikacja, spakietowana (WinUI 3 na komputer)	dotnet new winui -n MyApp
Kompilowanie i uruchamianie	Naciśnij klawisz F5 — program Visual Studio kompiluje, podpisuje i wdraża pakiet MSIX oraz uruchamia aplikację	dotnet run — kompiluje i uruchamia aplikację z tożsamością pakietu (wymaga trybu dewelopera)
Debugging	Pełny debuger Visual Studio z podglądem na żywo XAML	Dołącz debuger ręcznie lub otwórz wygenerowany .sln w Visual Studio

Obie ścieżki tworzą równoważne projekty WinUI 3. Ścieżka Visual Studio automatycznie obsługuje podpisywanie i wdrażanie MSIX. Ścieżka wiersza poleceń wykorzystuje dotnet run na potrzeby lokalnego programowania (dołączony pakiet Microsoft.Windows.SDK.BuildTools.WinApp automatycznie obsługuje tożsamość używaną podczas debugowania); przygotowanie pakietu do dystrybucji wymaga dodatkowych kroków.

Prerequisites

Obie ścieżki mają te same minimalne wymagania.

• Windows 10 w wersji 1809 (kompilacja 17763) lub nowsza — zaleca się Windows 11
• Tryb dewelopera włączony na urządzeniu (ms-settings:developers)
• Visual Studio 2026 (ścieżka Visual Studio) lub .NET 10 SDK (ścieżka wiersza polecenia)

Zestaw SDK do aplikacji systemu Windows jest oddzielną instalacją od Windows. Visual Studio instaluje go w ramach konfiguracji obciążenia. W przypadku ścieżki wiersza polecenia szablony dotnet new winui automatycznie dołączają wymagane pakiety NuGet.

Następne kroki

Szybki start: Visual Studio

Szybki start: wiersz polecenia