Partager via

Mettre à jour des projets existants vers une version différente du Kit de développement logiciel (SDK) d’application Windows

Si vous avez créé un projet avec une version antérieure du Kit de développement logiciel (SDK) d’application Windows (précédemment appelé Project Reunion) ou 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 canal de distribution, consultez canaux de publication du Kit de développement logiciel (SDK) d’application Windows.

Remarque

Ces instructions peuvent rencontrer des problèmes en raison de l’unicité du scénario individuel de chaque application. Veuillez les suivre attentivement et, si vous rencontrez un problème, signalez un bug sur le dépôt GitHub microsoft-ui-xaml.

Mise à jour entre les versions publiées après la version 1.0

Si votre projet ne fait pas référence à la version du package NuGet du SDK d’application Windows dont vous avez besoin, vous pouvez utiliser le Gestionnaire de package NuGet dans Visual Studio pour mettre à jour les références de package NuGet de votre projet. Par exemple, si vous créez un projet à l’aide d’une version stable du Kit de développement logiciel (SDK) d’application Windows VSIX, votre projet référencera une version stable du Kit de développement logiciel (SDK) d’application Windows. Toutefois, vous pouvez facilement reconfigurer ce projet pour référencer, par exemple, une version expérimentale du Kit de développement logiciel (SDK) d’application Windows. Vous pouvez également le reconfigurer pour référencer la dernière version stable.

Pour connaître les étapes à suivre, consultez les instructions de l’article Utiliser le Kit de développement logiciel (SDK) d’application Windows dans un projet existant.

Mettre à jour de 0.8 à 1.0

Si vous avez créé un projet à l’aide de la version 0.8 (par exemple, 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 Kit de développement logiciel (SDK) d’application Windows. Pour plus d’informations, consultez Installer des outils pour le Kit de développement logiciel (SDK) d’application Windows.

Les instructions

  1. Dans le fichier .wapproj, si votre TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

  2. Dans Visual Studio, accédez à Tools>Gestionnaire de packages Nuget>Console du gestionnaire de packages. Ce processus consiste à désinstaller les références existantes au package Project Reunion des fichiers .csproj, /, .vcxproj et .wapproj, puis à installer les nouvelles références au package WindowsAppSDK dans ces mêmes fichiers.

  3. Entrez les commandes suivantes pour désinstaller les paquets existants ProjectReunion 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. Exécutez ensuite ce qui suit pour désinstaller les packages existants ProjectReunion à partir de votre .wapproj:

    uninstall-package Microsoft.ProjectReunion 
uninstall-package Microsoft.ProjectReunion.WinUI

  5. Exécutez maintenant les commandes pour installer le package stable WindowsAppSDK .

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

    install-package Microsoft.WindowsAppSDK -ProjectName {yourProject} -Version 1.0.0

  7. Pour ajouter la référence au package WindowsAppSDK à votre .wapproj :

    install-package Microsoft.WindowsAppSDK -Version 1.0.0

Mise à jour de la version préliminaire 0.8 ou 0.8 vers la version 1.0 Expérimentale ou Preview 3

Important

La version 1.0 Preview 1 et Preview 2 contiennent un bogue critique. Si vous avez déjà installé l’une de ces préversions, consultez un problème important impactant 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 à l’aide de la version 0.8 Preview ou d’une version de 0.8 (par exemple, version 0.8.1), vous pouvez suivre ces instructions pour mettre à jour votre projet vers la version 1.0 Preview 3 ou Expérimentale.

Avant de commencer, vérifiez que tous les prérequis du Kit de développement logiciel (SDK) d’application Windows sont installés, y compris le dernier package VSIX et NuGet. Pour plus d’informations, consultez Installer des outils pour le Kit de développement logiciel (SDK) d’application Windows.

Tout d’abord, procédez comme suit :

  • Dans le fichier .wapproj, si votre TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

Ensuite, apportez ces modifications à votre projet :

  1. Dans Visual Studio, accédez à Tools>Gestionnaire de packages Nuget>Console du gestionnaire de packages.

  2. Entrez les commandes suivantes pour 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 Expérimental :

    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 dans votre application (package).wapproj :

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

      <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’éléments 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 bien ce groupe d’éléments à remplacer par 1.0 expérimental :

      <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 au 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 0.8.0, vous verrez que le numéro de version correspondant référencé dans ce groupe d’éléments) s’affiche :

      <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’éléments 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 bien ce groupe d’éléments à remplacer par 1.0 expérimental :

      <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 parvient pas à générer, nettoyez la sortie de build, redémarrez Visual Studio et essayez de réexéciser l’application.

Mise à jour de la version préliminaire 0.8 vers la version 0.8 ou entre les versions stables de 0.8

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

Remarque

Vous pouvez peut-être mettre à jour automatiquement votre projet via le Gestionnaire d’extensions Visual Studio, sans passer par les étapes manuelles ci-dessous. Dans Visual Studio 2019, cliquez sur Extensions> et sélectionnez Mises à jour dans la barre de menus de gauche. Sélectionnez « Project Reunion » dans la liste, puis cliquez sur Mettre à jour.

Avant de commencer, vérifiez que tous les prérequis du Kit de développement logiciel (SDK) d’application Windows sont installés, y compris le dernier package VSIX et NuGet. Pour plus d’informations, consultez Installer des outils pour le Kit de développement logiciel (SDK) d’application Windows.

Tout d’abord, procédez comme suit :

  • Dans le fichier .wapproj, si votre TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

Ensuite, apportez ces modifications à votre projet :

  1. Dans Visual Studio, accédez à Tools>Gestionnaire de packages Nuget>Console du gestionnaire de packages.

  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 dans 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 préversion 0.8, vous verrez que le numéro de version correspondant référencé dans ce groupe d’éléments) est le suivant :

      <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 au 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 préversion 0.8, vous verrez que le numéro de version correspondant référencé dans ce groupe d’éléments) est le suivant : 
      <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 parvient pas à générer, nettoyez la sortie de build, redémarrez Visual Studio et essayez de réexéciser l’application.

Mettre à jour de 0.5 à 0.8

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

Remarque

Vous pouvez peut-être mettre à jour automatiquement votre projet via le Gestionnaire d’extensions Visual Studio, sans passer par les étapes manuelles ci-dessous. Dans Visual Studio 2019, cliquez sur Extensions> et sélectionnez Mises à jour dans la barre de menus de gauche. Sélectionnez « Project Reunion » dans la liste, puis cliquez sur Mettre à jour.

Avant de commencer, vérifiez que tous les prérequis du Kit de développement logiciel (SDK) d’application Windows sont installés, y compris le dernier package VSIX et NuGet. Pour plus d’informations, consultez Installer des outils pour le Kit de développement logiciel (SDK) d’application Windows.

Tout d’abord, procédez comme suit :

  • Dans le fichier .wapproj, si votre TargetPlatformMinVersion est antérieur à 10.0.17763.0, remplacez-le par 10.0.17763.0.

Ensuite, apportez ces modifications à votre projet :

  1. Dans Visual Studio, accédez à Tools>Gestionnaire de packages Nuget>Console du gestionnaire de packages.

  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 au fichier de projet (.csproj ou .vcproj), à l’intérieur du premier <PropertyGroup>:

    <UseWinUI>true</UseWinUI>

  4. Apportez les modifications suivantes dans votre application (package).wapproj :

    1. Ajoutez cette section :

      <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 <TargetPlatformVersion> balise.

    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 parvient pas à générer, nettoyez la sortie de build, redémarrez Visual Studio et essayez de réexéciser l’application.

Mise à jour de la préversion 0.5 vers la préversion 0.8

Si vous avez créé un projet à l’aide de la préversion version 0.5, vous pouvez suivre ces instructions pour mettre à jour votre projet afin d’utiliser la version 0.8 en préversion.

Remarque

Vous pouvez peut-être mettre à jour automatiquement votre projet via le Gestionnaire d’extensions Visual Studio, sans passer par les étapes manuelles ci-dessous. Dans Visual Studio 2019, cliquez sur Extensions> et sélectionnez Mises à jour dans la barre de menus de gauche. Sélectionnez « Project Reunion » dans la liste, puis cliquez sur Mettre à jour.

Avant de commencer, vérifiez que tous les prérequis du Kit de développement logiciel (SDK) d’application Windows sont installés, y compris le dernier package VSIX et NuGet. Pour plus d’informations, consultez Installer des outils pour le Kit de développement logiciel (SDK) d’application Windows.

Tout d’abord, procédez comme suit :

  • Dans le fichier .wapproj, si votre 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# incluent 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) s’ils sont toujours présents dans votre code :

    this.Suspending += OnSuspending;

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

Ensuite, apportez ces modifications à votre projet :

  1. Dans Visual Studio, accédez à Tools>Gestionnaire de packages Nuget>Console du gestionnaire de packages.

  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 dans votre application (package).wapproj :

    1. Ajoutez cette section :

      <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 <TargetPlatformVersion> balise.

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

    3. Supprimez cette ligne :

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

      Et ces lignes :

      <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 au 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 parvient pas à générer, nettoyez la sortie de build, redémarrez Visual Studio et essayez de réexéciser l’application.

Mise à jour de la version préliminaire 0.5 vers la version 0.5

Si vous avez créé un projet à l’aide de la préversion de la version 0.5, vous pouvez suivre ces instructions pour mettre à jour votre projet vers la version stable 0.5.7.

Avant de commencer, vérifiez que tous les prérequis du Kit de développement logiciel (SDK) d’application Windows sont installés, y compris le dernier package VSIX et NuGet. Pour plus d’informations, consultez Installer des outils pour le Kit de développement logiciel (SDK) d’application Windows.

Tout d’abord, procédez comme suit :

  • [Applications de bureau uniquement] Dans le fichier .wapproj, si votre 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# incluent 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) s’ils sont toujours présents dans votre code :

    this.Suspending += OnSuspending;

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

Ensuite, apportez ces modifications à votre projet :

  1. Dans Visual Studio, accédez à Tools>Gestionnaire de packages Nuget>Console du gestionnaire de packages.

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

    1. Ajoutez cette section :

      <ItemGroup>
    <PackageReference Include="Microsoft.ProjectReunion" Version="[0.5.7]">
        <IncludeAssets>build</IncludeAssets>
    </PackageReference>
</ItemGroup>

    2. Recherchez la <TargetPlatformVersion> balise 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 ces lignes :

      <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 à l’aide de WinUI 3 Preview 4, vous pouvez suivre ces instructions pour mettre à jour votre projet vers Project Reunion 0.5.

Avant de commencer, vérifiez que tous les prérequis du Kit de développement logiciel (SDK) d’application Windows sont installés, y compris le dernier package VSIX et NuGet. Pour plus d’informations, consultez Installer des outils pour le Kit de développement logiciel (SDK) d’application Windows.

Tout d’abord, procédez comme suit :

  • Dans le fichier .wapproj, si votre 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# incluent 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) s’ils sont toujours présents dans votre code :

    this.Suspending += OnSuspending;

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

Ensuite, apportez ces modifications à votre projet :

  1. Dans Visual Studio, accédez à Tools>Gestionnaire de packages Nuget>Console du gestionnaire de packages.

  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 dans votre application (package).wapproj :

    1. Ajoutez cette section :

      <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 existant Microsoft.WinUI.AppX.targets sous le dossier {YourProject}(package)/build/ de votre projet.