Compiler des ressources manuellement avec MakePri.exeCompile resources manually with MakePri.exe

MakePri.exe est un outil en ligne de commande que vous pouvez utiliser pour créer et vider des fichiers IRP.MakePri.exe is a command line tool that you can use to create and dump PRI files. 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é.It is integrated as part of MSBuild within Microsoft Visual Studio, but it could be useful to you for creating packages manually or with a custom build system.

Notes

MakePri. exe est installé lorsque vous activez l’option SDK Windows pour les applications gérées UWP lors de l’installation du kit de développement logiciel (SDK) Windows.MakePri.exe is installed when you check the Windows SDK for UWP Managed Apps option while installing the Windows Software Development Kit. Il est installé dans le chemin %WindowsSdkDir%bin\<WindowsTargetPlatformVersion>\x64\makepri.exe d’accès (et dans les dossiers nommés pour les autres architectures).It is installed to the path %WindowsSdkDir%bin\<WindowsTargetPlatformVersion>\x64\makepri.exe (as well as in folders named for the other architectures). Par exemple : C:\Program Files (x86)\Windows Kits\10\bin\10.0.17713.0\x64\makepri.exe.For example, C:\Program Files (x86)\Windows Kits\10\bin\10.0.17713.0\x64\makepri.exe.

Contenu de cette sectionIn this section

RubriqueTopic DescriptionDescription
Options de ligne de commande de MakePri.exeMakePri.exe command-line options MakePri. exe a le jeu de commandes createconfig, dump new resourcepack,, et versioned.MakePri.exe has the set of commands createconfig, dump, new, resourcepack, and versioned. Cette rubrique décrit en détail les options de ligne de commande pour leur utilisation.This topic details the command-line options for their use.
Fichier de configuration de MakePri.exeMakePri.exe configuration file Cette rubrique décrit le schéma du fichier de configuration XML MakePri. exe.This topic describes the schema of the MakePri.exe XML configuration file.
Indexeurs spécifiques au format de MakePri.exeMakePri.exe format-specific indexers Cette rubrique décrit les indexeurs spécifiques au format utilisés par l’outil MakePri. exe pour générer son index de ressources.This topic describes the format-specific indexers used by the MakePri.exe tool to generate its index of resources.

Options de ligne de commande de MakePri.exeMakePri.exe command-line options

MakePri. exe a le jeu de commandes createconfig, dump new resourcepack,, et versioned.MakePri.exe has the set of commands createconfig, dump, new, resourcepack, and versioned. Pour plus d’informations sur leur utilisation, consultez options de ligne de commande de MakePri. exe.For details of their use, see MakePri.exe command-line options.

Configuration de MakePri. exeMakePri.exe configuration

Le fichier de configuration XML PRI détermine comment et quelles ressources sont indexées.The PRI XML configuration file dictates how and what resources are indexed. Le schéma du fichier XML de configuration est décrit dans la section configuration de MakePri. exe.The schema of the configuration XML is described in MakePri.exe configuration.

Indexeurs spécifiques au formatFormat-specific indexers

MakePri. exe est généralement utilisé avec les newoptions versioned, et resourcepack .MakePri.exe is typically used with the new, versioned, and resourcepack options. Dans ce cas, il indexe les fichiers sources pour générer un index des ressources.In those cases it indexes source files to generate an index of resources. MakePri. exe utilise différents indexeurs pour lire des fichiers ou conteneurs de ressources sources différents pour les ressources.MakePri.exe uses various individual indexers to read different source resource files or containers for resources. L’indexeur de dossier le plus simple est l’indexeur de dossiers, qui indexe le contenu d’un dossier .jpg pour .png les ressources telles que les images ou.The simplest indexer is the folder indexer, which indexes the contents of a folder for resources such as .jpg or .png images. Pour plus d’informations, consultez indexeurs spécifiques au format MakePri. exe.For more info, see MakePri.exe format-specific indexers.

Avertissements et messages d’erreur MakePri. exeMakePri.exe warnings and error messages

Ressources trouvées pour la ou les langues « <langue (s) > », mais aucune ressource n’a été trouvée pour la ou les langues par défaut : « <Language (s) > ».Resources found for language(s) '<language(s)>' but no resources found for default language(s): '<language(s)>'. Modifiez la langue par défaut ou qualifiez les ressources avec la langue par défaut.Change the default language or qualify resources with the default language.

Cet avertissement s’affiche quand MakePri. exe ou MSBuild Découvre des fichiers ou des ressources de type chaîne pour une ressource nommée donnée qui semblent être marqués avec des qualificateurs de langue, mais qu’aucun candidat n’est trouvé pour une langue par défaut.This warning is displayed when MakePri.exe or MSBuild discovers files or string resources for a given named resource that appear to be marked with language qualifiers, but no candidate is found for a default language. Le processus d’utilisation de qualificateurs dans les noms de fichiers et de dossiers est décrit dans adapter vos ressources à la langue, à l’échelle et à d’autres qualificateurs.The process for using qualifiers in file and folder names is described in Tailor your resources for language, scale, and other qualifiers. Un fichier ou un dossier peut contenir un nom de langue, mais aucune ressource n’est détectée et qualifiée pour la langue par défaut exacte.A file or folder may have a language name in it, but no resources are discovered that are qualified for the exact default language. Par exemple, si un projet utilise « en-US » comme langue par défaut et possède un fichier nommé « de/logo. png », mais n’a pas de fichiers marqués avec la langue par défaut « en-US », cet avertissement s’affiche.For example, if a project uses "en-US" as the default language and has a file named "de/logo.png", but does not have any files that are marked with the default language "en-US", this warning will appear. Pour supprimer cet avertissement, le ou les deux fichiers ou ressources de chaîne doivent être qualifiés avec la langue par défaut, ou la langue par défaut doit être modifiée.In order to remove this warning, either file(s) or string resource(s) should be qualified with the default language, or the default language should be changed. Pour modifier la langue par défaut, avec votre solution ouverte dans Visual Studio, Package.appxmanifestouvrez.To change the default language, with your solution open in Visual Studio, open Package.appxmanifest. Sous l’onglet application, vérifiez que la langue par défaut est définie correctement (par exemple, « fr » ou « en-US »).On the Application tab, confirm that the Default language is set appropriately (for example, "en" or "en-US").

Aucune ressource neutre ou par défaut donnée pour«».No default or neutral resource given for ''. L’application peut lever une exception pour certaines configurations d’utilisateur lors de la récupération des ressources.The application may throw an exception for certain user configurations when retrieving the resources.

Cet avertissement s’affiche quand MakePri. exe ou MSBuild Découvre des fichiers ou des ressources qui semblent être marqués avec des qualificateurs de langue pour lesquels les ressources ne sont pas claires.This warning is displayed when MakePri.exe or MSBuild discovers files or resources that appear to be marked with language qualifiers for which the resources are unclear. Il existe des qualificateurs, mais il n’existe aucune garantie qu’un candidat à une ressource spécifique peut être retourné pour cet identificateur de ressource au moment de l’exécution.There are qualifiers, but there is no guarantee that a particular resource candidate can be returned for that resource identifier at run time. Si aucun candidat aux ressources pour une langue particulière, homeregion ou un autre qualificateur ne peut être trouvé qui est une valeur par défaut ou correspondra toujours au contexte d’un utilisateur, cet avertissement s’affiche.If no resource candidate for a particular language, homeregion, or other qualifier can be found that is a default or will always match the context of a user, this warning will be displayed. Au moment de l’exécution, pour des configurations utilisateur particulières, telles que les préférences linguistiques d’un utilisateur ou l’emplacement d’hébergement (paramètres > & > région de langue & langue), les API utilisées pour récupérer la ressource peuvent lever une exception inattendue.At run time, for particular user configurations such as a user's language preferences or home location (Settings > Time & Language > Region & language), the APIs used to retrieve the resource may throw an unexpected exception. Pour supprimer cet avertissement, des ressources par défaut doivent être fournies, telles qu’une ressource dans la langue par défaut ou la région d’hébergement globale du projet (homeregion-001).In order to remove this warning, default resources should be provided, such as a resource in the project's default language or global home region (homeregion-001).

Utilisation de MakePri. exe dans un système de générationUsing MakePri.exe in a build system

Les systèmes de génération doivent utiliser la commande newMakePri versioned. exe resourcepack , ou, selon le type de projet en cours de génération.Build systems should use the MakePri.exe new, versioned, or resourcepack command, depending on the type of project being built. Les systèmes de génération qui créent un fichier PRI actualisé doivent new utiliser la commande.Build systems that create a fresh PRI file should use the new command. Les systèmes de génération qui doivent garantir la compatibilité des décalages internes via les itérations peuvent utiliser la versioned commande.Build systems that must ensure compatibility of internal offsets through iterations can use the versioned command. Créez des systèmes qui doivent créer un fichier PRI contenant des variantes de ressources supplémentaires, avec la validation pour s’assurer qu’aucune nouvelle ressource n’est ajoutée pour cette variante resourcepack , utilisez la commande.Build systems that must create a PRI file that contains additional variants of resources, with validation to ensure that no new resources are added for that variant, should use the resourcepack command.

Les systèmes de génération qui requièrent un contrôle explicite sur les fichiers sources qui sont indexés peuvent utiliser l’indexeur ResFiles au lieu d’indexer un dossier.Build systems that require explicit control over source files that get indexed can use the ResFiles indexer instead of indexing a folder. Les systèmes de génération peuvent également utiliser plusieurs passes d’index avec différents indexeurs spécifiques au format pour générer un fichier PRI unique.Build systems can also use multiple index passes with different format-specific indexers to generate a single PRI file.

Les systèmes de génération peuvent également utiliser l’indexeur de format PRI spécifique pour ajouter des fichiers PRI prédéfinis dans le PRI pour le package à partir d’autres composants, tels que des bibliothèques de classes, des assemblys, des kits de développement logiciel (SDK) et des dll.Build systems can also use the PRI format-specific indexer to add pre-built PRI files into the PRI for the package from other components, such as class libraries, assemblies, SDKs, and DLLs.

Lorsque des fichiers PRI sont générés pour d’autres composants, bibliothèques de classes, assemblys, dll et kits de développement logiciel (SDK), la configuration initialPath doit être utilisée pour s’assurer que les ressources de composants ont leurs propres mappages de sous-ressources qui ne sont pas en conflit avec l’application dans laquelle ils sont inclus.When PRI files are built for other components, class libraries, assemblies, DLLs, and SDKs, the initialPath configuration should be used to ensure component resources have their own sub resource maps that don't conflict with the app they're included in.