WindowsAppSDK Samples

Exemples de SDK d’application Windows

Ce référentiel héberge des exemples pour le SDK d'application Windows. Des exemples de diverses fonctionnalités fournies dans le SDK de l’application Windows seront ajoutés à ce référentiel. Pour plus d’informations sur le SDK d’application Windows, consultez la documentation du SDK d’application Windows. Pour en savoir plus sur la conception du SDK d’application Windows ou pour contribuer au projet, faire des propositions de fonctionnalités ou démarrer des discussions, visitez la page GitHub du SDK d’application Windows.

Liste des échantillons

Cycle de vie des applications et services système

• Cycle de vie des applications : ces exemples illustrent l'instanciation d'applications à l'aide des API AppLifecycle. Ils incluent les fonctionnalités suivantes :
  • Activation : ces exemples démontrent la prise en charge de types d'activation riches.
  • Instanciation : ces exemples démontrent la prise en charge de la multi-instanciation unique et sélective.
  • Notifications d'alimentation : ces exemples illustrent les notifications d'alimentation/état du système pour gérer la charge de travail des applications.
  • Redémarrer : ces exemples illustrent le redémarrage synchrone d’une application avec des arguments de redémarrage de ligne de commande.
  • Cible de partage : cet exemple montre une application qui peut être activée en tant que cible de partage.

Données et fichiers

• Gestion des ressources : ces exemples illustrent la gestion des ressources d'application à l'aide des API MRT Core.

Déploiement

• Gestionnaire de déploiement : cet exemple montre comment initialiser et accéder aux informations de déploiement pour le runtime du SDK d’application Windows.
• Programme d’installation : cet exemple montre comment lancer le programme d’installation du SDK d’application Windows sans fenêtre de console.
• Non packagé : ces exemples illustrent l’initialisation automatique avec le package Windows App SDK à partir d’une application non MSIX (non packagée).

Dépendances dynamiques

• DirectX : cet exemple montre comment utiliser l'API Dynamic Dependencies pour charger dynamiquement le package d'infrastructure DirectX Runtime MSIX.

Graphique

• Rendu de texte : cet exemple est une galerie des API DWriteCore illustrant le rendu de texte.

Notifications

• Notifications push : il s'agit d'un exemple d'application qui présente les notifications push.
• Notifications d'application : il s'agit d'un exemple d'application qui présente les notifications d'application.

Composants d'exécution

• Contrôles personnalisés : cet exemple montre comment créer un composant Windows Runtime en C# avec des contrôles WinUI personnalisés.

Interface utilisateur et entrée

• Fenêtrage : cet exemple montre comment gérer les fenêtres d'application à l'aide des API de fenêtrage.
• Galerie d’entrées et de composition Windows : cette collection d’exemples présente les API Microsoft.UI.Composition et Microsoft.UI.Input.
• Galerie WinUI 3 : il s'agit d'un exemple d'application qui présente tous les contrôles WinUI 3 en action.

Exigences

Ces exemples de SDK d’application Windows présentent la configuration système requise suivante :

• Windows 10, version 1809 (build 17763) ou version ultérieure.

• Visual Studio 2022 ou Visual Studio 2019 version 16.9 ou ultérieure, avec les charges de travail et composants suivants :

  • Développement de la plateforme Windows universelle
  • Développement .NET Desktop (nécessaire même si vous créez uniquement des applications C++ Win32)
  • Développement de bureau avec C++ (nécessaire même si vous créez uniquement des applications .NET)
  • SDK Windows version 2004 (build 19041) ou version ultérieure. Ceci est installé avec Visual Studio par défaut.

• La création d’exemples .NET C# avec le SDK Windows App 1.1 nécessite également l’une des versions suivantes du SDK .NET ou une version ultérieure :

  • 6.0.202
  • 6.0.104
  • 5.0.407
  • 5.0.213

Reportez-vous à la documentation sur la configuration système requise et les outils pour le développement d'applications Windows pour obtenir une liste détaillée des exigences relatives au développement d'applications avec le SDK d'application Windows.

Utilisation des échantillons

Pour utiliser les exemples avec Git, clonez le référentiel WindowsAppSDK-Samples en exécutant git clone https://github.com/microsoft/WindowsAppSDK-Samples.git à partir d'une invite de commande. Vous pouvez ensuite accéder au répertoire d'un exemple et ouvrir le fichier de solution dans Visual Studio.

Le moyen le plus simple d’utiliser ces exemples sans Git consiste à télécharger le fichier ZIP. Sélectionnez Télécharger ZIP dans la liste déroulante de téléchargement, décompressez l'intégralité de l'archive et ouvrez les exemples dans Visual Studio.

Gestion des versions des exemples

Les exemples seront mis à jour avec les versions GA du SDK de l’application Windows. La branche main comprend les derniers échantillons, qui peuvent également inclure des fonctionnalités expérimentales ou en avant-première. Les branches de version spécifiques sont nommées release/xy et contiennent des exemples qui font référence à la version GA correspondante du SDK de l’application Windows. Ce référentiel comprend actuellement les branches de version suivantes :

• version/1.0
• version/0.8
• version/0.5

Contribuer

Ces exemples sont fournis par les équipes techniques et nous apprécions vos commentaires sur les problèmes et vos suggestions pour de nouveaux échantillons. Nous vous encourageons à déposer un nouveau numéro pour tout commentaire ou question !

Les auteurs d’échantillons doivent suivre les directives relatives aux échantillons pour commencer à développer leurs échantillons. Pour les exemples de SDK d’application Windows basés sur WinUI, utilisez les exemples de modèles. Le fichier VSIX est disponible en téléchargement sur la page des versions de Github ici.

Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez la FAQ sur le code de conduite ou contactez [email protected] pour toute question ou commentaire supplémentaire.

Une fois qu’un nouvel exemple d’application a été ajouté, les développeurs Microsoft doivent envisager de mettre à jour le pipeline interne de l’agrégateur pour :

• Activez régulièrement la création du nouvel exemple d’application.
• Ajoutez un nouveau scénario de test au pilote de test SampleTests TAEF existant pour vérifier régulièrement le lancement réussi de l'exemple d'application par rapport à la dernière version du SDK de l'application Windows.

Reportez-vous à la documentation sur le référentiel interne Aggregator pour obtenir des instructions, dans les étapes BuildSampleApps et TestSampleApps.