Opzioni della riga di comando per MakePri.exe
MakePri.exe include il set di comandi createconfig, dump, new, resourcepack e versioned. In questo argomento vengono fornite informazioni dettagliate sulle opzioni della riga di comando per l'uso.
Nota
MakePri.exe viene installato quando si seleziona l'opzione Windows SDK for UWP Managed Apps durante l'installazione di Windows Software Development Kit. Viene installato nel percorso %WindowsSdkDir%bin\<WindowsTargetPlatformVersion>\x64\makepri.exe (nonché nelle cartelle denominate per le altre architetture). Ad esempio: C:\Program Files (x86)\Windows Kits\10\bin\10.0.17713.0\x64\makepri.exe.
Ottenere assistenza dalla riga di comando
È possibile eseguire MakePri.exe help o MakePri.exe /? visualizzare i comandi che è possibile usare con MakePri.exe. È anche possibile eseguire un problema MakePri.exe <command> /? per visualizzare specifiche su un comando e, in casi molto rari, anche MakePri.exe <command> <option> per visualizzare specifiche su un'opzione.
Comandi 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
Il createconfig comando crea un nuovo file di configurazione PRI inizializzato che definisce le impostazioni predefinite del qualificatore specificate. Eseguire MakePri.exe createconfig /? per visualizzare la Guida dettagliata per questo 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
Il dump comando restituisce un file XML di cui è stato eseguito il dump contenente un elenco di tutte le risorse in un file PRI specificato. Eseguire MakePri.exe dump /? per visualizzare la Guida dettagliata per questo comando.
Nota
Un pacchetto di risorse senza schema è uno creato con l'opzione omitSchemaFromResourcePacks nel file di configurazione PRI. Per eseguire il dump di un pacchetto di risorse senza schema, usare l'opzione /es <main_package_PRI_file>. Se non si specifica il file principale, verrà visualizzato il messaggio di errore "The resources.pri in the package was corrupted so encryption failed (error PRI222: 0xdef0000f - Unspecified error occurred)".
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
Nuovo comando
Il new comando crea un nuovo file PRI indicizzando i file nel progetto come indicato dal file di configurazione. Eseguire MakePri.exe new /? per visualizzare la Guida dettagliata per questo 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
Il resourcepack comando crea un nuovo file PRI indicizzando i file nel progetto come indicato dal file di configurazione. Un file PRI del pacchetto di risorse contiene solo varianti aggiuntive di risorse già specificate in un file PRI esistente. Eseguire MakePri.exe resourcepack /? per visualizzare la Guida dettagliata per questo 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 controllo delle versioni
Il versioned comando crea un nuovo file PRI indicizzando i file nel progetto come indicato dal file di configurazione. Eseguire MakePri.exe versioned /? per visualizzare la Guida dettagliata per questo 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)
Usare l'opzione DLL di estensione (/ex) con createconfig, dump, new resourcepack e versioned per specificare il percorso della DLL dell'estensione dell'ambiente del sistema di gestione risorse.
File di registrazione/metadati
MakePri può includere informazioni specifiche di un pacchetto di risorse nel file di metadati dell'indicizzatore. Di seguito è riportato un esempio di file di log per resources.pri con file german.pri PRI di risorse e 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>
Opzione /IndexFile(if)
Usare l'opzione file di indice (/if) con dump, resourcepacke versioned per specificare un file PRI di input.
Per resourcepack e versioned, invece di fornire un file PRI come parametro di input per /IndexFile(if), è invece possibile fornire un file di schema.
/IndexFile(if) <FILEPATH>
FILEPATH è un token che specifica il percorso del file PRI di input o del file di schema PRI.
Opzione /IndexOptions(io)
Usare l'opzione opzioni di indice (/io) con new, resourcepacke versioned per specificare le opzioni che forniscono un controllo dettagliato sul comportamento degli indicizzatori di risorse. Le opzioni dell'indice sono disabilitate per impostazione predefinita.
/IndexOptions(io) <OPTIONS>
OPTIONS è un elenco delimitato da virgole costituito dalle opzioni seguenti.
- +/-HiddenFiles(hf). Indicizzare (+) o ignorare i file e le cartelle nascosti (-).
- +/-LinkedFiles(lf). Indicizzare (+) o ignorare i file e le cartelle collegati (-).
Opzione /MappingFile(mf)
Usare l'opzione file di mapping (/mf) con new, resourcepacke versioned per generare un file di mapping. MakeAppx.exe usa il file di mapping per generare pacchetti dell'app.
/MappingFile(mf) <MAPPINGFILETYPE>
MAPPINGFILETYPE è un token che specifica il formato del file di mapping. L'unico formato supportato valido è appx.
/mf appx
Questo è un esempio di contenuto di un file di mappatura principale.
"ResourceDimensions" "language-de-de"
Questo è un esempio di contenuto di un file di mapping del pacchetto di risorse.
"ResourceId" "Resources184.la5decaf08"
"ResourceDimensions" "language-de-de"
Riepilogo dell'output
Se vengono creati pacchetti di risorse, il riepilogo dell'output di MakePRI.exe è più dettagliato. Ecco un esempio.
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
/Overwrite(o) option
Se l'opzione sovrascrive (/o) non viene specificata e i file di output specificati esistono già, MakePri.exe richiede una conferma prima della sovrascrittura.
Following file(s) already exist at output location:
<file(s)>
Overwrite these file(s)? [Y]es (any other key to cancel):
Opzione /OutputFile(of)
Usare l'opzione del file di output (/of) con dump, new resourcepack e versioned per specificare il percorso di output e il nome del file PRI da generare. Se MakePri.exe genera più file PRI di risorse, li inserisce nella cartella padre del file di destinazione. Ad esempio, se si specifica /of MyParentFolder\TargetFile.pri , MakePri.exe genera TargetFile.language-en.pri e TargetFile.scale-100.pri insieme in TargetFile.pri ParentFolder.
Di seguito sono riportate alcune condizioni di errore di esempio e il messaggio di errore corrispondente.
| Condizione di errore | Messaggio d'errore |
|---|---|
| Il nome del file di output corrisponde a uno dei nomi dei pacchetti di risorse nella configurazione. | Configurazione non valida: il nome <> del pacchetto di risorse del Pacchetto di risorse non può corrispondere al file <di output outputfilename.pri>. |
Opzione /ReverseMap(rm)
Usare l'opzione mappa inversa (/rm) con new, resourcepacke versioned per generare una sezione di mapping inverso nel file PRI, che può essere usata per il debug.
Opzione /SchemaFile(sf)
Usare l'opzione file di schema (/sf) con new, resourcepacke versioned per scrivere un file di schema nel percorso specificato.
Per resourcepack e versioned, invece di fornire un file PRI come parametro di input per /IndexFile(if), è invece possibile fornire un file di schema.
/SchemaFile(sf) <FILEPATH>
FILEPATH è un token che specifica dove scrivere il file di schema.
Questo è un esempio di file di schema.
<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) è deprecato
L'opzione versione principale (/vma) (per il new comando) è deprecata e l'uso genera questo messaggio di avviso.
'VersionMajor (vma)' input parameter has been deprecated. Please specify major version in the configuration file using 'majorVersion' attribute on 'resources' node.
Per specificare il numero di versione principale, usare l'attributo resources@majorVersion nel file di configurazione.