Migrer d’UWP vers le SDK d’application Windows

Si les fonctionnalités actuelles de la plateforme Windows universelle (UWP) vous conviennent, vous n’êtes pas tenu de migrer votre type de projet. WinUI 2.x et le SDK Windows prennent en charge les types de projets UWP.

Toutefois, si choisissez de migrer votre application d’UWP vers le SDK d'application Windows, votre code d’interface utilisateur ne requiert généralement que quelques modifications d’espace de noms. Globalement, le code de votre plateforme peut rester le même. 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.

De manière générale, voici les étapes de la migration manuelle (reportez-vous à la section suivante pour en savoir plus sur l’utilisation de l’outil .NET Upgrade Assistant) :

1. Créez un projet de bureau empaqueté WinUI 3 (reportez-vous à Créer votre premier projet WinUI 3). Il peut être intégré à votre solution existante.
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.

Portez une attention particulière aux Éléments pris en charge lors de la migration d’UWP vers WinUI 3. Cette rubrique décrit toutes les fonctionnalités en attente de prise en charge dans WinUI 3 et le SDK d'application Windows. Si votre application requiert l’une de ces fonctionnalités/bibliothèques, envisagez de reporter la migration.

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.

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 de mise à niveau .NET est un outil en ligne de commande qui peut vous aider à migrer une application de C# d’UWP vers une application Bibliothèque d’interface utilisateur Windows (WinUI) 3 qui utilise le kit SDK d’application Windows.