Portage vers la plateforme Windows universelle (C++)

  • Article

Dans cette rubrique, vous trouverez des informations sur le portage du code C++ existant vers la plateforme d’applications Windows, le plateforme Windows universelle. Ce que signifie le terme universel est que votre code peut s’exécuter sur n’importe quel appareil exécutant Windows 10 ou version ultérieure. Vous créez un projet unique et une interface utilisateur de base XAML unique qui fonctionne correctement sur n’importe quel appareil exécutant Windows 10 ou version ultérieure. Vous pouvez utiliser les fonctionnalités de disposition dynamique de XAML pour permettre à l'interface utilisateur de l'application de s'adapter à différentes tailles d'affichage.

La documentation du Centre de développement Windows contient un guide de portage d’applications Windows 8.1 vers la plateforme Windows universelle. Consultez Passer de Windows Runtime 8 à la plateforme Windows universelle. Bien que le guide soit axé essentiellement sur le code C#, la plupart des conseils sont applicables à C++. Les procédures suivantes contiennent des informations plus détaillées. Voir aussi Passer d’une application de bureau à UWP.

Cette rubrique contient les procédures suivantes relatives au portage de code vers la plateforme Windows universelle (UWP).

Si vous avez une DLL Win32 de bureau classique et que vous souhaitez l’appeler à partir d’une application UWP, c’est également possible. Ces procédures vous permettent de créer une couche d’interface utilisateur UWP pour une application C++ de bureau Windows classique existante ou votre code C++ standard multiplateforme. Consultez Guide pratique pour utiliser le code C++ existant dans une application de plateforme universelle Windows.

Portage d’une application du Windows Store Windows 8.1 vers UWP

Si vous disposez d’une application Windows 8.1 Store, vous pouvez utiliser cette procédure pour l’utiliser sur UWP et tout appareil exécutant Windows 10 ou version ultérieure. Il est judicieux de commencer par générer le projet avec Visual Studio 2019 en tant que projet Windows 8.1, afin d’abord d’éliminer les problèmes liés aux modifications apportées au compilateur et aux bibliothèques. Une fois que vous l’avez fait, il existe deux façons de le convertir en projet UWP Windows. Le moyen le plus simple (comme expliqué dans la procédure suivante) consiste à créer un projet Windows universel et à y copier votre code existant. Si vous utilisiez un projet universel pour la version de bureau de Windows 8.1 et pour Windows Phone 8.1, votre projet commencera avec deux dispositions différentes en XAML, mais finira avec une disposition dynamique unique qui s'adapte à la taille d'affichage.

Pour porter une application du Windows Store Windows 8.1 vers UWP

  1. Si ce n’est déjà fait, ouvrez votre projet d’application Windows 8.1 dans Visual Studio 2017 et suivez les instructions pour mettre à niveau le fichier projet.

    Vous devez avoir installé les Outils Windows 8.1 du programme d’installation de Visual Studio. Si ces outils ne sont pas installés, démarrez le programme d’installation de Visual Studio à partir de la fenêtre Programmes et fonctionnalités, choisissez Visual Studio 2017, puis dans la fenêtre d’installation, choisissez Modifier. Recherchez Outils Windows 8.1, vérifiez que l’option est sélectionnée, puis choisissez OK.

  2. Ouvrez la fenêtre Propriétés du projet et, sous C++>Général, affectez à la propriété Ensemble d’outils de plateforme la valeur v141, ce qui correspond à l’ensemble d’outils pour Visual Studio 2017.

  3. Générez le projet comme projet Windows 8.1 et résolvez les éventuelles erreurs de génération. À ce stade, les erreurs sont probablement dues à des modifications avec rupture dans les outils de génération et les bibliothèques. Pour obtenir une explication détaillée des modifications susceptibles d’affecter votre code, consultez Historique des modifications de Visual C++ entre 2003 et 2015.

    Une fois que votre projet est généré propre ly, vous êtes prêt à porter vers plateforme Windows universelle.

  4. Créez un projet d'application Windows universelle à l'aide du modèle Vierge. Vous souhaiterez peut-être lui donner le même nom que votre projet existant, bien que pour cela les projets doivent être dans des répertoires différents.

  5. Fermez la solution puis, à l’aide de l’Explorateur Windows ou de la ligne de commande, copiez les fichiers de code (avec les extensions .cpp, .h et .xaml) de votre projet Windows 8.1 vers le même dossier que le fichier projet (.vcxproj) du projet que vous avez créé à l’étape 1. Ne copiez pas le fichier Package.appxmanifest et, si vous avez du code distinct pour la version de bureau de Windows 8.1 et pour Windows Phone, choisissez l'une des deux versions à porter en premier (vous devrez effectuer certaines tâches ultérieurement pour adapter l'autre version). Veillez à copier les sous-dossiers et leur contenu. Si vous y êtes invité, choisissez de remplacer les fichiers ayant des noms dupliqués.

  6. Rouvrez la solution, puis choisissez Ajouter>Élément existant dans le menu contextuel du nœud de projet. Sélectionnez tous les fichiers que vous avez copiés, à l'exception de ceux qui font déjà partie du projet.

    Vérifiez tous les sous-dossiers et veillez à y ajouter également les fichiers.

  7. Si vous n’utilisez pas le même nom de projet que celui de votre ancien projet, ouvrez le fichier Package.appxmanifest et mettez à jour le point d’entrée pour refléter le nom de l’espace de noms de la classe App.

    Le champ Point d’entrée du fichier Package.appxmanifest contient un nom inclus dans l’étendue pour la classe App, qui comprend l’espace de noms contenant la classe App. Quand vous créez un projet d'application Windows universelle, l'espace de noms est défini sur le nom du projet. S'il diffère de ce qui figure dans les fichiers que vous avez copiés depuis votre ancien projet, vous devez mettre l'un ou l'autre à jour pour qu'ils correspondent.

  8. Générez le projet et résolvez les éventuelles erreurs de génération dues à des changements entre les différentes versions du Kit de développement logiciel Windows.

  9. Exécutez le projet sur le bureau local. Vérifiez qu'il n'y a aucune erreur de déploiement, que la disposition de l'application semble correcte et qu'elle fonctionne correctement sur le bureau.

  10. Si vous aviez des fichiers de code et .xaml distincts pour un autre appareil, tel que Windows Phone 8.1, examinez ce code et identifiez où il diffère de l'appareil standard. Si la différence concerne uniquement la disposition, vous pouvez éventuellement utiliser un gestionnaire d’état visuel dans le code xaml pour personnaliser l’affichage en fonction de la taille de l’écran. Pour les autres différences, vous pouvez utiliser des sections de conditions dans votre code en utilisant les instructions #if suivantes.

    #if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PC_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_PHONE_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP)
#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)

    Ces instructions s’appliquent respectivement aux applications UWP, aux applications du Windows Phone Store, aux deux ou bien aux applications de bureau Win32 classiques uniquement. Ces macros sont uniquement disponibles dans le Kit de développement logiciel (SDK) Windows 8.1 et versions ultérieures. Par conséquent, si votre code doit être compilé avec des versions antérieures du SDK Windows ou pour d'autres plateformes non-Windows, vous devez également vous préparer à l'éventualité qu'aucune de ces macros ne soit définie.

  11. Exécutez et déboguez l’application sur un émulateur ou un appareil physique pour chaque type d’appareil pris en charge par votre application. Pour exécuter un émulateur, vous devez exécuter Visual Studio sur un ordinateur physique, et non sur un ordinateur virtuel.

Portage d'un composant d'exécution Windows 8.1 vers UWP

Si vous disposez d’une DLL ou d’un composant Windows Runtime qui fonctionne déjà avec les applications du Windows 8.1 Store, vous pouvez utiliser cette procédure pour obtenir le composant ou la DLL qui fonctionne avec UWP sur Windows. La procédure de base consiste à créer un projet et à y copier votre code.

Pour porter un composant d'exécution Windows 8.1 vers UWP

  1. Dans la boîte de dialogue Nouveau projet dans Visual Studio 2017, localisez le nœud Windows universel. Si vous ne voyez pas ce nœud, installez d’abord le Kit de développement logiciel (SDK) Windows. Choisissez le modèle Composant Windows Runtime , donnez un nom à votre composant, puis choisissez le bouton OK . Le nom du composant sera utilisé comme nom de l’espace de noms. C’est pourquoi il est conseillé d’utiliser le même nom que celui de l’espace de noms de vos anciens projets. Pour ce faire, vous devez créer le projet dans un dossier autre que celui de l'ancien. Si vous choisissez un nom différent, vous pouvez mettre à jour le nom de l'espace de noms dans les fichiers de code générés.

  2. Fermez le projet.

  3. Copiez tous les fichiers de code (.cpp, .h, .xaml, etc.) de votre composant Windows 8.1 vers votre projet nouvellement créé. Ne copiez pas le fichier Package.appxmanifest.

  4. Générez le projet et résolvez toutes les erreurs dues à des modifications avec rupture entre les différentes versions du Kit de développement logiciel Windows (Kit SDK Windows).

Résolution des problèmes

Vous pouvez rencontrer différentes erreurs pendant le processus de déplacement de code vers la plateforme UWP. Voici quelques-uns des problèmes que vous pouvez rencontrer.

Problèmes de configuration de projet

L’erreur suivante peut s’afficher :

could not find assembly 'platform.winmd': please specify the assembly search path using /AI or by setting the LIBPATH environment variable

Dans ce cas, le projet n’est pas créé en tant que projet d’application Windows universelle. Vérifiez le fichier projet et assurez-vous qu’il comporte les éléments XML corrects qui identifient un projet comme projet d’application Windows universelle. Les éléments suivants doivent être présents (le numéro de version de la plateforme cible peut être différent) :

<AppContainerApplication>true</AppContainerApplication>
<ApplicationType>Windows Store</ApplicationType>
<WindowsTargetPlatformVersion>10.0.10156.0</WindowsTargetPlatformVersion>
<WindowsTargetPlatformMinVersion>10.0.10156.0</WindowsTargetPlatformMinVersion>
<ApplicationTypeRevision>10.0</ApplicationTypeRevision>

Si vous avez créé un projet UWP à l’aide de Visual Studio, vous ne devez pas voir cette erreur.

Voir aussi

Guide du portage de Visual C++
Développer des applications pour la plateforme Windows universelle (UWP)