Condividi tramite


Annullare il pacchetto di un'app WinUI 3

La creazione di pacchetti è una parte importante di qualsiasi Windows App SDK project. Per informazioni dettagliate sulle opzioni, vedi Vantaggi e svantaggi della creazione del pacchetto dell'app.

Se si sceglie di annullare il pacchetto di un'app WinUI nuova o esistente, seguire questa procedura:

Nel tuo .csproj file, trova il primo elemento PropertyGroup esistente, che contiene anche OutputType, TargetFramework, e altre proprietà.

  • Aggiungere la proprietà WindowsPackageType project a questo elemento PropertyGroup. Impostarne il valore su None.
<Project ...>
  ...
  <PropertyGroup>
    <WindowsPackageType>None</WindowsPackageType><!-- add this -->
    <OutputType>WinExe</OutputType>
    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
    ...
  </PropertyGroup> 
  ...
</Project>

Per avviare l'app da Visual Studio (in modalità debug o senza debug), selezionare il profilo di avvio Unpackaged dal menu a tendina Start. Se è selezionato il profilo Package, verrà visualizzato un errore di distribuzione in Visual Studio. Questo passaggio non è necessario se si avvia l'applicazione (.exe) dalla riga di comando o da Windows File Explorer.

Visual Studio - Avviare l'elenco a discesa con il profilo di avvio non in pacchetto dell'applicazione C# evidenziato

API del programma di avvio automatico

L'impostazione della proprietà <WindowsPackageType>None</WindowsPackageType> del progetto fa sì che l'auto-initializer individui e carichi una versione del Windows App SDK più appropriata per la tua app.

Se sono necessarie esigenze avanzate, ad esempio la gestione degli errori personalizzata o il caricamento di una versione specifica del Windows App SDK, è possibile chiamare in modo esplicito l'API del programma di avvio automatico. Per ulteriori informazioni, vedi Utilizzare il runtime di Windows App SDK per le app confezionate con una posizione esterna o non confezionate e Tutorial: Utilizzare l'API del bootstrapper in un'app confezionata con una posizione esterna o non confezionata che utilizza il Windows App SDK.

Per altre informazioni sul programma di avvio automatico, vedi Architettura di distribuzione e panoramica per le app dipendenti dal framework.