Partager via

Utiliser le SDK d’application Windows dans un projet existant

  • Article

Si vous avez un projet de bureau dans lequel vous souhaitez utiliser le Kit de développement logiciel (SDK) d’application Windows, vous pouvez installer le package NuGet du SDK d’application Windows dans votre projet (la dernière version ou toute version dont vous avez besoin). Les applications non empaquetées (autrement dit, les applications qui n’utilisent pas MSIX pour leur technologie de déploiement) doivent suivre cette procédure s’ils utilisent le Kit de développement logiciel (SDK) d’application Windows. Mais les applications empaquetées peuvent également le faire.

Important

Si vous utilisez une application UWP, consultez Migrer d’UWP vers le SDK d’application Windows.

Remarque

Cette procédure est prise en charge dans les projets C# .NET 6 (et versions ultérieures) et les projets de bureau C++. Ces types de projets peuvent utiliser des packages NuGet à partir du canal de mise en production stable, du canal de version préliminaire ou du canal de mise en production expérimentale.

Prérequis

Instructions

  1. Ouvrez un projet existant dans Visual Studio.

    Remarque

    Si vous avez un projet de bureau C#, vérifiez que l’élément TargetFramework dans le fichier projet est défini sur un moniker spécifique à Windows 10 (par exemple, net6.0-windows10.0.19041.0) afin de pouvoir appeler des API Windows Runtime. Pour plus d’informations, consultez Appeler les API Windows Runtime dans les applications de bureau. En outre, vous devez cibler 18362 ou version ultérieure, car il existe un problème connu bloquant les applications qui ciblent 17763 (consultez erreurs de build lors de l’utilisation du TFM de 17763 sur GitHub).

  2. Vérifiez que les références de package sont activées :

    1. Dans Visual Studio, cliquez sur Outils>Gestionnaire de package NuGet>Paramètres du Gestionnaire de package.
    2. Vérifiez que PackageReference est sélectionné pour le format de gestion de package par défaut.

  3. Cliquez avec le bouton droit sur votre projet dans l’Explorateur de solutions, puis sélectionnez Gérer les packages NuGet.

  4. Dans la fenêtre NuGet Gestionnaire de package, cochez la case Inclure la préversion en haut de la fenêtre, sélectionnez l’onglet Parcourir et recherchez l’un des packages suivants :

    • Pour installer l’une des versions 1.0 ou ultérieures, recherchez le package Microsoft.WindowsAppSDK .
    • Pour installer l’une des versions 0.8, recherchez le package Microsoft.ProjectReunion .

  5. Une fois que vous avez trouvé le package NuGet du Kit de développement logiciel (SDK) d’application Windows approprié, sélectionnez le package, puis cliquez sur Installer dans le volet droit de la fenêtre Gestionnaire de package NuGet.

    Capture d’écran du package NuGet du Kit de développement logiciel (SDK) d’application Windows en cours d’installation

    Remarque

    Le package NuGet du Kit de développement logiciel (SDK) d’application Windows contient d’autres sous-packages (y compris Microsoft.WindowsAppSDK.Foundation, Microsoft.WindowsAppSDK.WinUI, etc.) qui contiennent les implémentations pour des composants spécifiques dans le Kit de développement logiciel (SDK) d’application Windows. Vous ne pouvez pas installer ces sous-packages individuellement pour référencer uniquement certains composants de votre projet. Vous devez installer le package NuGet du Kit de développement logiciel (SDK) d’application Windows principal, qui inclut tous les composants.

  6. Pour les applications non empaquetées uniquement. Avant que votre application non empaquetée puisse utiliser les API et les composants du SDK d’application Windows, votre application doit d’abord charger le runtime du SDK d’application Windows pour référencer le package d’infrastructure du Kit de développement logiciel (SDK) d’application Windows. Pour plus d’informations, consultez Utiliser le runtime du Kit de développement logiciel (SDK) d’application Windows pour les applications empaquetées avec un emplacement externe ou unpackaged et tutoriel : Utilisez l’API de programme d’amorçage dans une application empaquetée avec un emplacement externe ou non empaquetée qui utilise le Kit de développement logiciel (SDK) d’application Windows.

  7. Votre application peut désormais utiliser les API et composants du Kit de développement logiciel (SDK) d’application Windows disponibles dans le canal de mise en production que vous avez installé. Pour obtenir la liste des fonctionnalités disponibles, consultez les canaux de mise en production.

Plus d’informations

Si votre projet existant est un projet C++ et que vous souhaitez appeler des API Windows Runtime dans le Kit de développement logiciel (SDK) d’application Windows, vous devez ajouter la prise en charge de C++/WinRT. Consultez la prise en charge de Visual Studio pour C++/WinRT, XAML, l’extension VSIX et le package NuGet. Recherchez des informations sur le package NuGet Microsoft.Windows.CppWinRT. Sans ce package, votre projet ne pourra pas trouver les fichiers d’en-tête d’espace de noms pour les API Windows Runtime dans le Kit de développement logiciel (SDK) d’application Windows.

Si vous rencontrez une erreur de classe non inscrite lorsque vous essayez d’utiliser un composant sdk d’application Windows, vous devrez peut-être ajouter à votre projet une dépendance dynamique sur le package Du Kit de développement logiciel (SDK) d’application Windows. Pour plus d’informations, consultez les packages d’infrastructure MSIX et les dépendances dynamiques.

Voir aussi