WinUI

Valmistaudu kehittämään WinUI 3: n avulla

Sivu päivitetty :
Sivun luontipäivämäärä :

Toimintaympäristö

Windows
  • Windows 11
Visuaalinen studio
  • Visual Studio 2022 -versio 17.9.3
.VERKKO
  • .NET 6
  • (.NET 8)
WinUI
  • WinUI 3
Windows App SDK
  • 1.4.230913002

Edellytykset

Joissakin tapauksissa myös alemmat versiot voivat toimia.

Windows
  • Windows 10
  • Windows 11
Visuaalinen studio
  • Visual Studio 2022:n versio 17.9.3 tai uudempi
.VERKKO
  • .NET 6
  • (.NET 8)
Windows App SDK
  • 1.4.230913002 tai uudempi

Asenna Visual Studio ja määritä WinUI

WinUI 3 -kehitysprojekteja voidaan lisätä Visual Studio -asennuksen yhteydessä. Tässä osassa on yksinkertaistettu kuvaus Visual Studion asennusprosessista. Katso yksityiskohtaiset ohjeet seuraavista vinkeistä.

Käynnistä Visual Studio 2022 -asennusohjelma Internetistä tai mediasta. Se tukee Community-, Professional- tai uudempia versioita.

Valitse kuormituksen valinnassa . NET-työpöydän kehittäminen.

「. NET Desktop Development ja tarkista Windows App SDK C# -mallit oikealla olevasta asennustiedoista.

Aloita nyt asennus. On muitakin näyttöjä, mutta en selitä niitä ennen kuin ne luovat projektin.

Kun asennus on valmis, luo uusi projekti.

Oikeassa yläkulmassa on hakukohde winui , joten kun valitset sen, WinUI 3 -projektimalli tulee näkyviin, joten valitse mikä tahansa malli ja luo projekti.

Voit nyt kehittää sovelluksia WinUI 3: n avulla.

Jos näet viestin Kohdistaminen .NET-versioon, jota ei ole asennettu.

Visual Studio 2022 -versiosta 17.9.1 alkaen .NET for WinUI 3 kohdistuu .NET 6:een. Jos et valitse muita suoritusaikoja Visual Studio 2022:ssa, vain .NET 8 runtime asennetaan, ja saatat nähdä alla olevan kaltaisen varoituksen.

Jos olet huolissasi, voit asentaa .NET 6 runtimen tai vain hylätä varoituksen. Sinun ei tarvitse asentaa .NET 6 runtimea virheenkorjausta varten.

Jos haluat lisätä WinUI 3 -kehitysympäristön myöhemmin

Jos asennat Visual Studion ensin, voit lisätä WinUI 3 -kehitysympäristön myöhemmin.

Käynnistä Visual Studio ja valitse valikosta Työkalut > Hae työkalut ja ominaisuudet.

Sama näyttö kuin asennettaessa Visual Studio tulee näkyviin, joten voit käyttää . Varmista, että ".NET Desktop Development" on valittuna, ja valitse "Windows App SDK C # Template" oikealla olevasta "Installation Details" -kohdasta.

Ota kehittäjätila käyttöön

WinUI-sovellukset toimivat suojatussa ympäristössä, toisin kuin muut työpöytäsovellukset. Siksi sitä ei voida ajaa sellaisenaan. Kun yrität suorittaa sen, näet alla olevan kaltaisen valintaikkunan ja sinua pyydetään ottamaan käyttöön "Kehittäjätila". Jos napsautat linkkiä, asetusnäyttö tulee näkyviin, joten ota käyttöön "Kehittäjätila".

Vaikka et käyttäisikään Visual Studiota, voit myös ottaa kehittäjätilan käyttöön tai poistaa sen käytöstä asetusnäytöstä. Valitse Käynnistä-valikosta "Asetukset".

Valitse Järjestelmä-valikosta Kehittäjille.

Siellä on kytkin "Kehittäjille", joten aseta se asentoon "Päällä". Näyttöön tulee huomautus, joten ota se käyttöön valitsemalla "Kyllä".

Jos haluat vaihtaa .NET 8:aan

Jos luot projektin tällä mallilla, sen oletusarvo on .NET 6. Vaikka muuttaisin kohdekehykseksi .NET 8 projektin ominaisuuksista, koontiversio näyttää silti virheitä ja varoituksia. Noin 13.3.2024 Windows App SDK päivitetään kuitenkin tukemaan virallisesti .NET 8:aa.

Malli on kuitenkin edelleen .NET 6:ssa, joten sinun on käsiteltävä .NET 8:aa, kun olet luonut projektin. Saattaa olla mahdollista, että sitä tuetaan tulevissa versiopäivityksissä.

Luo ensin projekti ja päivitä sitten Windows App SDK:hon liittyvät versiot NuGetin avulla.

Ellei muuten ole, kaikki on ajan tasalla. Microsoft.WindowsAppSDK on oltava vähintään 1.5.XXXX.

Muuta kohdekehykseksi .NET 8 projektin ominaisuuksista.

Vaikka rakennat tässä tilassa, näyttöön tulee virhe, koska projektin asetukset ovat vanhentuneita.

Avaa projektitiedosto koodina.

RuntimeIdentifiersKoska parametri on olemassa, poista merkki 10 seuraavasti Win10 .

Ennen muutosta

<RuntimeIdentifiers>win10-x86;win10-x64;win10-arm64</RuntimeIdentifiers>

↓

Korjauksen jälkeen

<RuntimeIdentifiers>win-x86;win-x64;win-arm64</RuntimeIdentifiers>

Se myös kirjoittaa ohjelman julkaisuasetukset uudelleen. Avaa kukin .pubxml tiedosto Properties > PublishProfiles -kansiossa.

RuntimeIdentifier Samoin , poista merkki 10 parametrista Win10 .

Tämän jälkeen rakenna uudelleen ja varmista, ettei virheitä tai varoituksia ole. .pubxml (Tiedostossa on varoitus, mutta sinun ei tarvitse huolehtia siitä, koska se on eri syntaksi kuin tämä ongelma.) )

Jostain syystä WinUI-luokkakirjasto varoittaa kuitenkin edelleen, vaikka tekisit saman asian kuin edellä. Toistaiseksi voit suorittaa sen, joten odotetaan, kunnes tämä on korjattu.