Przygotowanie do programowania za pomocą interfejsu WinUI 3
Środowisko pracy
- Windows
-
- Okna 11
- Visual Studio
-
- informacji o wersji Visual Studio 2022 w wersji 17.9.3
- .SIEĆ
-
- .NET 6
- (.NET 8)
- Interfejs użytkownika WinUI
-
- Interfejs WinUI 3
- Zestaw SDK aplikacji systemu Windows
-
- 1.4.230913002
Warunki wstępne
W niektórych przypadkach mogą również działać niższe wersje.
- Windows
-
- Okna 10
- Okna 11
- Visual Studio
-
- Visual Studio 2022 w wersji 17.9.3 lub nowszej
- .SIEĆ
-
- .NET 6
- (.NET 8)
- Zestaw SDK aplikacji systemu Windows
-
- 1.4.230913002 lub nowsza
Instalowanie programu Visual Studio i konfigurowanie interfejsu WinUI
Projekty deweloperskie WinUI 3 można dodawać za pomocą instalacji programu Visual Studio. Ta sekcja zawiera uproszczony opis procesu instalacji programu Visual Studio. Aby uzyskać szczegółowe instrukcje, zapoznaj się z poniższymi wskazówkami.
Uruchom instalatora programu Visual Studio 2022 z Internetu lub nośnika. Obsługuje wersje Community, Professional i wyższe.
W obszarze wyboru obciążenia wybierz pozycję . NET Programowanie aplikacji klasycznych.
「. NET Desktop Development i sprawdź szablony języka C# zestawu SDK aplikacji systemu Windows w obszarze Szczegóły instalacji po prawej stronie.
Teraz po prostu rozpocznij instalację. Są też inne ekrany, ale nie będę ich wyjaśniał, dopóki nie stworzą projektu.
Po zakończeniu instalacji utwórz nowy projekt.
W elemencie wyszukiwania w winui prawym górnym rogu znajduje się element, więc po jego wybraniu zostanie wyświetlony szablon projektu WinUI 3, więc wybierz dowolny szablon i utwórz projekt.
Teraz można tworzyć aplikacje przy użyciu interfejsu WinUI 3.
Jeśli zostanie wyświetlony komunikat "Określanie wartości docelowej dla wersji platformy .NET, która nie jest zainstalowana"
Od wersji 17.9.1 Visual Studio 2022 platforma .NET dla interfejsu WinUI 3 jest przeznaczona dla platformy .NET 6.
Jeśli nie wybierzesz żadnych dodatkowych środowisk uruchomieniowych w programie Visual Studio 2022, zostanie zainstalowane tylko środowisko uruchomieniowe platformy .NET 8 i może zostać wyświetlone ostrzeżenie podobne do poniższego.
Jeśli masz obawy, możesz zainstalować środowisko uruchomieniowe platformy .NET 6 lub po prostu odrzucić ostrzeżenie. Nie musisz instalować środowiska uruchomieniowego platformy .NET 6 do debugowania.
Jeśli chcesz dodać środowisko programistyczne WinUI 3 później
Jeśli najpierw zainstalujesz program Visual Studio, możesz dodać środowisko programistyczne WinUI 3 później.
Uruchom program Visual Studio i wybierz pozycję Narzędzia > Pobierz narzędzia i funkcje z menu.
Zostanie wyświetlony ten sam ekran, co podczas instalowania programu Visual Studio, dzięki czemu można użyć . Upewnij się, że jest zaznaczona opcja "Programowanie aplikacji klasycznych platformy .NET", a następnie zaznacz pozycję "Szablon języka C# zestawu SDK aplikacji systemu Windows" w obszarze "Szczegóły instalacji" po prawej stronie.
Włącz tryb programisty
Aplikacje WinUI działają w środowisku o zwiększonych zabezpieczeniach, w przeciwieństwie do innych aplikacji klasycznych. W związku z tym nie można go uruchomić w takiej postaci, w jakiej jest. Gdy spróbujesz go uruchomić, zobaczysz okno dialogowe podobne do poniższego i zostaniesz poproszony o włączenie "Trybu programisty". Jeśli klikniesz link, zostanie wyświetlony ekran ustawień, więc włącz "Tryb programisty".
Nawet jeśli nie używasz programu Visual Studio, możesz również włączyć lub wyłączyć "Tryb dewelopera" na ekranie ustawień. Wybierz "Ustawienia" z menu Start.
Z menu System wybierz opcję Dla deweloperów.
Jest przełącznik "Dla programistów", więc ustaw go na "Wł.". Zostanie wyświetlona notatka, więc wybierz "Tak", aby ją włączyć.
Jeśli chcesz zmienić na platformę .NET 8
Jeśli utworzysz projekt przy użyciu tego szablonu, będzie on domyślnie używany na platformie .NET 6. Nawet jeśli zmienię platformę docelową na .NET 8 z właściwości projektu, kompilacja nadal wyświetla błędy i ostrzeżenia. Jednak około 13.03.2024 r. zestaw SDK aplikacji systemu Windows zostanie zaktualizowany, aby oficjalnie obsługiwać platformę .NET 8.
Jednak szablon nadal znajduje się na platformie .NET 6, więc po utworzeniu projektu należy pracować na platformie .NET 8. Może istnieć możliwość, że będzie on obsługiwany w przyszłych aktualizacjach wersji.
Najpierw utwórz projekt, a następnie użyj narzędzia NuGet, aby zaktualizować wersje związane z zestawem SDK aplikacji systemu Windows.
O ile nie jest inaczej, wszystko jest na bieżąco. Microsoft.WindowsAppSDK musi mieć co najmniej 1.5.XXXX.
Zmień platformę docelową na .NET 8 we właściwościach projektu.
Nawet jeśli kompilujesz w tym stanie, zostanie wyświetlony błąd, ponieważ ustawienia projektu są nieaktualne.
Otwórz plik projektu jako kod.
RuntimeIdentifiersPonieważ istnieje parametr, usuń znak w 10 następujący sposób Win10 .
Przed modyfikacją
<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>
↓
Po wprowadzeniu poprawki
<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>
Przepisuje również ustawienia publikowania programu.
Otwórz każdy .pubxml plik w folderze Właściwości > PublishProfiles.
Podobnie RuntimeIdentifier usuń znak 10 w parametrze Win10 .
Następnie skompiluj ponownie i sprawdź, czy nie ma żadnych błędów ani ostrzeżeń.
.pubxml (W pliku pojawi się ostrzeżenie, ale nie musisz się o to martwić, ponieważ jest to inna składnia niż w tym problemie). )
Jednak z jakiegoś powodu biblioteka klas WinUI nadal ostrzega, nawet jeśli zrobisz to samo, co powyżej. Na razie możesz go uruchomić, więc poczekajmy, aż zostanie to naprawione.