Utiliser le SDK d’application Windows dans un projet existant

Si vous avez un projet de bureau WPF, WinForms ou Win32 dans lequel vous souhaitez utiliser des fonctionnalités du SDK d'application Windows, vous pouvez installer le package NuGet SDK d'application Windows dans votre projet.

Prérequis

Avant d’installer et d’utiliser le package NuGet SDK d'application Windows dans votre application, vérifiez que ces exigences sont remplies :

Les instructions

  1. Ouvrez un projet WPF, WinForms ou Win32 existant dans Visual Studio. Vérifiez qu'il est configuré pour Call Windows Runtime API.

  2. Dans Visual Studio, ouvrez le NuGet Gestionnaire de package :

    1. Cliquez sur Tools > NuGet Gestionnaire de package > Gérer les packages NuGet pour la solution... .
      –OU–
    2. Cliquez avec le bouton droit sur votre projet dans Explorateur de solutions et choisissez Manage NuGet Packages for Solution... .

  3. Dans la fenêtre NuGet Gestionnaire de package sélectionnez l’onglet Browse et recherchez le package suivant :

    • Microsoft. WindowsAppSDK.

  4. Une fois que vous avez trouvé le package NuGet approprié SDK d'application Windows, cochez la case dans le volet droit de la fenêtre NuGet Gestionnaire de package en regard du projet où vous souhaitez installer le package, puis cliquez sur Install.

    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. En général, nous vous recommandons d’installer le package NuGet principal SDK d'application Windows, qui inclut tous les composants. Dans certains cas, vous pouvez installer un sous-package individuellement pour référencer uniquement certains composants de votre projet. Par exemple, consultez Installer et déployer Windows ML.

Étapes supplémentaires pour les applications non empaquetées

Si votre application n’est pas empaquetée (les applications de bureau sont par défaut), certaines étapes supplémentaires sont nécessaires pour utiliser le SDK d'application Windows.

Pour plus d’informations sur les termes empaquetés et non empaquetés, consultez vue d’ensemble de l’empaquetage.

1. Installer le runtime SDK d'application Windows

Le runtime SDK d'application Windows doit être installé sur n’importe quel ordinateur sur lequel l’application s’exécutera.

Pour votre ordinateur de développement, nous vous recommandons de visiter les dernières versions du SDK d'application Windows, puis de télécharger, décompresser et exécuter l’une des opérations suivantes :

  • Dernière version stable sous téléchargements de runtime.
  • Canal de version et de mise en production du runtime qui correspond à la version et au canal de mise en production du Microsoft. WindowsAppSDK package NuGet que vous avez installé.

Choisissez l’option Programme d’installation appropriée pour l’architecture de votre ordinateur.

Important

Une fois votre application déployée, vous serez responsable du déploiement des packages d’exécution requis SDK d'application Windows à vos utilisateurs finaux. Pour plus d’informations, consultez SDK d'application Windows guide de déploiement pour les applications dépendantes de l’infrastructure empaquetées avec emplacement externe ou non empaquetées.

2. Initialiser le runtime SDK d'application Windows

Par défaut, une application de bureau WPF, WinForms ou Win32 n’est pas empaquetée. Une application non packagée doit initialiser le runtime du SDK d'application Windows avant d’utiliser toute autre fonctionnalité du SDK d'application Windows.

Vous pouvez le faire automatiquement au démarrage de votre application via l’auto-initialisation.

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit de la souris sur votre projet et choisissez Modifier le fichier de projet.

  2. À l’intérieur de l’élément PropertyGroup, ajoutez un élément WindowsPackageType réglé sur None.

<WindowsPackageType>None</WindowsPackageType>

Lorsque vous générez votre projet, ces fichiers sont ajoutés à votre projet dans Visual Studio :

  • MddBootstrapAutoInitializer.cs
  • WindowsAppSDK-VersionInfo.cs

  1. Modifiez manuellement votre fichier .cxproj.

  2. À l’intérieur de l’élément <PropertyGroup Label="Globals">, ajoutez un élément WindowsPackageType défini sur None.

<WindowsPackageType>None</WindowsPackageType>

Remarque

Si vous avez des besoins avancés (tels que la gestion des erreurs personnalisées ou pour charger une version spécifique du SDK d'application Windows), au lieu de auto-initialisation vous pouvez appeler explicitement l’API du programme d’amorçage, pour plus d’informations, consultez Utilisez le SDK d'application Windows runtime pour les applications empaquetées avec un emplacement externe ou unpackaged et Tutorial : Utilisez l’API de démarrage dans une application empaquetée avec un emplacement externe ou non empaquetée qui utilise le SDK d'application Windows.

Plus d’informations

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 au package du Kit de développement logiciel (SDK) pour applications Windows. Pour plus d’informations, consultez les packages d’infrastructure MSIX et les dépendances dynamiques.

Voir aussi

  • Last updated on