Partager via

Migrer d’UWP vers le SDK d’application Windows

  • Article

Pour migrer votre application de l’plateforme Windows universelle (UWP) vers le Kit de développement logiciel (SDK) d’application Windows, votre code d’interface utilisateur a probablement besoin de quelques modifications d’espace de noms, tandis que la plupart de votre code de plateforme peuvent rester identiques. Vous devrez ajuster certains codes en raison des différences entre les applications UWP et les applications bureautiques. Mais nous pensons que pour la plupart des applications (en fonction de la taille de la base de code, bien sûr), la migration prendra quelques jours plutôt que des semaines.

Remarque

Votre application UWP existante continuera de fonctionner comme prévu. Toutefois, pour tirer parti des fonctionnalités modernes dans WinUI 3 et le Kit de développement logiciel (SDK ) d’application Windows, nous vous recommandons de migrer votre application.

Vous trouverez ci-dessous les étapes, à un niveau élevé, pour la migration manuelle. Pour plus d’informations sur l’utilisation de l’outil Assistant Mise à niveau .NET, consultez la section suivante.

  1. Créez un projet de bureau empaqueté WinUI 3 (reportez-vous à Créer votre premier projet WinUI 3). Cela peut entrer dans la solution existante de votre projet.
  2. Copiez votre code XAML/IU. Dans de nombreux cas, il vous suffit de modifier les espaces de noms (par exemple, Windows.UI.* vers Microsoft.UI.*).
  3. Copiez votre code logique d’application. Certaines API ont besoin d’ajustements, comme Popup, Pickers et SecondaryTiles.

Pour en savoir plus, reportez-vous aux sujets figurant dans le tableau ci-dessous. Vous trouverez une présentation détaillée des étapes de migration manuelle de votre application de plateforme Windows universelle (UWP) vers le kit de développement logiciel (SDK) d’application Windows.

Prenez particulièrement note de la rubrique Ce qui est pris en charge lors de la migration de UWP vers WinUI 3, qui décrit toute fonctionnalité qui n'est pas encore prise en charge par WinUI 3 et le SDK d'application Windows. Si votre application a besoin de l’une de ces fonctionnalités/bibliothèques, vous pouvez envisager de postponser la migration.

Remarque

Si le code source de votre application UWP est écrit en C++/CX, consultez également Déplacer vers C++/WinRT à partir de C++/CX.

Migration à l’aide de l’outil Assistant Mise à niveau .NET

Pour vous permettre de migrer vos applications UWP vers le kit SDK d’application Windows et WinUI 3, nous nous sommes servis de l’assistant de mise à niveau .NET, en ajoutant la prise en charge de la migration des applications UWP C#. La prise en charge des applications UWP automatise une grande partie du processus de migration. Pour en savoir plus, reportez-vous à la rubrique Migrer d’UWP vers le SDK d’application Windows avec l’Assistant Mise à niveau .NET.

Avantages de conteneurisation

Lors de la transition vers le Kit de développement logiciel (SDK) d’application Windows, les applications UWP peuvent perdre les avantages inhérents à la conteneurisation de leur plateforme d’origine. Toutefois, ces avantages peuvent être restaurés à l’aide de l’isolation des applications Win32 , une nouvelle fonctionnalité de sécurité qui améliore la protection en isolant les applications dans un environnement de bac à sable. Cette approche offre une sécurité supplémentaire contre les menaces potentielles avec des modifications minimales apportées à votre code existant. Pour plus d’informations et pour commencer à utiliser l’isolation des applications Win32, visitez le dépôt d’isolation de l’application Win32 sur GitHub.

Rubriques de cette section

Rubrique Description
Stratégie de migration globale Considérations et stratégies relatives à l’approche du processus de migration, et à la configuration de votre environnement de développement en vue de la migration.
Mappage des fonctionnalités UWP au kit SDK d’application Windows Cette rubrique compare les principales fonctionnalités dans les différentes formes sous lesquelles elles apparaissent dans UWP et dans le kit SDK d’application Windows.
Ce qui est pris en charge Découvrez les fonctionnalités actuellement disponibles dans WinUI 3 Desktop afin d’évaluer si vous devez tenter de migrer votre application UWP dès aujourd’hui.
Mappage des API UWP et des bibliothèques au kit SDK d’application Windows Cette rubrique fournit une correspondance entre les API et les bibliothèques UWP et leurs équivalents dans le kit SDK d’application Windows.
Guides des composants Une collection de sujets d’orientation sur la migration, chacun se concentrant sur un domaine de fonctionnalité spécifique.
Étude de cas 1 : PhotoLab (C#) Ce sujet est une étude de cas sur la prise de l’exemple d’application PhotoLab UWP C# et de la migration vers le kit de développement logiciel (SDK) d’application Windows.
Étude de cas 2 : Photo Editor (C++/WinRT) Cette rubrique est une étude de cas sur la prise de l’exemple d’application Photo Editor UWP C++/WinRT et de la migration vers le kit de développement logiciel (SDK) d’application Windows.
Conseils supplémentaires sur la migration Vous trouverez dans cette rubrique des conseils de migration supplémentaires non classés dans une zone de fonctionnalité dans les Guides des composants.
Migrer d’UWP vers le SDK d’application Windows avec l’Assistant Mise à niveau .NET L'Assistant Mise à niveau .NET est un outil en ligne de commande qui peut vous aider à migrer une application de C# d’UWP vers une application WinUI 3 qui utilise le kit SDK d’application Windows.

Voir aussi