Partager via


Mettre à jour des projets existants vers une version différente du SDK d'applications Windows

Si vous avez créé un projet avec une version antérieure du SDK d'applications Windows (anciennement appelé Project Reunion) ou de WinUI 3, vous pouvez mettre à jour le projet pour utiliser une version plus récente. Pour en savoir plus sur ce qui est actuellement disponible dans chaque chaîne de publication, consultez les chaînes de publication du SDK d'applications Windows.

Remarque

Ces instructions peuvent se heurter à des problèmes en raison du caractère unique du scénario individuel de chaque application. Veuillez les suivre attentivement. Si vous trouvez un problème, veuillez déposer un bogue sur le référentiel GitHub de microsoft-ui-xaml.

Mise à jour entre les versions postérieures à la version 1.0

Si votre projet ne fait pas référence à la version du package NuGet du SDK d'applications Windows dont vous avez besoin, vous pouvez utiliser le gestionnaire de packages NuGet dans Visual Studio pour mettre à jour les références du package NuGet de votre projet. Par exemple, si vous créez un nouveau projet en utilisant une version stable du SDK d'applications Windows VSIX, votre projet fera référence à une version stable du SDK d'applications Windows. Mais vous pouvez facilement reconfigurer ce projet pour qu'il fasse référence, par exemple, à une version expérimentale du SDK d'applications Windows. Ou reconfigurez-le pour qu'il fasse référence à la dernière version stable.

Pour connaître la marche à suivre, consultez les instructions de la section Utiliser le SDK d'applications Windows dans un projet existant.

Mise à jour de 0.8 à 1.0

Si vous avez créé un projet avec la version 0.8 (par exemple, la version 0.8.4), vous pouvez suivre ces instructions pour mettre à jour votre projet vers la version 1.0.

Prérequis : Téléchargez et installez la dernière version du SDK d'applications Windows. Pour plus d’informations, consultez Installer des outils pour le SDK d’application Windows.

Instructions

  1. Dans le fichier .wapproj, si votre TargetPlatformMinVersion est plus ancien que 10.0.17763.0, remplacez-le par 10.0.17763.0.

  2. Dans Visual Studio : Accédez à Outils>Gestionnaire de package NuGet>Console du Gestionnaire de package. Ce processus consiste à désinstaller les références des packages de Project Reunion existants dans les fichiers .csproj/.vcxproj et .wapproj, puis à installer les références des packages WindowsAppSDK dans ces fichiers.

  3. Saisissez les commandes suivantes pour désinstaller les packages ProjectReunion existants de votre .csproj/.vcxproj.

    uninstall-package Microsoft.ProjectReunion -ProjectName {yourProject} 
    uninstall-package Microsoft.ProjectReunion.Foundation -ProjectName {yourProject}
    uninstall-package Microsoft.ProjectReunion.WinUI -ProjectName {yourProject}
    
  4. Ensuite, exécutez ce qui suit pour désinstaller les packages ProjectReunion existants de votre .wapproj :

    uninstall-package Microsoft.ProjectReunion 
    uninstall-package Microsoft.ProjectReunion.WinUI
    
  5. Exécutez maintenant les commandes pour installer le package WindowsAppSDK stable.

  6. Pour ajouter la référence du package WindowsAppSDK à votre .csproj/.vcxproj :

    install-package Microsoft.WindowsAppSDK -ProjectName {yourProject} -Version 1.0.0
    
  7. Pour ajouter la référence du package WindowsAppSDK à votre .wapproj :

    install-package Microsoft.WindowsAppSDK -Version 1.0.0 
    

Mise à jour de 0.8 ou 0.8 Preview vers 1.0 Experimental ou Preview 3

Important

La version 1.0 Aperçu 1 et Aperçu 2 contiennent un bogue critique. Si vous avez déjà installé l'une de ces versions, consultez la section Problème important affectant la version 1.0 Preview 1 et Preview 2. Nous vous recommandons d'utiliser la version 1.0 Preview 3 (1.0.0-preview3) à la place.

Si vous avez créé un projet en utilisant la version 0.8 Preview ou toute autre version de 0.8 (par exemple, la version 0.8.1), vous pouvez suivre ces instructions pour mettre à jour votre projet vers la version 1.0 Preview 3 ou Experimental.

Avant de commencer, assurez-vous que tous les prérequis du SDK d'applications Windows sont installés, y compris le dernier VSIX et le package NuGet. Pour plus de détails, voir Installer les outils pour le SDK d'applications Windows.

Commencez par faire ce qui suit :

  • Dans le fichier .wapproj, si le paramètre de version TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

Apportez ensuite les modifications suivantes à votre projet :

  1. Dans Visual Studio : Accédez à Outils>Gestionnaire de package NuGet>Console du Gestionnaire de package.

  2. Saisissez les commandes suivantes pour la version 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}
    

    Ou les commandes suivantes pour 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. Apportez les modifications suivantes à votre application (package).wapproj :

    1. Supprimez ce groupe d'éléments (si vous effectuez une mise à jour à partir d'une version différente de la 0.8.0, vous verrez le numéro de version correspondant référencé dans ce groupe d'éléments) :

      <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. Ajoutez ce groupe d'articles pour le remplacer par la version 1.0 Preview 3 :

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

      Ou ce groupe d'articles pour le remplacer par 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. Apportez les modifications suivantes à votre fichier de projet (.csproj ou .vcproj) :

    1. Supprimez ce groupe d'éléments (si vous effectuez une mise à jour à partir d'une version différente de la 0.8.0, vous verrez le numéro de version correspondant référencé dans ce groupe d'éléments) :

      <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. Ajoutez ce groupe d'articles pour le remplacer par la version 1.0 Preview 3 :

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

      Ou ce groupe d'articles pour le remplacer par 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. Si votre solution ne se compile pas, nettoyez la sortie de compilation, redémarrez Visual Studio et essayez de réexécuter l'application.

Mise à jour de la version 0.8 Preview vers la version 0.8 ou entre les versions stables de la version 0.8

Si vous avez créé un projet en utilisant la version 0.8 Preview, vous pouvez suivre ces instructions pour mettre à jour votre projet vers une version stable de la 0.8. Ces instructions s'appliquent également si vous avez créé un projet avec une ancienne version stable de 0.8 (par exemple, 0.8.0) et que vous souhaitez mettre à jour votre projet vers une version stable plus récente (par exemple, 0.8.2).

Remarque

Il se peut que vous puissiez mettre à jour automatiquement votre projet via le gestionnaire d'extensions de Visual Studio, sans passer par les étapes manuelles ci-dessous. Dans Visual Studio 2019, cliquez sur Extensions>Gestion des extensions et sélectionnez Mises à jour dans la barre de menu de gauche. Sélectionnez "Project Reunion" dans la liste et cliquez sur Mettre à jour.

Avant de commencer, assurez-vous que tous les prérequis du SDK d'applications Windows sont installés, y compris le dernier VSIX et le package NuGet. Pour plus de détails, voir Installer les outils pour le SDK d'applications Windows.

Commencez par faire ce qui suit :

  • Dans le fichier .wapproj, si le paramètre de version TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

Apportez ensuite les modifications suivantes à votre projet :

  1. Dans Visual Studio : Accédez à Outils>Gestionnaire de package NuGet>Console du Gestionnaire de package.

  2. Entrez les commandes suivantes :

    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. Apportez les modifications suivantes à votre application (package).wapproj :

    1. Supprimez ce groupe d'éléments (si vous effectuez une mise à jour à partir d'une version différente de la 0.8 Preview, vous verrez le numéro de version correspondant référencé dans ce groupe d'éléments) :

      <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. Ajoutez ce groupe d'éléments pour le remplacer :

      <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. Apportez les modifications suivantes à votre fichier de projet (.csproj ou .vcproj) :

    1. Supprimez ce groupe d'éléments (si vous effectuez une mise à jour à partir d'une version différente de la 0.8 Preview, vous verrez le numéro de version correspondant référencé dans ce groupe d'éléments) :
      <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. Ajoutez ce groupe d'éléments pour le remplacer :
      <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. Si votre solution ne se compile pas, nettoyez la sortie de compilation, redémarrez Visual Studio et essayez de réexécuter l'application.

Mise à jour de 0.5 à 0.8

Si vous avez créé un projet en utilisant la version 0.5 stable, vous pouvez suivre ces instructions pour mettre à jour votre projet vers une version stable de la 0.8.

Remarque

Il se peut que vous puissiez mettre à jour automatiquement votre projet via le gestionnaire d'extensions de Visual Studio, sans passer par les étapes manuelles ci-dessous. Dans Visual Studio 2019, cliquez sur Extensions>Gestion des extensions et sélectionnez Mises à jour dans la barre de menu de gauche. Sélectionnez "Project Reunion" dans la liste et cliquez sur Mettre à jour.

Avant de commencer, assurez-vous que tous les prérequis du SDK d'applications Windows sont installés, y compris le dernier VSIX et le package NuGet. Pour plus de détails, voir Installer les outils pour le SDK d'applications Windows.

Commencez par faire ce qui suit :

  • Dans le fichier .wapproj, si le paramètre de version TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

Apportez ensuite les modifications suivantes à votre projet :

  1. Dans Visual Studio : Accédez à Outils>Gestionnaire de package NuGet>Console du Gestionnaire de package.

  2. Entrez les commandes suivantes :

    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. Ajoutez la ligne suivante à votre fichier de projet (.csproj ou .vcproj), à l'intérieur de la première ligne <PropertyGroup>:

    <UseWinUI>true</UseWinUI>
    
  4. Apportez les modifications suivantes à votre application (package).wapproj :

    1. Ajoutez la section suivante :

      <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. Recherchez la ligne suivante :

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

      Déplacez cette ligne et placez-la sur une nouvelle ligne directement sous la balise <TargetPlatformVersion>.

    3. Supprimez ce groupe d'éléments (si vous effectuez une mise à jour à partir d'une version antérieure à 0.5.7, vous verrez un numéro de version antérieur référencé dans ce groupe d'éléments) :

      <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. Si votre solution ne se compile pas, nettoyez la sortie de compilation, redémarrez Visual Studio et essayez de réexécuter l'application.

Mise à jour de la version 0.5 Preview à la version 0.8 Preview

Si vous avez créé un projet en utilisant la version 0.5 preview, vous pouvez suivre ces instructions pour mettre à jour votre projet en utilisant la version 0.8 preview.

Remarque

Il se peut que vous puissiez mettre à jour automatiquement votre projet via le gestionnaire d'extensions de Visual Studio, sans passer par les étapes manuelles ci-dessous. Dans Visual Studio 2019, cliquez sur Extensions>Gestion des extensions et sélectionnez Mises à jour dans la barre de menu de gauche. Sélectionnez "Project Reunion" dans la liste et cliquez sur Mettre à jour.

Avant de commencer, assurez-vous que tous les prérequis du SDK d'applications Windows sont installés, y compris le dernier VSIX et le package NuGet. Pour plus de détails, voir Installer les outils pour le SDK d'applications Windows.

Commencez par faire ce qui suit :

  • Dans le fichier .wapproj, si le paramètre de version TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

  • Les modèles de projet par défaut pour les applications C++ et C# comprenaient les lignes suivantes. L'événement Application.Suspending n'est plus appelé pour les applications de bureau, veillez donc à supprimer ces lignes (et toute autre utilisation de cet événement) si elles sont encore présentes dans votre code :

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

Apportez ensuite les modifications suivantes à votre projet :

  1. Dans Visual Studio : Accédez à Outils>Gestionnaire de package NuGet>Console du Gestionnaire de package.

  2. Entrez les commandes suivantes :

    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. Apportez les modifications suivantes à votre application (package).wapproj :

    1. Ajoutez la section suivante :

      <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. Ajoutez la ligne suivante à une nouvelle ligne directement sous la balise <TargetPlatformVersion>.

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
      
    3. Supprimez cette ligne :

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

      Et les lignes suivantes :

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

      Et ce groupe d’éléments :

      <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. Apportez les modifications suivantes à votre fichier de projet (.csproj ou .vcproj) :

    1. Supprimez ce groupe d'éléments :

      <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. Ajoutez ce groupe d'éléments :

      <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. Si votre solution ne se compile pas, nettoyez la sortie de compilation, redémarrez Visual Studio et essayez de réexécuter l'application.

Mise à jour de la version 0.5 Preview à la version 0.5

Si vous avez créé un projet en utilisant la version 0.5 Preview, vous pouvez suivre ces instructions pour mettre à jour votre projet vers une version stable de la 0.5.7.

Avant de commencer, assurez-vous que tous les prérequis du SDK d'applications Windows sont installés, y compris le dernier VSIX et le package NuGet. Pour plus de détails, voir Installer les outils pour le SDK d'applications Windows.

Commencez par faire ce qui suit :

  • [Applications de bureau uniquement].Dans le fichier .wapproj, si le paramètre de version TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

  • Les modèles de projet par défaut pour les applications C++ et C# comprenaient les lignes suivantes. L'événement Application.Suspending n'est plus appelé pour les applications de bureau, veillez donc à supprimer ces lignes (et toute autre utilisation de cet événement) si elles sont encore présentes dans votre code :

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

Apportez ensuite les modifications suivantes à votre projet :

  1. Dans Visual Studio : Accédez à Outils>Gestionnaire de package NuGet>Console du Gestionnaire de package.

  2. Entrez les commandes suivantes :

    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. Si vous avez une application UWP, votre processus de mise à jour devrait être terminé à ce stade. Si vous avez une application de bureau, apportez les modifications suivantes à votre Application (package).wapproj :

    1. Ajoutez la section suivante :

      <ItemGroup>
          <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
              <IncludeAssets>build</IncludeAssets>
          </PackageReference>
      </ItemGroup>
      
    2. Localisez la balise <TargetPlatformVersion> et ajoutez ce qui suit sur une nouvelle ligne directement sous cette balise

      <AssetTargetFallback>net5.0-windows$(TargetPlatformVersion);$(AssetTargetFallback)</AssetTargetFallback>
      
    3. Supprimez cette ligne :

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

      Et les lignes suivantes :

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

      Et ce groupe d’éléments :

      <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>
      

Mise à jour de WinUI 3 Preview 4 à 0.5

Si vous avez créé une application de bureau en utilisant WinUI 3 Preview 4, vous pouvez suivre ces instructions pour mettre à jour votre projet vers Project Reunion 0.5.

Avant de commencer, assurez-vous que tous les prérequis du SDK d'applications Windows sont installés, y compris le dernier VSIX et le package NuGet. Pour plus de détails, voir Installer les outils pour le SDK d'applications Windows.

Commencez par faire ce qui suit :

  • Dans le fichier .wapproj, si le paramètre de version TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

  • Les modèles de projet par défaut pour les applications C++ et C# comprenaient les lignes suivantes. L'événement Application.Suspending n'est plus appelé pour les applications de bureau, veillez donc à supprimer ces lignes (et toute autre utilisation de cet événement) si elles sont encore présentes dans votre code :

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

Apportez ensuite les modifications suivantes à votre projet :

  1. Dans Visual Studio : Accédez à Outils>Gestionnaire de package NuGet>Console du Gestionnaire de package.

  2. Entrez les commandes suivantes :

    uninstall-package Microsoft.WinUI -ProjectName {yourProject}
    install-package Microsoft.ProjectReunion -Version 0.5.7 -ProjectName {yourProjectName}
    
  3. Apportez les modifications suivantes à votre application (package).wapproj :

    1. Ajoutez la section suivante :

      <ItemGroup>
        <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
          <IncludeAssets>build</IncludeAssets>
        </PackageReference>
      </ItemGroup>
      
    2. Supprimez les lignes suivantes :

      <AppxTargetsLocation Condition="'$(AppxTargetsLocation)'==''">$(MSBuildThisFileDirectory)build\</AppxTargetsLocation>
      
      <Import Project="$(AppxTargetsLocation)Microsoft.WinUI.AppX.targets" />
      
  4. Supprimez le fichier Microsoft.WinUI.AppX.targets existant dans le dossier {YourProject}(package)/build/ de votre projet.