Options de ligne de commande de MakePri.exe

  • Article

MakePri.exe a l’ensemble de commandes createconfig, , dumpnew, resourcepack, et versioned. Cette rubrique détaille les options de ligne de commande pour leur utilisation.

Remarque

MakePri.exe est installé lorsque vous case activée l’option Kit de développement logiciel (SDK) Windows pour les applications gérées UWP lors de l’installation du Kit de développement logiciel Windows. Il est installé sur le chemin d’accès %WindowsSdkDir%bin\<WindowsTargetPlatformVersion>\x64\makepri.exe (ainsi que dans les dossiers nommés pour les autres architectures). Par exemple : C:\Program Files (x86)\Windows Kits\10\bin\10.0.17713.0\x64\makepri.exe.

Obtenir de l’aide à partir de la ligne de commande

Vous pouvez exécuter MakePri.exe help ou MakePri.exe /? afficher les commandes que vous pouvez utiliser avec MakePri.exe. Vous pouvez également émettre des problèmes MakePri.exe <command> /? pour voir des détails sur une commande et, dans des cas très rares, même MakePri.exe <command> <option> pour voir des détails sur une option.

Commandes MakePri

C:\>makepri help

Usage:
------
    MakePri.exe <command> [options]

Example:
--------
    MakePri.exe new /cf C:\MyApp\priconfig.xml /pr C:\MyApp\src\ /in PackageName

Description:
------------
    Creates, dumps, and performs utility functions on a PRI file. A PRI file is 
    an index of application resources, such as strings and image files.

Command Options:
----------------
    MakePri.exe createconfig   Creates a PRI config file for use with other
                               commands
    MakePri.exe dump           Dumps the contents of a PRI file
    MakePri.exe new            Creates a new PRI file from scratch
    MakePri.exe resourcepack   Creates a PRI file that contains additional
                               resource variants for a base PRI file
    MakePri.exe versioned      Creates a PRI file based on a previous version

Help:
-----
    MakePri.exe help           Show this help page
    MakePri.exe <command> /?   Shows detailed help for <command>

    For example,
    MakePri.exe createconfig /?

Commande Createconfig

La createconfig commande crée un fichier de configuration PRI initialisé définissant les paramètres par défaut des qualificateurs que vous spécifiez. Exécutez MakePri.exe createconfig /? pour afficher une aide détaillée pour cette commande.

C:\>makepri createconfig /?

Usage:
------
    MakePri.exe createconfig /cf <config file destination> /dq
    <default qualifiers> [options]

Example:
--------
    MakePri.exe createconfig /cf C:\MyApp\priconfig.xml /dq lang-en-US /o /pv 10.0.0

Description:
------------
    Creates a PRI configuration file at <config file destination> with default 
    qualifiers specified by <default qualifiers>. Multiple qualifiers are separated 
    by underscores (_)

Required Parameters:
--------------------
    /ConfigXml(cf)    : <FILEPATH> Configuration file output location
    /Default(dq)      : <QUALIFIERS> The default qualifiers to set in the
                        configuration file. A language qualifier is required

Options:
--------
    /ExtensionDll(ex) : <FILEPATH> Location of the Resource Management System
                        environment extension DLL. This DLL must be signed by
                        a Microsoft-issued certificate. Default is an empty path
                        (no DLL will be used)
    /Overwrite(o)     : Overwrite an existing output file of the same name
                        without prompting
    /Platform(pv)     : <VERSION> Platform version to use for generated
                        configuration file

    FILEPATH          - a path to a file, either relative to the current
                        directory or absolute
    QUALIFIERS        - a valid qualifier token
                        (for example, lang-en-US_scale-100_contrast-high)

Help:
-----
    /Help(h, ?)       : Display the usage help text

Commande Dump

La dump commande génère un fichier xml vidé contenant une liste de toutes les ressources d’un fichier PRI spécifié. Exécutez MakePri.exe dump /? pour afficher une aide détaillée pour cette commande.

Remarque

Un pack de ressources sans schéma est un pack de ressources créé avec le commutateur omitSchemaFromResourcePacks dans le fichier de configuration PRI. Pour vider un pack de ressources sans schéma, utilisez le commutateur /es <main_package_PRI_file>. Si vous ne spécifiez pas le fichier principal, le message d’erreur « Resources.pri dans le package a été endommagé de sorte que le chiffrement a échoué (erreur PRI222 : 0xdef0000f - Erreur non spécifiée s’est produite) ».

C:\>makepri dump /?

Usage:
------
    MakePri.exe dump [options]

Example:
--------
    MakePri.exe dump /if C:\MyApp\resources.pri /of C:\resources.pri.xml

Description:
------------
    Outputs a dumped xml file at <output file> containing a list of all 
    resources in <index file>.

Options:
--------
    /DumpType(dt)       : <STRING> Format of the dumped file, default is
                          Basic
    /ExtensionDll(ex)   : <FILEPATH> Location of the Resource Management System
                          environment extension DLL. This DLL must be signed by a
                          Microsoft-issued certificate. Default is an empty path
                          (no DLL will be used)
    /ExternalSchema(es) : <FILEPATH> Location of the external schema file
    /IndexFile(if)      : <FILEPATH> Location of the PRI file to dump from.
                          Default is .\resources.pri
    /OutputFile(of)     : <FILEPATH> Output location of the dump file, default
                          is .\[indexfile].xml
    /OutputOptions(oo)  : <OPTIONS> Options to provide detailed control over
                          contents of XML output files.
    /Overwrite(o)       : Overwrite an existing output file of the same name
                          without prompting
    /Verbose(v)         : Causes verbose messages to be output to the console

    Dump Type:
        Either 'Basic', 'Detailed', 'Schema', or 'Summary'

    FILEPATH            - a path to a file, either relative to the current
                          directory or absolute
Help:
-----
    /Help(h, ?)         : Display the usage help text

Nouvelle commande

La new commande crée un fichier PRI en indexant les fichiers dans votre projet comme indiqué par votre fichier de configuration. Exécutez MakePri.exe new /? pour afficher une aide détaillée pour cette commande.

C:\>makepri new /?

Usage:
------
    MakePri.exe new /cf <config file> /pr <project root> [options]

Example:
--------
    MakePri.exe new /cf C:\MyApp\priconfig.xml /pr C:\MyApp\src\ 
    /mn C:\MyApp\AppXManifest.xml /o /of C:\MyApp\src\resources.pri

Description:
------------
    Creates a PRI file at <output file> by indexing all files in
    <project root> and its subdirectories as directed by <config file>. The
    index will be assigned <index name> to reference resources in the app

Required Parameters:
--------------------
    /ConfigXml(cf)    : <FILEPATH> Configuration file location. Use the
                        'Makepri.exe createconfig' command to generate one
    /ProjectRoot(pr)  : <FOLDERPATH> Root location of project files

Options:
--------
    /AutoMerge(am)    : This flag is not recommended for normal use with .appx
                        packages. It causes Makepri.exe to set the auto
                        merge flag within the PRI file. Default is not set.
    /ExtensionDll(ex) : <FILEPATH> Location of the Resource Management System
                        environment extension DLL. This DLL must be signed by
                        a Microsoft-issued certificate. Default is an empty path
                        (no DLL will be used)
    /IndexLog(il)     : <FILEPATH> XML Log of indexed resources, no file
                        generated by default
    /IndexName(in)    : <STRING> Name for the generated index of resources.
                        Typically matches the .appx package name, class library
                        simple name, etc. May be supplied via the
                        [manifest] parameter.
    /IndexOptions(io) : <OPTIONS> Options to provide detailed control over
                        behavior of resource indexers.
    /Manifest(mn)     : <FILEPATH> Location of the application or component's
                        manifest. This parameter is ignored if [indexname]
                        is given. Default is [projectroot]\AppXManifest.xml
    /MappingFile(mf)  : <MAPPINGFILETYPE> Generate a mapping file in the given
                        file format.
    /OutputFile(of)   : <FILEPATH> Output location of PRI file, default is
                        .\resources.pri
    /Overwrite(o)     : Overwrite an existing output file of the same name
                        without prompting
    /ReverseMap(rm)   : Generate a reverse mapping section in the PRI file
                        which can be used for debugging purposes.
    /SchemaFile(sf)   : <FILEPATH> Output location of XML resource schema
                        description.
    /Verbose(v)       : Causes verbose messages to be output to the console
    /VersionMajor(vma): <INTEGER> [Deprecated] Major version number for
                        index, default is 1

    FOLDERPATH        - a path to a folder
    FILEPATH          - a path to a file, either relative to the current
                        directory or absolute
    MAPPINGFILETYPE   - Supported File type(s): 'AppX'

Help:
-----
    /Help(h, ?)        : Display the usage help text

Commande ResourcePack

La resourcepack commande crée un fichier PRI en indexant les fichiers dans votre projet comme indiqué par votre fichier de configuration. Un fichier PRI de pack de ressources contient uniquement des variantes supplémentaires de ressources déjà spécifiées dans un fichier PRI existant. Exécutez MakePri.exe resourcepack /? pour afficher une aide détaillée pour cette commande.

C:\>makepri resourcepack /?

Usage:
------
    MakePri.exe resourcepack /pr <project root> /cf <config file> [options]

Example:
--------
    MakePri.exe resourcepack /cf C:\MyAppEs\priconfig.xml /pr C:\MyAppEs\src\ 
    /if C:\MyApp\1.2\resources.pri /o /of C:\MyAppEs\resources.pri

Description:
------------
    Creates a PRI file at <output file> by indexing all files in 
    <project root> and its subdirectories as directed by <config file>. A 
    resource pack PRI file contains only additional variants of resources 
    already specified in <index file>.

Required Parameters:
--------------------
    /ConfigXml(cf)    : <FILEPATH> Configuration file location. Use
                        'Makepri.exe createconfig' command to generate one
    /ProjectRoot(pr)  : <FOLDERPATH> Root location of project files

Options:
--------
    /AutoMerge(am)    : This flag is not recommended for normal use with .appx
                        packages. It causes Makepri.exe to set the auto
                        merge flag within the PRI file. By default it is set
                        to same as the base PRI file.
    /ExtensionDll(ex) : <FILEPATH> Location of the Resource Management System
                        environment extension DLL. This DLL must be signed by
                        a Microsoft-issued certificate. Default is an empty path
                        (no DLL will be used)
    /IndexFile(if)    : <FILEPATH> Location of the base PRI or XML schema file.
                        Default is <ProjectRoot>\resources.pri
    /IndexLog(il)     : <FILEPATH> XML Log of indexed resources, no file
                        generated by default
    /IndexOptions(io) : <OPTIONS> Options to provide detailed control over
                        behavior of resource indexers.
    /MappingFile(mf)  : <MAPPINGFILETYPE> Generate a mapping file in the given
                        file format.
    /OutputFile(of)   : <FILEPATH> Output location of PRI file, default is
                        .\resources.pri
    /Overwrite(o)     : Overwrite an existing output file of the same name
                        without prompting
    /ReverseMap(rm)   : Generate a reverse mapping section in the PRI file
                        which can be used for debugging purposes.
    /SchemaFile(sf)   : <FILEPATH> Output location of XML resource schema
                        description.
    /Verbose(v)       : Causes verbose messages to be output to the console

    FOLDERPATH        - a path to a folder
    FILEPATH          - a path to a file, either relative to the current
                        directory or absolute
    MAPPINGFILETYPE   - Supported File type(s): 'AppX'

Help:
-----
    /Help(h, ?)        : Display the usage help text

Commande versionnée

La versioned commande crée un fichier PRI versionné en indexant les fichiers dans votre projet comme indiqué par votre fichier de configuration. Exécutez MakePri.exe versioned /? pour afficher une aide détaillée pour cette commande.

C:\>makepri versioned /?

Usage:
------
    MakePri.exe versioned /cf <config file> /pr <project root> [options]

Example:
--------
    MakePri.exe versioned /cf C:\MyApp\priconfig.xml /pr C:\MyApp\src 
    /if C:\MyApp\1.2\resources.pri /o /of C:\MyApp\src\resources.pri /o

Description:
------------
    Creates a versioned PRI file at <output file> by indexing all files in 
    <project root> and its subdirectories as directed by <config file>.

Required Parameters:
--------------------
    /ConfigXml(cf)    : <FILEPATH> Configuration file location. Use
                        'Makepri.exe createconfig' command to generate one
    /ProjectRoot(pr)  : <FOLDERPATH> Root location of project files

Options:
--------
    /AutoMerge(am)    : This flag is not recommended for normal use with .appx
                        packages. It causes Makepri.exe to set the auto
                        merge flag within the PRI file. By default it is set
                        to same as the base PRI file.
    /ExtensionDll(ex) : <FILEPATH> Location of the Resource Management System
                        environment extension DLL. This DLL must be signed by
                        a Microsoft-issued certificate. Default is an empty path
                        (no DLL will be used)
    /IndexFile(if)    : <FILEPATH> Location of the base PRI or XML schema file
                        to version from. Default is <ProjectRoot>\resources.pri
    /IndexLog(il)     : <FILEPATH> XML Log of indexed resources, no file
                        generated by default
    /IndexOptions(io) : <OPTIONS> Options to provide detailed control over
                        behavior of resource indexers.
    /MappingFile(mf)  : <MAPPINGFILETYPE> Generate a mapping file in the given
                        file format.
    /OutputFile(of)   : <FILEPATH> Output location of PRI file, default is
                        [current directory]\resources.pri
    /Overwrite(o)     : Overwrite an existing output file of the same name
                        without prompting
    /ReverseMap(rm)   : Generate a reverse mapping section in the PRI file
                        which can be used for debugging purposes.
    /SchemaFile(sf)   : <FILEPATH> Output location of XML resource schema
                        description.
    /Verbose(v)       : Causes verbose messages to be output to the console

    FOLDERPATH        - a path to a folder
    FILEPATH          - a path to a file, either relative to the current
                        directory or absolute
    MAPPINGFILETYPE   - Supported File type(s): 'AppX'

Help:
-----
    /Help(h, ?)        : Display the usage help text

/ExtensionDll(ex)

Vous utilisez l’option DLL d’extension (/ex) avec createconfig, dump, new, resourcepacket versioned pour spécifier l’emplacement de la DLL d’extension d’environnement resource Management System.

Fichier de journalisation/métadonnées

MakePri peut inclure des informations spécifiques à un pack de ressources dans le fichier de métadonnées de l’indexeur. Voici un exemple de fichier journal pour lequel resources.pri les fichiers german.pri PRI de ressources et highresolution.pri.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<root>
  <package filename="resources.pri">
    <instance itemname="Files\logo.jpg" qualifiers="Scale-100" src="" type="Path">
      <value>logo.scale-100.jpg</value>
    </instance>
    <instance itemname="resources\string2" qualifiers="Language-en-us" src="C:\Users\alias\Desktop\repro\app4\project\en-us\resources.resw" type="String">
      <value>value2</value>
    </instance>
    <instance itemname="resources\string1" qualifiers="Language-en-us" src="C:\Users\alias\Desktop\repro\app4\project\en-us\resources.resw" type="String">
      <value>value1</value>
    </instance>
  </package>
  <package filename="german.pri">
    <instance itemname="resources\string2" qualifiers="Language-de-de" src="C:\Users\alias\Desktop\repro\app4\project\de-de\resources.resw" type="String">
      <value>value2</value>
    </instance>
    <instance itemname="resources\string1" qualifiers="Language-de-de" src="C:\Users\alias\Desktop\repro\app4\project\de-de\resources.resw" type="String">
      <value>value1</value>
    </instance>
  </package>
  <package filename="highresolution.pri">
    <instance itemname="Files\logo.jpg" qualifiers="Scale-200" src="" type="Path">
      <value>logo.scale-200.jpg</value>
    </instance>
  </package>
</root>

Option /IndexFile(if)

Vous utilisez l’option de fichier d’index (/if) avec dump, resourcepacket versioned pour spécifier un fichier PRI d’entrée.

Pour resourcepack et versioned, au lieu de fournir un fichier PRI comme paramètre d’entrée pour /IndexFile(if), vous pouvez à la place fournir un fichier de schéma.

/IndexFile(if) <FILEPATH>

FILEPATH est un jeton qui spécifie l’emplacement du fichier PRI d’entrée ou du fichier de schéma PRI.

Option /IndexOptions(io)

Vous utilisez l’option options d’index (/io) avec new, resourcepacket versioned pour spécifier des options qui fournissent un contrôle détaillé sur le comportement des indexeurs de ressources. Les options d’index sont désactivées par défaut.

/IndexOptions(io) <OPTIONS>

OPTIONS est une liste séparée par des virgules composée des options suivantes.

  • +/-HiddenFiles(hf). Index (+) ou ignorer (-) les fichiers et dossiers masqués.
  • +/-LinkedFiles(lf). Index (+) ou ignorer (-) les fichiers et dossiers liés (-).

Option /MappingFile(mf)

Vous utilisez l’option de fichier de mappage (/mf) avec new, resourcepacket versioned pour générer un fichier de mappage. MakeAppx.exe utilise le fichier de mappage pour générer des packages d’application.

/MappingFile(mf) <MAPPINGFILETYPE>

MAPPINGFILETYPE est un jeton qui spécifie le format du fichier de mappage. Le seul format valide pris en charge est appx.

/mf appx

Il s’agit d’un exemple de contenu d’un fichier de mappage principal.

"ResourceDimensions"                   "language-de-de"

Il s’agit d’un exemple de contenu d’un fichier de mappage de pack de ressources.

"ResourceId"                           "Resources184.la5decaf08"
"ResourceDimensions"                   "language-de-de"

Résumé de sortie

Si des packs de ressources sont créés, le résumé de sortie de MakePRI.exe est d’une forme plus détaillée. Voici un exemple.

Index Pass Completed: ResourcePackTests\TestApp_ResourcePack
Language Qualifiers: fr-FR, de-DE

Finished building
Version: 1.0
Resource Map Name: AppTest
Named Resources: 11

Resource PRI: fr-FR.pri
Version: 1.0
Resource Candidates: 4
Language: fr-FR

Resource PRI: de-DE.pri
Version: 1.0
Resource Candidates: 4
Language: de-DE

Output File(s) at TempTestResults
Successfully Completed

Option /Overwrite(o)

Si l’option de surécriture (/o) n’est pas fournie et que le ou les fichiers de sortie spécifiés existent déjà), MakePri.exe nécessite une confirmation avant le remplacement.

Following file(s) already exist at output location:
<file(s)>
Overwrite these file(s)? [Y]es (any other key to cancel):

Option /OutputFile(of)

Vous utilisez l’option de fichier de sortie (/of) avec dump, new, resourcepacket versioned pour spécifier l’emplacement de sortie et le nom du fichier PRI à générer. Si MakePri.exe génère plusieurs fichiers PRI de ressource, il les place dans le dossier parent du fichier cible. Par exemple, si vous spécifiez /of MyParentFolder\TargetFile.pri , MakePri.exe génère TargetFile.language-en.pri et TargetFile.scale-100.pri en même TargetFile.pri temps que sous ParentFolder.

Voici un exemple de condition d’erreur et le message d’erreur correspondant.

Condition d’erreur Message d’erreur
Le nom du fichier de sortie est identique à l’un des noms du pack de ressources dans la configuration. Configuration non valide : le nom <> du pack de ressources du pack de ressources ne peut pas être identique au nom du fichier <de sortie outputfilename.pri>.

Option /ReverseMap(rm)

Vous utilisez l’option de mappage inverse (/rm) avec new, resourcepacket versioned pour générer une section de mappage inverse dans le fichier PRI, qui peut être utilisée pour le débogage.

Option /SchemaFile(sf)

Vous utilisez l’option de fichier de schéma (/sf) avec new, resourcepacket versioned pour écrire un fichier de schéma à l’emplacement spécifié.

Pour resourcepack et versioned, au lieu de fournir un fichier PRI comme paramètre d’entrée pour /IndexFile(if), vous pouvez à la place fournir un fichier de schéma.

/SchemaFile(sf) <FILEPATH>

FILEPATH est un jeton qui spécifie où écrire le fichier de schéma.

Il s’agit d’un exemple de fichier de schéma.

<PriInfo>
	<ResourceMap name="IndexName" resourceVersion="1.0"> 
		<ResourceMapSubtree name="Resources" index="1">
			<NamedResource name="String1" index="1"/>
			<NamedResource name="String2" index="1"/>
		</ResourceMapSubtree>
		<ResourceMapSubtree name="Files" index="2">
			<NamedResource name="logo.png" index="2"/>
			<ResourceMapSubtree name="images" index="3">
				<NamedResource name="success.png" index="3"/>
				<NamedResource name="error.png" index="3"/>
			</ResourceMapSubtree>
		</ResourceMapSubtree>
	</ResourceMap>
</PriInfo>

/VersionMajor(vma) est déconseillé

L’option principale (/vma) (pour la new commande) est déconseillée et l’utilisation de celle-ci génère ce message d’avertissement.

'VersionMajor (vma)' input parameter has been deprecated. Please specify major version in the configuration file using 'majorVersion' attribute on 'resources' node.

Pour fournir le numéro de version principal, utilisez l’attribut resources@majorVersion dans votre fichier de configuration.