MakePRI.exe command options
This topic lists the command options for MakePRI.exe, a command line tool that you can use to create and dump Package Resource Index (PRI) files.
This topic is referenced in the Compiling resources (MakePRI.exe) section of the Resource Management System topic.
For info about changes to command options for Windows 8.1 and later, see What's new for MakePRI.exe command options.
The command options for MakePri.exe are listed here, with the usage help that is included with the tool.
createconfig
Usage:
------
MakePri.exe createconfig /cf <config file destination> /dq
<default qualifiers> [options]
Example:
--------
MakePri.exe createconfig /cf C:\MyApp\priconfig.xml /dq en-US /o
Description:
------------
MakePri.exe createconfig 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 qualifier set in the
configuration file. Some qualifiers are required
(i.e. language)
Options:
--------
/Overwrite(o) : Overwrite an existing output file of the same name
without prompting
/Help(h, ?) : Display the usage help text
/ExtensionDll(ex) : <FILEPATH> Location of the MRT environment extension
DLL. This DLL must be signed by a Microsoft-issued
certificate. Default is an empty path (no DLL
will be used).
FOLDERPATH - is a valid path to a folder
QUALIFIERS - is a valid qualifier token
(i.e. lang-en-US_scale-100_contrast-high)
new
Usage:
------
MakePri.exe new /pr <project root> /cf <config file> [options]
Example:
--------
MakePri.exe new /pr C:\MyApp\src\ /cf C:\MyApp\priconfig.xml /mn
C:\MyApp\AppXManifest.xml /of C:\MyApp\src\resources.pri /o
Description:
------------
Creates a PRI file at [outputfile] by indexing all files in the
[projectroot]and its subdirectories as directed by the [configxml]. The
index will be assigned [indexname] to reference resources in the application
Required Parameters:
--------------------
/ProjectRoot(pr) : <FOLDERPATH> Root location of project files
/ConfigXml(cf) : <FILEPATH> Configuration file location. Use
'Makepri.exe createconfig' command to generate one
Options:
--------
/OutputFile(of) : <FILEPATH> Output location of PRI file, default is
[projectroot]\resources.pri
/Manifest(mn) : <FILEPATH> Location of the application or component's
manifest. This parameter is ignored if [indexname]
is given. Default is [projectroot]\AppXManifest.xml
/IndexName(in) : <STRING> Name for the generated index of resources.
Typically matches the app package name, class library
simple name, etc. May be supplied via the
[manifest] parameter.
/VersionMajor(vma): <INTEGER> [Deprecated] Major version number for
index, default is 1
/IndexLog(il) : <FILEPATH> XML Log of indexed resources, no file
generated by default
/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.
/ReverseMap(rm) : Generate a reverse mapping section in the PRI file
which can be used for debugging purposes.
/MappingFile(mf) : <MAPPINGFILETYPE> Generate a mapping file in the given
file format.
/SchemaFile(sf) : <FILEPATH> Output location of XML resource schema
description.
/Overwrite(o) : Overwrite an existing output file of the same name
without prompting
/Verbose(v) : Causes verbose messages to be output to the console
/Help(h, ?) : Display the usage help text
/ExtensionDll(ex) : <FILEPATH> Location of the MRT environment extension
DLL. This DLL must be signed by a Microsoft-issued
certificate. Default is an empty path (no DLL
will be used).
FOLDERPATH - is a valid path to a folder
FILEPATH - is a path to a file, either relative to the current
directory or absolute
MAPPINGFILETYPE - Supported File type(s): 'AppX'
versioned
Usage:
------
MakePri.exe versioned /pr <project root> /cf <config file> [options]
Example:
--------
MakePri.exe versioned /o /if C:\MyApp\1.2\resources.pri /pr C:\MyApp\src
/cf C:\MyApp\priconfig.xml /of C:\MyApp\src\resources.pri /o
Description:
------------
MakePri.exe versioned creates a versioned PRI file at [outputfile] by
indexing all files in the [projectroot] and its subdirectories based on
[indexfile] and as directed by the [configxml].
Required Parameters:
--------------------
/ProjectRoot(pr) : <FOLDERPATH> Root location of project files
/ConfigXml(cf) : <FILEPATH> Configuration file location. Use
'Makepri.exe createconfig' command to generate one
Options:
--------
/OutputFile(of) : <FILEPATH> Output location of PRI file, default is
[projectroot]\resources.pri
/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
/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.
/ReverseMap(rm) : Generate a reverse mapping section in the PRI file
which can be used for debugging purposes.
/MappingFile(mf) : <MAPPINGFILETYPE> Generate a mapping file in the given
file format.
/SchemaFile(sf) : <FILEPATH> Output location of XML resource schema
description.
/Overwrite(o) : Overwrite an existing output file of the same name
without prompting
/Verbose(v) : Causes verbose messages to be output to the console
/Help(h, ?) : Display the usage help text
/ExtensionDll(ex) : <FILEPATH> Location of the MRT environment extension
DLL. This DLL must be signed by a Microsoft-issued
certificate. Default is an empty path (no DLL
will be used).
FOLDERPATH - is a valid path to a folder
FILEPATH - is a path to a file, either relative to the current
directory or absolute
MAPPINGFILETYPE - Supported File type(s): 'AppX'
resourcepack
Usage:
------
MakePri.exe resourcepack /pr <project root> /cf <config file> [options]
Example:
--------
MakePri.exe resourcepack /o /if C:\MyApp\1.2\resources.pri
/pr C:\MyAppEs /cf C:\MyAppEs\priconfig.xml /of C:\MyAppEs\resources.pri
Description:
------------
MakePri.exe resourcepack creates a PRI file at [outputfile] by indexing
all files in the [projectroot] and its subdirectories as directed by the
[configxml]. ResourcePack PRI files contain only additional variants of
resources already specified in [indexfile].
Required Parameters:
--------------------
/ProjectRoot(pr) : <FOLDERPATH> Root location of project files
/ConfigXml(cf) : <FILEPATH> Configuration file location. Use
'Makepri.exe createconfig' command to generate one
Options:
--------
/OutputFile(of) : <FILEPATH> Output location of PRI file, default is
[projectroot]\resources.pri
/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
/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.
/ReverseMap(rm) : Generate a reverse mapping section in the PRI file
which can be used for debugging purposes.
/MappingFile(mf) : <MAPPINGFILETYPE> Generate a mapping file in the given
file format.
/SchemaFile(sf) : <FILEPATH> Output location of XML resource schema
description.
/Overwrite(o) : Overwrite an existing output file of the same name
without prompting
/Verbose(v) : Causes verbose messages to be output to the console
/Help(h, ?) : Display the usage help text
/ExtensionDll(ex) : <FILEPATH> Location of the MRT environment extension
DLL. This DLL must be signed by a Microsoft-issued
certificate. Default is an empty path (no DLL
will be used).
FOLDERPATH - is a valid path to a folder
FILEPATH - is a path to a file, either relative to the current
directory or absolute
MAPPINGFILETYPE - Supported File type(s): 'AppX'
dump
Usage:
------
MakePri.exe dump [options]
Example:
--------
MakePri.exe dump /if C:\MyApp\resources.pri
/of C:\resources.pri.xml
Description:
------------
MakePri.exe dump outputs a dumped xml file at [outputfile] containing a
list of all resources in [indexfile].
Options:
--------
/OutputFile(of) : <FILEPATH> Output location of the dump file, default
is .\[indexfile].xml
/IndexFile(if) : <FILEPATH> Location of the PRI file to dump from,
default is .\resources.pri
/DumpType(dt) : <STRING> Format of the dumped file, default is
Basic
/Overwrite(o) : Overwrite an existing output file of the same name
without prompting
/Verbose(v) : Causes verbose messages to be output to the console
/Help(h, ?) : Display the usage help text
/ExtensionDll(ex) : <FILEPATH> Location of the MRT environment extension
DLL. This DLL must be signed by a Microsoft-issued
certificate. Default is an empty path (no DLL
will be used).
Dump Type:
Either 'Basic', 'Detailed' or 'Schema'
FOLDERPATH - is a valid path to a folder
FILEPATH - is a path to a file, either relative to the current
directory or absolute
Related topics
Resource Management System, Compiling resources (MakePRI.exe)