Mata ut en app som skapats med WinUI 3 så att den kan köras i ett fristående EXE-format

Sidan uppdaterad :
Datum för skapande av sida :

Operativ miljö

Windows
  • Windows 11 (på engelska)
Visuell Studio
  • Visual Studio 2022 version 17.12.3
.NÄT
  • .NET 8
WinUI (på engelska)
  • WinUI 3
SDK för Windows-appar
  • 1.6.3 (1.6.241114003)

Förutsättningar

I vissa fall kan även lägre versioner fungera.

Windows
  • Windows 10 (på engelska)
  • Windows 11 (på engelska)
Visuell Studio
  • Visual Studio 2022 version 17.12 eller senare
.NÄT
  • .NET 8 eller senare
SDK för Windows-appar
  • 1.6.0 eller senare

Först

Program som skapats med WinUI 3 är vanligtvis paketerade program som bara kan köras under särskilda omständigheter. För att köra den måste du ladda ner och installera den från Microsoft Store. Det finns också en metod för att distribuera filer direkt, men den kräver något komplicerade procedurer och inställningar och är inte lämplig för att distribuera till ett ospecificerat antal personer. I stället kan du köra ditt program i en mycket säker miljö.

Metoden som introducerades den här gången låter dig skapa en EXE-fil med uppackad metod, så att du kan distribuera EXE-filen till användaren som den är och köra den. Om du vill att ett program som är skrivet med WindowsForm eller WPF ska se ut på samma sätt som du vill att det ska distribueras är den här metoden rätt väg att gå.

Uppmärksamhet

WinUI 3-relaterade produkter uppdateras ständigt, så de kanske inte fungerar bra på grund av olika versioner. Jag tror att den här proceduren kommer att fungera om du matchar IDE- och SDK-versionerna, men om det inte fungerar bra, var uppmärksam på olika versioner.

Dessutom har program som skrivs med uppackade program viss begränsad funktionalitet jämfört med paketerade program. Det är svårt att förklara detaljerna, så kontrollera om det fungerar enligt programmet du skapade.

förutsättning

Uppdatera Visual Studio 2022

I grund och botten är det inga problem så länge du har den senaste versionen. Åtminstone versionen i början av den här artikeln. Kör den från Visual Studio-menyn eller starta "Visual Studio Installer" från Start-menyn för att uppdatera den.

Installera SDK för Windows-appar (SDK för Windows-appar)

SDK:n för Windows-appar som ingår i Visual Studio-installationen är inaktuell och bör vara uppdaterad. Ladda ner och installera den från följande webbplats.

När den körs kommer batchen att startas och uppdateras utan att fråga.

Skapa ett projekt

Efter det skapar du det program du vill skapa. I det här avsnittet beskrivs tillståndet för det nya projektet.

Uppdatera paketversionen med NuGet

Kontrollera att versionen av "Microsoft.WindowsAppSDK" är minst den version som finns i början av den här artikeln. Det är inga problem med att den medföljande "Microsoft.Windows.SDK.BuildTools" är uppdaterad.

Om du vill uppdatera kan du göra det från det NuGet-hanterade paketet.

Inaktivera paketet

Öppna projektegenskaperna.

I kategorin "Program > paketering" finns det ett objekt som heter "Aktiverat MSIX-paketering för det här projektet", så avmarkera det.

Prova själv

Om du tittar på felsökningen av verktygsfältet tror jag att det är "XXXX (Paket)". Du kan ändra det till "XXXX (Opackad)" från valet, så ändra det till Opackad.

När du har ändrat det kan du prova att köra det. Om du kan köra det utan fel är det inga problem.

Generera en EXE-fil

Du kan distribuera EXE-filen som genereras efter bygget, men den här gången kommer jag att mata ut den körbara filen från menyn "Publicera".

Förresten, för att "publicera"-processen ska kunna utföras framgångsrikt med uppackad måste du använda ". Utveckling av NET Desktop.

Högerklicka på projektet och välj Publicera.

Om du börjar med ett nytt projekt har du tre profiler skapade från början, så att du kan välja den miljö som du vill distribuera till. Om du uppdaterar ett projekt etc. kanske det inte finns någon profil, så skapa i så fall en ny profil.

Från Fler åtgärder väljer du Redigera.

Av någon anledning skiljer sig inställningarna från profilen, till exempel de ursprungliga inställningarna, så matcha profilen på följande sätt.

Parameternamn, inställningsvärde, anmärkningar
konfiguration Släpp xXX Ändra det enligt din profil. Om det är win-x64 är det Release x64.
Ramverk för mål Anpassa dig till ditt nuvarande projekt
Distributions lägen Fristående I den nuvarande specifikationen fungerar endast "fristående".
Målkörning vinna-xXX Ändra det enligt din profil. Om det är win-x64, gör det win-x64.
Målplats Lämna standardvärdet
Skapa en enskild fil bort Enligt den nuvarande specifikationen kan den inte köras även om den skapas i en enda fil.
ReadyToRun (på engelska) godtycklig Kolla in det om du vill förbättra prestandan.
Trimma oanvänd kod godtycklig Markera det om du vill minska filstorleken. Observera att det inte kommer att fungera beroende på hur programmet skapas.

När du är klar klickar du på knappen "Skicka".

Kontrollera att publiceringen lyckades utan fel.

Du kan öppna den publicerade filen genom att klicka på länken Målplats.

Om du kan köra EXE-filen och starta den är du bra att gå. Om du vill distribuera måste du ta hela uppsättningen filer i den här mappen. 「. Det är okej att ta bort filer som inte är nödvändiga för körning, till exempel ".pdb"-filer.