Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Visual Studio jest zalecanym środowiskiem IDE do tworzenia aplikacji systemu Windows za pomocą WinUI oraz Zestaw SDK do aplikacji systemu Windows. Zapewnia głęboką integrację z platformą Windows i narzędziami utworzonymi specjalnie na potrzeby tworzenia aplikacji opartych na języku XAML.
Najważniejsze funkcje dla deweloperów aplikacji Windows obejmują:
- XAML Przeładowywanie na gorąco — zmodyfikuj znacznik XAML podczas działania aplikacji i zobacz zmiany zastosowane natychmiast bez ponownego uruchamiania
- XAML Live Visual Tree — sprawdzanie drzewa wizualnego środowiska uruchomieniowego uruchomionej aplikacji w celu debugowania problemów z układem i zrozumienia hierarchii elementów
- IntelliSense dla języków XAML i C#/C++ — uzyskiwanie uzupełniania kodu, szybkich informacji i wyróżniania błędów zarówno dla znaczników, jak i kodu za pomocą kodu
- Zintegrowane debugowanie — ustawianie punktów przerwania w języku XAML i kodzie, inspekcja powiązań danych i diagnozowanie problemów z renderowaniem interfejsu użytkownika
Aby rozpocząć, zobacz Tworzenie i uruchamianie projektu WinUI 3.
Szablony projektu WinUI
Visual Studio zawiera szablony projektów ułatwiające szybkie tworzenie aplikacji WinUI. Aby je znaleźć, otwórz plik File>New>Project, następnie filtruj według WinUI na liście rozwijanej typu project lub wyszukaj WinUI.
Szablony aplikacji
Wybierz szablon na podstawie App Shell, od którego chcesz zacząć. Wybierz nazwę szablonu, aby wyświetlić zrzut ekranu przedstawiający aplikację, którą tworzy.
| Template | Język | Szablon CLI winapp | Opis |
|---|---|---|---|
| Pusta aplikacja WinUI (spakowana) | C# i C++ |
winui (C#) |
Jedno okno bez zawartości. Jest to zalecany punkt początkowy dla większości nowych aplikacji. |
| Aplikacja nawigacyjna WinUI | C# | winui-navview |
Powłoka NavigationView ze stronami Strona główna, Informacje i Ustawienia. |
| Aplikacja TabView WinUI | C# | winui-tabview |
Powłoka TabView , której karty znajdują się na pasku tytułu. |
| Aplikacja WinUI MVVM | C# | winui-mvvm |
Model strony i model widoku korzystający ze wzorca Model-View-ViewModel (MVVM) z narzędziem CommunityToolkit.Mvvm. |
| Pusta aplikacja (spakowana przy użyciu projektu WAP) | C# i C++ | Niedostępne | Pusta aplikacja oraz oddzielny projekt pakowania aplikacji systemu Windows. |
Utwórz projekt z poziomu wiersza polecenia
Szablony aplikacji języka C# są również dostępne w terminalu za pośrednictwem aplikacja dla systemu Windows Development CLI (winapp CLI). Przekaż nazwę szablonu z tabeli do winapp new, a następnie skompiluj i uruchom aplikację za pomocą polecenia winapp run:
winapp new --name MyApp --template winui-navview --use-defaults
cd MyApp
winapp run
Uruchom polecenie winapp new --list, aby wyświetlić wszystkie zainstalowane szablony. Wygenerowany projekt jest standardowym plikiem csproj, więc można go otworzyć w Visual Studio w dowolnym momencie. Aby uzyskać więcej informacji, zobacz Korzystanie z interfejsu wiersza polecenia winapp z WinUI.
Pusta aplikacja WinUI (spakowana)
Tworzy aplikację klasyczną w języku C# (.NET) lub C++ (Win32) przy użyciu interfejsu użytkownika opartego na systemie WinUI. Aplikacja rozpoczyna się od jednego okna pochodzącego z Microsoft.UI.Xaml.Window, które jest gotowe, abyś mógł dodać własne kontrolki i strony. Jest to zalecany punkt początkowy dla większości nowych aplikacji. Aby zapoznać się z przewodnikiem, zobacz Tworzenie i uruchamianie projektu WinUI 3.
Aplikacja nawigacyjna WinUI
Tworzy aplikację w języku C# z elementem NavigationView w okienku po lewej stronie. Szablon zawiera strony Strona główna i Informacje, element Ustawienia i kod nawigacji, który umożliwia przełączanie między nimi.
Aplikacja TabView WinUI
Tworzy aplikację w języku C# z kontrolką TabView , która rozciąga się na pasek tytułu. Szablon zawiera karty Home i Informacje o oraz przycisk dodawania nowych kart.
Aplikacja WinUI MVVM
Tworzy aplikację w języku C#, która oddziela interfejs użytkownika od logiki za pomocą wzorca MVVM. Szablon używa biblioteki CommunityToolkit.Mvvm do właściwości obserwowalnych i poleceń oraz przedstawia licznik powiązany z modelem widoku.
Pusta aplikacja (spakowana przy użyciu Project WAP)
Podobnie jak powyższy szablon Pustej aplikacji WinUI (spakowanej), ale dodaje do rozwiązania oddzielny projekt tworzenia pakietów aplikacji systemu Windows . Ten projekt zajmuje się budowaniem aplikacji w pakiecie MSIX do dystrybucji. Jeśli wolisz prostszą konfigurację, możesz użyć single-project MSIX, aby uniknąć obsługi oddzielnego projektu pakowania.
Szablony składników i testów
Te szablony tworzą biblioteki i projekty testowe, które współpracują z aplikacją WinUI.
| Template | Język | Szablon CLI winapp | Opis |
|---|---|---|---|
| Biblioteka klas WinUI | C# | winui-lib |
Biblioteka klas .NET (DLL) do udostępniania kodu i składników interfejsu użytkownika w aplikacjach WinUI. |
| Składnik środowiska uruchomieniowego systemu Windows | C++ | Niedostępne | Składnik środowisko wykonawcze systemu Windows napisany w języku C++/WinRT, który może być używany przez dowolną aplikację z interfejsem użytkownika opartym na systemie WinUI, niezależnie od języka programowania. |
| Aplikacja testowa jednostkowa WinUI | C# i C++ |
winui-unittest (C#) |
Project MSTest na potrzeby pisania i uruchamiania testów automatycznych względem aplikacji. |
Szablony elementów WinUI
Szablony elementów umożliwiają dodawanie nowych plików do istniejącego projektu WinUI. Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań wybierz Dodaj>Nowy element i wybierz kartę WinUI.
| Template | Język | Opis |
|---|---|---|
| Pusta strona | C# i C++ | Dodaje plik XAML i plik kodu definiujący nową stronę pochodzącą z klasy Microsoft.UI.Xaml.Controls.Page . |
| Puste okno | C# i C++ | Dodaje plik XAML i plik kodu, które definiują nowe okno wywodzące się z klasy Microsoft.UI.Xaml.Window. |
| Okno dialogowe zawartości | C# | Dodaje plik XAML i plik kodu definiujący nowe okno dialogowe dziedziczące po klasie Microsoft.UI.Xaml.Controls.ContentDialog. Aby uzyskać więcej informacji, zobacz Kontrolki okna dialogowego. |
| Słownik zasobów | C# i C++ | Dodaje pustą kolekcję kluczy zasobów XAML. Aby uzyskać więcej informacji, zobacz ResourceDictionary i odwołania do zasobów XAML. |
| Plik zasobów (.resw) | C# i C++ | Dodaje plik do przechowywania ciągów i zasobów warunkowych dla aplikacji. Możesz użyć tego elementu, aby ułatwić lokalizowanie aplikacji. Aby uzyskać więcej informacji, zobacz Lokalizowanie ciągów w manifeście interfejsu użytkownika i pakietu aplikacji. |
| Kontrola szablonowa | C# i C++ | Dodaje plik kodu do tworzenia kontrolki szablonu z domyślnym stylem. Kontrolka szablonu pochodzi z klasy Microsoft.UI.Xaml.Controls.Control .Aby zapoznać się z przewodnikiem pokazującym, jak używać tego szablonu elementu, zobacz Tworzenie kontrolek przy użyciu szablonów XAML. Aby uzyskać więcej informacji na temat kontrolek szablonów, zobacz Niestandardowe kontrolki XAML. |
| Kontrola użytkownika | C# i C++ | Dodaje plik XAML i plik kodu do tworzenia kontrolki użytkownika pochodzącej z klasy Microsoft.UI.Xaml.Controls.UserControl . Zazwyczaj kontrolka użytkownika hermetyzuje powiązane istniejące kontrolki i udostępnia własną logikę.Aby uzyskać więcej informacji na temat kontrolek użytkownika, zobacz Niestandardowe kontrolki XAML. |
Aby dodać te elementy z wiersza polecenia w projekcie języka C#, użyj zgodnego dotnet new szablonu elementu, takiego jak dotnet new winui-page -n SettingsPage. Uruchom polecenie dotnet new list winui , aby wyświetlić wszystkie szablony elementów.