Opciones de línea de comandos de MakePri.exe
MakePri.exe tiene el conjunto de comandos createconfig, dump, new, resourcepacky versioned. En este tema se detallan las opciones de línea de comandos para su uso.
Nota:
MakePri.exe se instala al comprobar la opción Windows SDK para aplicaciones administradas UWP al instalar el Kit de desarrollo de software de Windows. Se instala en la ruta de acceso %WindowsSdkDir%bin\<WindowsTargetPlatformVersion>\x64\makepri.exe (así como en carpetas denominadas para las demás arquitecturas). Por ejemplo, C:\Program Files (x86)\Windows Kits\10\bin\10.0.17713.0\x64\makepri.exe.
Obtener ayuda de la línea de comandos
Puede ejecutar MakePri.exe help o MakePri.exe /? ver los comandos que puede usar con MakePri.exe. También puede emitir MakePri.exe <command> /? para ver detalles sobre un comando y, en casos muy poco frecuentes, incluso MakePri.exe <command> <option> para ver detalles específicos sobre una opción.
Comandos 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 /?
Comando Createconfig
El createconfig comando crea un nuevo archivo de configuración PRI inicializado que define los valores predeterminados del calificador que especifique. Ejecute MakePri.exe createconfig /? para ver la ayuda detallada de este comando.
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
Comando Dump
El dump comando genera un archivo XML volcado que contiene una lista de todos los recursos de un archivo PRI especificado. Ejecute MakePri.exe dump /? para ver la ayuda detallada de este comando.
Nota:
Un paquete de recursos sin esquema es el que se creó con el modificador omitSchemaFromResourcePacks en el archivo de configuración pri. Para volcar un paquete de recursos sin esquemas, use el modificador /es <main_package_PRI_file>. Si no especifica el archivo principal, verá el mensaje de error "The resources.pri in the package was corrupted so encryption failed (error PRI222: 0xdef0000f - Error no especificado)".
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
Nuevo comando
El new comando crea un nuevo archivo PRI indizando los archivos del proyecto como se indica en el archivo de configuración. Ejecute MakePri.exe new /? para ver la ayuda detallada de este comando.
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
Comando ResourcePack
El resourcepack comando crea un nuevo archivo PRI indizando los archivos del proyecto como se indica en el archivo de configuración. Un archivo PRI del paquete de recursos contiene solo variantes adicionales de los recursos ya especificados en un archivo PRI existente. Ejecute MakePri.exe resourcepack /? para ver la ayuda detallada de este comando.
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
Comando con versiones
El versioned comando crea un archivo PRI con versiones indizando los archivos del proyecto como se indica en el archivo de configuración. Ejecute MakePri.exe versioned /? para ver la ayuda detallada de este comando.
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)
Use la opción DLL de extensión (/ex) con createconfig, dump, new, resourcepacky versioned para especificar la ubicación del archivo DLL de extensión de entorno del sistema de administración de recursos.
Registro o archivo de metadatos
MakePri puede incluir información específica de un paquete de recursos en el archivo de metadatos del indexador. Este es un ejemplo de un archivo de registro para resources.pri con archivos german.pri PRI de recursos y 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>
Opción /IndexFile(if)
Use la opción de archivo de índice (/if) con dump, resourcepacky versioned para especificar un archivo PRI de entrada.
Para resourcepack y versioned, en lugar de proporcionar un archivo PRI como parámetro de entrada para /IndexFile(if), puede proporcionar en su lugar un archivo de esquema.
/IndexFile(if) <FILEPATH>
FILEPATH es un token que especifica la ubicación del archivo PRI de entrada o del archivo de esquema PRI.
Opción /IndexOptions(io)
Use la opción de opciones de índice (/io) con new, resourcepacky versioned para especificar opciones que proporcionan control detallado sobre el comportamiento de los indexadores de recursos. Las opciones de índice están deshabilitadas de forma predeterminada.
/IndexOptions(io) <OPTIONS>
OPTIONS es una lista separada por comas formada por las siguientes opciones.
- +/-HiddenFiles(hf). Index (+) o ignore (-) archivos y carpetas ocultos.
- +/-LinkedFiles(lf). Index (+) o ignore (-) archivos vinculados y carpetas.
Opción /MappingFile(mf)
Use la opción de archivo de asignación (/mf) con new, resourcepacky versioned para generar un archivo de asignación. MakeAppx.exe usa el archivo de asignación para generar paquetes de aplicaciones.
/MappingFile(mf) <MAPPINGFILETYPE>
MAPPINGFILETYPE es un token que especifica el formato del archivo de asignación. El único formato admitido válido es appx.
/mf appx
Este es un contenido de ejemplo de un archivo de asignación principal.
"ResourceDimensions" "language-de-de"
Y este es un contenido de ejemplo de un archivo de asignación de paquetes de recursos.
"ResourceId" "Resources184.la5decaf08"
"ResourceDimensions" "language-de-de"
Resumen de salida
Si se crean paquetes de recursos, el resumen de salida de MakePRI.exe es de forma más detallada. Este es un ejemplo.
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
Opción /Overwrite(o)
Si no se proporciona la opción de sobreescritura (/o) y los archivos de salida especificados ya existen, MakePri.exe requiere una confirmación antes de sobrescribir.
Following file(s) already exist at output location:
<file(s)>
Overwrite these file(s)? [Y]es (any other key to cancel):
Opción /OutputFile(of)
Use la opción de archivo de salida (/of) con dump, new, resourcepacky versioned para especificar la ubicación de salida y el nombre del archivo PRI que se va a generar. Si MakePri.exe genera más de un archivo PRI de recursos, los coloca en la carpeta primaria del archivo de destino. Por ejemplo, si especifica /of MyParentFolder\TargetFile.pri , MakePri.exe genera TargetFile.language-en.pri y TargetFile.scale-100.pri junto con TargetFile.pri en ParentFolder.
Esta es una condición de error de ejemplo y el mensaje de error correspondiente.
| Condición de error | Mensaje de error |
|---|---|
| El nombre del archivo de salida es el mismo que uno de los nombres del paquete de recursos de la configuración. | Configuración no válida: el nombre del paquete de recursos del paquete <> de recursos no puede ser el mismo que el archivo <de salida outputfilename.pri>. |
Opción /ReverseMap(rm)
Use la opción de asignación inversa (/rm) con new, resourcepacky versioned para generar una sección de asignación inversa en el archivo PRI, que se puede usar para la depuración.
Opción /SchemaFile(sf)
Use la opción de archivo de esquema (/sf) con new, resourcepacky versioned para escribir un archivo de esquema en la ubicación especificada.
Para resourcepack y versioned, en lugar de proporcionar un archivo PRI como parámetro de entrada para /IndexFile(if), puede proporcionar en su lugar un archivo de esquema.
/SchemaFile(sf) <FILEPATH>
FILEPATH es un token que especifica dónde escribir el archivo de esquema.
Este es un ejemplo de un archivo de esquema.
<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á en desuso
La opción de versión principal (/vma) (para el new comando) está en desuso y su uso da como resultado este mensaje de advertencia.
'VersionMajor (vma)' input parameter has been deprecated. Please specify major version in the configuration file using 'majorVersion' attribute on 'resources' node.
Para proporcionar el número de versión principal, use el atributo resources@majorVersion en el archivo de configuración.