Condividi tramite


Aggiornare i progetti esistenti a una versione diversa di Windows App SDK

Se hai creato un progetto con una versione precedente di Windows App SDK (in precedenza denominata Project Reunion) o WinUI 3, è possibile aggiornare il progetto per usare una versione più recente. Per altre informazioni sulle funzionalità attualmente disponibili in ogni canale di versione, vedere Windows App SDK, canali di rilascio.

Nota

Queste istruzioni potrebbero avere problemi a causa dell'univocità dello scenario individuale di ogni app. Seguirli attentamente e, se si trova un problema, segnalare un bug nel repository di GitHub microsoft-ui-xaml .

Aggiornamento tra le versioni rilasciate dopo la 1.0

Se il progetto non fa riferimento alla versione del pacchetto NuGet di Windows App SDK necessario, è possibile usare Gestione pacchetti NuGet in Visual Studio per aggiornare i riferimenti al pacchetto NuGet del progetto. Ad esempio, se si crea un nuovo progetto usando una versione stabile di VSIX Windows App SDK, il progetto farà riferimento a una versione stabile di Windows App SDK. Tuttavia, è possibile riconfigurare facilmente il progetto in modo che faccia riferimento, ad esempio una versione sperimentale di Windows App SDK. Oppure riconfigurarlo per fare riferimento alla versione stabile più recente.

Per i passaggi, vedere le istruzioni in Utilizzo di Windows App SDK in un progetto esistente.

Aggiornamento da 0.8 a 1.0

Se è stato creato un progetto usando la versione 0.8 (ad esempio versione 0.8.4), è possibile seguire queste istruzioni per aggiornare il progetto alla versione 1.0.

Prerequisito: scaricare e installare la versione più recente di Windows App SDK. Per ulteriori informazioni, vedere Installare strumenti per SDK per app di Windows.

Istruzioni

  1. Nel file .wapproj, se la TargetPlatformMinVersion è precedente a 10.0.17763.0, modificarla a 10.0.17763.0.

  2. In Visual Studio passare a Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti. Questo processo consiste nella disinstallazione dei riferimenti al pacchetto Project Reunion esistenti da .csproj/.vcxproj e .wapproj file e quindi nell'installazione dei WindowsAppSDK riferimenti al pacchetto a tali file.

  3. Immettere i comandi seguenti per disinstallare i ProjectReunion pacchetti esistenti da .csproj/.vcxproj

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} 
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    
  4. Eseguire quindi quanto segue per disinstallare i ProjectReunion pacchetti esistenti da .wapproj:

    uninstall-package Microsoft.ProjectReunion 
    uninstall-package Microsoft.ProjectReunion.WinUI
    
  5. Eseguire ora i comandi per installare il pacchetto stabile WindowsAppSDK .

  6. Per aggiungere il WindowsAppSDK riferimento al pacchetto al proprio .csproj/.vcxproj:

    install-package Microsoft.WindowsAppSDK -ProjectName {yourProject} -Version 1.0.0
    
  7. Per aggiungere il WindowsAppSDK riferimento al pacchetto al proprio .wapproj:

    install-package Microsoft.WindowsAppSDK -Version 1.0.0 
    

Aggiornamento da 0.8 o 0.8 Preview a 1.0 Experimental o Preview 3

Importante

La versione 1.0 Preview 1 e Preview 2 contiene un bug critico. Se è già stata installata una di queste anteprime, consultare la sezione Problema importante che influisce sulla versione 1.0 Preview 1 e Preview 2. È consigliabile usare invece la versione 1.0 Preview 3 (1.0.0-preview3 ).

Se è stato creato un progetto usando la versione 0.8 Preview o una versione 0.8 (ad esempio, versione 0.8.1), è possibile seguire queste istruzioni per aggiornare il progetto alla versione 1.0 Preview 3 o Experimental.

Prima di iniziare, assicurarsi di avere installato tutti i prerequisiti SDK per app di Windows, incluso il pacchetto VSIX e NuGet più recente. Per ulteriori dettagli, vedere Installazione di strumenti per Windows App SDK.

In primo luogo, eseguire le seguenti operazioni:

  • Nel file con estensione wapproj, se TargetPlatformMinVersion è precedente a 10.0.17763.0, impostarlo su 10.0.17763.0.

Apportare quindi queste modifiche al progetto:

  1. In Visual Studio passare a Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.

  2. Immettere i comandi seguenti per 1.0 Preview 3:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    install-package Microsoft.WindowsAppSDK -Version 1.0.0-preview3 -ProjectName {yourProjectName}
    

    Oppure i comandi seguenti per la versione 1.0 Experimental:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    install-package Microsoft.WindowsAppSDK -Version 1.0.0-experimental1 -ProjectName {yourProjectName}
    
  3. Apportare le modifiche seguenti nell'applicazione (package).wapproj:

    1. Rimuovere questo gruppo di elementi (se si esegue l'aggiornamento da una versione diversa da 0.8.0, si noterà che il numero di versione corrispondente a cui si fa riferimento in questo gruppo di elementi):

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
    2. Aggiungere questo gruppo di elementi per sostituirlo con 1.0 Preview 3:

      <ItemGroup>
          <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-preview3]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      

      In alternativa, sostituire questo gruppo di elementi con 1.0 Experimental:

      <ItemGroup>
          <PackageReference Include="Microsoft.WindowsAppSDK" Version="[1.0.0-experimental1]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="[1.0.0-experimental1]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
  4. Apportare le modifiche seguenti al file di progetto (con estensione csproj o vcproj):

    1. Rimuovere questo gruppo di elementi (se si esegue l'aggiornamento da una versione diversa da 0.8.0, si noterà che il numero di versione corrispondente a cui si fa riferimento in questo gruppo di elementi):

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0" />
          <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0" />
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0" />
          <Manifest Include="$(ApplicationManifest)" />
      </ItemGroup>
      
    2. Aggiungere questo gruppo di elementi per sostituirlo con 1.0 Preview 3:

      <ItemGroup>
          <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-preview3" />
          <Manifest Include="$(ApplicationManifest)" />
      </ItemGroup>
      

      In alternativa, sostituire questo gruppo di elementi con 1.0 Experimental:

      <ItemGroup>
          <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.0.0-experimental1" />
          <PackageReference Include="Microsoft.WindowsAppSDK.Foundation" Version="1.0.0-experimental1" />
          <PackageReference Include="Microsoft.WindowsAppSDK.WinUI" Version="1.0.0-experimental1" />
          <Manifest Include="$(ApplicationManifest)" />
      </ItemGroup>
      
  5. Se la soluzione non riesce a compilare, pulire l'output della compilazione, riavviare Visual Studio e provare a eseguire nuovamente l'app.

Aggiornamento dalla versione 0.8 Preview alla versione 0.8 o tra le versioni stabili della versione 0.8

Se è stato creato un progetto usando la versione 0.8 Preview, è possibile seguire queste istruzioni per aggiornare il progetto a una versione stabile di 0.8. Queste istruzioni si applicano anche se è stato creato un progetto con una versione stabile precedente di 0.8 (ad esempio 0.8.0) e si vuole aggiornare il progetto a una versione stabile più recente (ad esempio, 0.8.2).

Nota

È possibile aggiornare automaticamente il progetto tramite Gestione estensioni di Visual Studio, senza eseguire i seguenti passaggi manuali. In Visual Studio 2019 fare clic su Estensioni>Gestisci estensioni e selezionare Aggiornamenti dalla barra dei menu a sinistra. Selezionare "Project Reunion" nell'elenco e fare clic su Aggiorna.

Prima di iniziare, assicurarsi di avere installato tutti i prerequisiti SDK per app di Windows, incluso il pacchetto VSIX e NuGet più recente. Per ulteriori dettagli, vedere Installazione di strumenti per Windows App SDK.

In primo luogo, eseguire le seguenti operazioni:

  • Nel file con estensione wapproj, se TargetPlatformMinVersion è precedente a 10.0.17763.0, impostarlo su 10.0.17763.0.

Apportare quindi queste modifiche al progetto:

  1. In Visual Studio passare a Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.

  2. Immettere i comandi seguenti:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    install-package Microsoft.ProjectReunion -Version 0.8.2 -ProjectName {yourProjectName}
    
  3. Apportare le modifiche seguenti nell'applicazione (package).wapproj:

    1. Rimuovere questo gruppo di elementi (se si esegue l'aggiornamento da una versione diversa da 0.8 Preview, si noterà che il numero di versione corrispondente a cui si fa riferimento in questo gruppo di elementi):

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
    2. Aggiungere questo gruppo di elementi per sostituirlo:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.2]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.2]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
  4. Apportare le modifiche seguenti al file di progetto (con estensione csproj o vcproj):

    1. Rimuovere questo gruppo di elementi (se si esegue l'aggiornamento da una versione diversa da 0.8 Preview, si noterà che il numero di versione corrispondente a cui si fa riferimento in questo gruppo di elementi):
      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" />
          <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" />
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" />
          <Manifest Include="$(ApplicationManifest)" />
      </ItemGroup>
      
    2. Aggiungere questo gruppo di elementi per sostituirlo:
      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.2" />
          <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.2" />
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.2" />
          <Manifest Include="$(ApplicationManifest)" />
      </ItemGroup>
      
  5. Se la soluzione non riesce a compilare, pulire l'output della compilazione, riavviare Visual Studio e provare a eseguire nuovamente l'app.

Aggiornamento da 0.5 a 0.8

Se è stato creato un progetto usando la versione stabile 0.5, è possibile seguire queste istruzioni per aggiornare il progetto a una versione stabile 0.8.

Nota

È possibile aggiornare automaticamente il progetto tramite Gestione estensioni di Visual Studio, senza eseguire i seguenti passaggi manuali. In Visual Studio 2019 fare clic su Estensioni>Gestisci estensioni e selezionare Aggiornamenti dalla barra dei menu a sinistra. Selezionare "Project Reunion" nell'elenco e fare clic su Aggiorna.

Prima di iniziare, assicurarsi di avere installato tutti i prerequisiti SDK per app di Windows, incluso il pacchetto VSIX e NuGet più recente. Per ulteriori dettagli, vedere Installazione di strumenti per Windows App SDK.

In primo luogo, eseguire le seguenti operazioni:

  • Nel file con estensione wapproj, se TargetPlatformMinVersion è precedente a 10.0.17763.0, impostarlo su 10.0.17763.0.

Apportare quindi queste modifiche al progetto:

  1. In Visual Studio passare a Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.

  2. Immettere i comandi seguenti:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    install-package Microsoft.ProjectReunion -Version 0.8.0 -ProjectName {yourProjectName}
    
  3. Aggiungere la riga seguente al file di progetto (con estensione csproj o vcproj), all'interno del primo <PropertyGroup>:

    <UseWinUI>true</UseWinUI>
    
  4. Apportare le modifiche seguenti nell'applicazione (package).wapproj:

    1. Aggiungere questa sezione:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
    2. Individuare la riga seguente:

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
      

      Spostare questa riga e posizionarla su una nuova riga direttamente sotto il tag <TargetPlatformVersion>.

    3. Rimuovere questo gruppo di elementi (se si esegue l'aggiornamento da una versione precedente alla 0.5.7, verrà visualizzato un numero di versione precedente a cui si fa riferimento in questo gruppo di elementi):

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.7]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
  5. Se la soluzione non riesce a compilare, pulire l'output della compilazione, riavviare Visual Studio e provare a eseguire nuovamente l'app.

Aggiornamento dalla versione 0.5 Preview alla versione 0.8 Preview

Se è stato creato un progetto usando la versione 0.5 Preview, è possibile seguire queste istruzioni per aggiornare il progetto a una versione 0.8 preview.

Nota

È possibile aggiornare automaticamente il progetto tramite Gestione estensioni di Visual Studio, senza eseguire i seguenti passaggi manuali. In Visual Studio 2019 fare clic su Estensioni>Gestisci estensioni e selezionare Aggiornamenti dalla barra dei menu a sinistra. Selezionare "Project Reunion" nell'elenco e fare clic su Aggiorna.

Prima di iniziare, assicurarsi di avere installato tutti i prerequisiti SDK per app di Windows, incluso il pacchetto VSIX e NuGet più recente. Per ulteriori dettagli, vedere Installazione di strumenti per Windows App SDK.

In primo luogo, eseguire le seguenti operazioni:

  • Nel file con estensione wapproj, se TargetPlatformMinVersion è precedente a 10.0.17763.0, impostarlo su 10.0.17763.0.

  • I modelli di progetto predefiniti per le app C++ e C# includevano le righe seguenti. L'evento Application.Suspending non viene più richiesto per le app desktop, quindi assicurarsi di rimuovere queste righe (e qualsiasi altro uso di questo evento) se sono ancora presenti nel codice:

    this.Suspending += OnSuspending;
    
    Suspending({ this, &App::OnSuspending });
    

Apportare quindi queste modifiche al progetto:

  1. In Visual Studio passare a Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.

  2. Immettere i comandi seguenti:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    install-package Microsoft.ProjectReunion -Version 0.8.0-preview -ProjectName {yourProjectName}
    
  3. Apportare le modifiche seguenti nell'applicazione (package).wapproj:

    1. Aggiungere questa sezione:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.8.0-preview]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.8.0-preview]">
          <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
    2. Aggiungere la riga seguente a una nuova riga direttamente sotto il tag <TargetPlatformVersion>.

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
      
    3. Rimuovere questa riga:

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
      

      Aggiungere anche queste righe:

      <Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
      <Import Project="$(Microsoft_WinUI_AppX_targets)" />
      

      E questo gruppo di elementi:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0]" GeneratePathProperty="true">
            <ExcludeAssets>all</ExcludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0]" GeneratePathProperty="true">
            <ExcludeAssets>all</ExcludeAssets>
          </PackageReference>
      </ItemGroup>
      
  4. Apportare le modifiche seguenti al file di progetto (con estensione csproj o vcproj):

    1. Rimuovere questo gruppo di elementi:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="0.5.0-prerelease" />
          <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.5.0-prerelease" />
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.5.0-prerelease" />
          <Manifest Include="$(ApplicationManifest)" />
      </ItemGroup>
      
    2. Aggiungere questo gruppo di elementi:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="0.8.0-preview" />
          <PackageReference Include="Microsoft.ProjectReunion.Foundation" Version="0.8.0-preview" />
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="0.8.0-preview" />
          <Manifest Include="$(ApplicationManifest)" />
      </ItemGroup>
      
  5. Se la soluzione non riesce a compilare, pulire l'output della compilazione, riavviare Visual Studio e provare a eseguire nuovamente l'app.

Aggiornamento dalla versione 0.5 Preview alla versione 0.5

Se è stato creato un progetto usando la versione 0.5 Preview, è possibile seguire queste istruzioni per aggiornare il progetto a una versione stabile 0.5.7.

Prima di iniziare, assicurarsi di avere installato tutti i prerequisiti SDK per app di Windows, incluso il pacchetto VSIX e NuGet più recente. Per ulteriori dettagli, vedere Installazione di strumenti per Windows App SDK.

In primo luogo, eseguire le seguenti operazioni:

  • [Solo app desktop] Nel file con estensione wapproj, se TargetPlatformMinVersion è precedente a 10.0.17763.0, impostarlo su 10.0.17763.0.

  • I modelli di progetto predefiniti per le app C++ e C# includevano le righe seguenti. L'evento Application.Suspending non viene più richiesto per le app desktop, quindi assicurarsi di rimuovere queste righe (e qualsiasi altro uso di questo evento) se sono ancora presenti nel codice:

    this.Suspending += OnSuspending;
    
    Suspending({ this, &App::OnSuspending });
    

Apportare quindi queste modifiche al progetto:

  1. In Visual Studio passare a Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.

  2. Immettere i comandi seguenti:

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}
    
  3. Se si dispone di un'app UWP, il processo di aggiornamento dovrebbe essere completato in questa fase. Se si dispone di un'app desktop, apportare le modifiche seguenti nell'applicazione (package).wapproj:

    1. Aggiungere questa sezione:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
              <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
    2. Individuare il <TargetPlatformVersion> tag e aggiungere il codice seguente in una nuova riga direttamente sotto questo tag

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
      
    3. Rimuovere questa riga:

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
      

      Aggiungere anche queste righe:

      <Import Project="$(Microsoft_ProjectReunion_AppXReference_props)" />
      <Import Project="$(Microsoft_WinUI_AppX_targets)" />
      

      E questo gruppo di elementi:

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
            <ExcludeAssets>all</ExcludeAssets>
          </PackageReference>
          <PackageReference Include="Microsoft.ProjectReunion.WinUI" Version="[0.5.0-prerelease]" GeneratePathProperty="true">
            <ExcludeAssets>all</ExcludeAssets>
          </PackageReference>
      </ItemGroup>
      

Aggiornamento da WinUI 3 Preview 4 a 0.5

Se si è creato un'app desktop con WinUI 3 Preview 4, è possibile seguire queste istruzioni per aggiornare il progetto a Project Reunion 0.5.

Prima di iniziare, assicurarsi di avere installato tutti i prerequisiti SDK per app di Windows, incluso il pacchetto VSIX e NuGet più recente. Per ulteriori dettagli, vedere Installazione di strumenti per Windows App SDK.

In primo luogo, eseguire le seguenti operazioni:

  • Nel file con estensione wapproj, se TargetPlatformMinVersion è precedente a 10.0.17763.0, impostarlo su 10.0.17763.0.

  • I modelli di progetto predefiniti per le app C++ e C# includevano le righe seguenti. L'evento Application.Suspending non viene più richiesto per le app desktop, quindi assicurarsi di rimuovere queste righe (e qualsiasi altro uso di questo evento) se sono ancora presenti nel codice:

    this.Suspending += OnSuspending;
    
    Suspending({ this, &App::OnSuspending });
    

Apportare quindi queste modifiche al progetto:

  1. In Visual Studio passare a Strumenti>Gestione pacchetti NuGet>Console di Gestione pacchetti.

  2. Immettere i comandi seguenti:

    uninstall-package Microsoft.WinUI -ProjectName {yourProject}
    install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}
    
  3. Apportare le modifiche seguenti nell'applicazione (package).wapproj:

    1. Aggiungere questa sezione:

      <ItemGroup>
        <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
          <IncludeAssets>build</IncludeAssets>
        </PackageReference>
      </ItemGroup>
      
    2. Rimuovere le righe seguenti:

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
      
      <Import Project="$(AppxTargetsLocation)Microsoft.WinUI.AppX.targets" />
      
  4. Eliminare il file esistente Microsoft.WinUI.AppX.targets nella cartella {YourProject}(package)/build/ del progetto.