Ressources d’application et système de gestion des ressources

Cette section vous montre comment créer, mettre en package et utiliser les ressources de chaîne, d’image et de fichier de votre application. Par exemple, vous pouvez créer un package contenant un fichier avec votre jeu simple qui comprend une définition des niveaux de jeu, puis charger le fichier au moment de l’exécution. Nous vous montrons également comment, en conservant vos ressources séparées de la logique de l’application, il est plus facile de localiser et personnaliser votre application pour différents paramètres régionaux, écrans d’appareils, paramètres d’accessibilité et autres contextes d’utilisateur et d’ordinateur. Les ressources telles que les chaînes et les images doivent généralement exister dans plusieurs variantes de langue, d’échelle et de contraste. Pour ce type de ressources, vous pouvez vous appuyer sur le système de gestion des ressources.

Il existe deux types de ressource d’application.

• Une ressource de fichier est une ressource stockée sous la forme d’un fichier sur disque. Une ressource de fichier peut contenir une image bitmap, des données XAML, XML, HTML ou tout autre type de données.
• Une ressource incorporée est une ressource qui est incorporée dans un fichier de ressources contenant. L’exemple le plus courant est une ressource de chaîne incorporée dans un fichier de ressources (.resw ou .resjson).

Pour plus d’informations sur la proposition de valeur de la localisation de votre application, consultez Internationalisation et localisation.

Article	Description
Système de gestion des ressources	Lors de la génération, le système de gestion des ressources crée un index de toutes les variantes de ressources qui sont incluses dans le package avec votre application. Lors de l’exécution, le système détecte les paramètres en vigueur pour l’utilisateur et l’ordinateur, et charge les ressources les plus appropriées pour ces paramètres.
Comment le système de gestion des ressources met en correspondance et sélectionne les ressources	Quand une ressource est requise, plusieurs candidats sont susceptibles de correspondre, avec plus ou moins d’exactitude, au contexte de ressource actuel. Le système de gestion des ressources analyse tous les candidats et identifie le meilleur à retourner. Cette rubrique décrit ce processus en détail et donne des exemples.
Comment le système de gestion des ressources met en correspondance les balises de langue	La rubrique précédente (Comment le système de gestion des ressources met en correspondance et sélectionne les ressources) aborde la correspondance entre les qualificateurs de manière générale. Cette rubrique se concentre plus particulièrement sur la correspondance entre les balises de langue.
Personnaliser vos ressources pour la langue, l’échelle, le contraste élevé et d’autres qualificateurs	Cette rubrique explique le concept général des qualificateurs de ressource, leur utilisation et le rôle de chacun des noms de qualificateur.
Localiser les chaînes dans l’interface utilisateur et le manifeste du package d’application	Si vous souhaitez que votre application prenne en charge différentes langues d’affichage et si des opérateurs de chaîne figurent dans votre code, votre balisage XAML ou le manifeste du package d’application, déplacez ces chaînes dans un fichier de ressources (.resw). Vous pouvez ensuite effectuer une copie traduite de ce fichier de ressources pour chaque langue prise en charge par votre application.
Charger des images et des ressources adaptées pour la mise à l’échelle, le thème, le contraste élevé et autres	Votre application peut charger des fichiers de ressources d’image contenant des images adaptées pour le facteur d’échelle de l’affichage, le thème, le contraste élevé et d’autres contextes d’exécution.
Schémas d’URI	Vous pouvez utiliser plusieurs schémas d’URI (Uniform Resource Identifier) pour faire référence à des fichiers qui proviennent de votre package d’application, des dossiers de données de votre application ou du cloud. Vous pouvez également utiliser un schéma d’URI pour faire référence à des chaînes chargées à partir des fichiers de ressources (.resw) de votre application.
Préciser les ressources par défaut que votre application utilise	Si votre application n’a pas les ressources qui correspondent aux paramètres particuliers d’un appareil client, les ressources de l’application par défaut sont utilisées. Cette rubrique explique comment spécifier ce que sont ces ressources par défaut.
Générer des ressources dans votre package d’application, plutôt que dans un pack de ressources	Certains types d’applications (dictionnaires multilingues, outils de traduction, etc.) doivent remplacer le comportement par défaut d’un ensemble d’applications et créer des ressources dans le package d’application plutôt que dans des packages de ressources distincts. Cette rubrique explique la procédure à suivre.
API d’indexation de ressources de package (IRP) et systèmes de génération personnalisés	Grâce aux API d’indexation de ressources de package (IRP), vous pouvez développer un système de génération personnalisé pour les ressources de votre application UWP. Le système de génération pourra créer, versionner et vider (en tant que XML) les fichiers d’index de ressources de package (IRP) au niveau de complexité dont votre application UWP a besoin.
Compiler des ressources manuellement avec MakePri.exe	MakePri.exe est un outil en ligne de commande que vous pouvez utiliser pour créer et vider des fichiers IRP. Il est intégré en tant qu’élément de MSBuild dans Microsoft Visual Studio, mais il peut aussi être utilisé pour la création de packages manuellement ou avec un système de génération personnalisé.
Utiliser le système de gestion des ressources Windows 10 dans une application ou un jeu hérité	En incluant votre application ou jeu .NET ou Win32 dans un package .msix ou .appx, vous pouvez exploiter le système de gestion des ressources pour charger des ressources d’application adaptées au contexte d’exécution. Cette rubrique détaillée décrit ces techniques.

Consultez aussi Prise en charge des notifications de vignettes et toasts pour la langue, la mise à l’échelle et le contraste élevé.