MakePri.exe 格式特定索引器
本主题介绍 MakePri.exe 工具生成资源索引时使用的特定于格式的索引器。
注意
在安装 Windows 软件开发工具包时,如果勾选“适用于 UWP 托管应用的 Windows SDK”选项,将安装 MakePri.exe。 将安装到路径 %WindowsSdkDir%bin\<WindowsTargetPlatformVersion>\x64\makepri.exe
(以及以其他体系结构命名的文件夹中)。 例如 C:\Program Files (x86)\Windows Kits\10\bin\10.0.17713.0\x64\makepri.exe
。
MakePri.exe 通常与 new
、versioned
或 resourcepack
命令一起使用。 请参阅 MakePri.exe 命令行选项。 在这些情况下,它会为源文件编制索引以生成资源索引。 MakePri.exe 使用各种单独的索引器来读取资源的不同源资源文件或容器。 最简单的索引器是文件夹索引器,它为文件夹的内容编制索引,例如 .jpg
或 .png
图像。
可以通过在 MakePri.exe 配置文件的 <index>
元素中指定 <indexer-config>
元素来标识特定于格式的索引器。 type
属性标识所使用的特定于格式的索引器。
在索引编制期间遇到的资源容器通常获取已编制索引的内容,而不是将内容本身添加到索引中。 例如,文件夹索引器查找的 .resjson
文件可能由 .resjson
索引器进一步编制索引,在这种情况下,.resjson
文件本身不会出现在索引中。 请注意,与该容器关联的索引器的 <indexer-config>
元素必须包含在配置文件中,才会发生这种情况。
通常情况下,在包含实体(如文件夹或 .resw
文件)上找到的限定符应用到其中的所有资源,如文件夹中的文件,或 .resw
文件中的字符串。
文件夹
文件夹索引器由 FOLDER 的 type
属性标识。 它为文件夹的内容编制索引,并确定文件夹和文件名中的资源限定符。 其配置元素符合以下架构。
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name="ExclusionTypeList">
<xs:restriction base="xs:string">
<xs:enumeration value="path"/>
<xs:enumeration value="extension"/>
<xs:enumeration value="name"/>
<xs:enumeration value="tree"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="FolderExclusionType">
<xs:attribute name="type" type="ExclusionTypeList" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
<xs:attribute name="doNotTraverse" type="xs:boolean" use="required"/>
<xs:attribute name="doNotIndex" type="xs:boolean" use="required"/>
</xs:complexType>
<xs:simpleType name="IndexerConfigFolderType">
<xs:restriction base="xs:string">
<xs:pattern value="((f|F)(o|O)(l|L)(d|D)(e|E)(r|R))"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="indexer-config">
<xs:complexType>
<xs:sequence>
<xs:element name="exclude" type="FolderExclusionType" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="type" type="IndexerConfigFolderType" use="required"/>
<xs:attribute name="foldernameAsQualifier" type="xs:boolean" use="required"/>
<xs:attribute name="filenameAsQualifier" type="xs:boolean" use="required"/>
<xs:attribute name="qualifierDelimiter" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:schema>
qualifierDelimiter
属性指定位于文件名中指定的限定符后的字符(忽略扩展名)。 默认为“.”。
PRI
PRI 索引器由 PRI 的 type
属性标识。 它为 PRI 文件的内容编制索引。 在将另一个程序集、DLL、SDK 或类库中的资源编制索引到应用的 PRI 中时,通常会使用它。
PRI 文件中包含的所有资源名称、限定符和值都直接保留在新的 PRI 文件中。 但是,顶层资源映射不会保留在最终 PRI 中。 资源映射已合并。
<xs:schema id="prifile" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:simpleType name="IndexerConfigPriType">
<xs:restriction base="xs:string">
<xs:pattern value="((p|P)(r|R)(i|I))"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="indexer-config">
<xs:complexType>
<xs:attribute name="type" type="IndexerConfigPriType" use="required"/>
</xs:complexType>
</xs:element>
</xs:schema>
PriInfo
PriInfo 索引器由 PriInfo 的 type
属性标识。 它为详细转储文件的内容编制索引。 通过使用 /dt detailed
选项运行 makepri dump
来生成详细的转储文件。 索引器的配置元素符合以下架构。
<xs:schema id="priinfo" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:simpleType name="IndexerConfigPriInfoType">
<xs:restriction base="xs:string">
<xs:pattern value="((p|P)(r|R)(i|I)(i|I)(n|N)(f|F)(o|O))"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="indexer-config">
<xs:complexType>
<xs:attribute name="type" type="IndexerConfigPriInfoType" use="required"/>
<xs:attribute name="emitStrings" type="xs:boolean" use="optional"/>
<xs:attribute name="emitPaths" type="xs:boolean" use="optional"/>
</xs:complexType>
</xs:element>
</xs:schema>
此配置元素允许使用可选属性配置 PriInfo 索引器的行为。 emitStrings
和 emitPaths
的默认值为 true
。 如果 emitStrings
为 true
,则索引中包含 type
属性设置为“String”的资源候选项,否则将排除这些候选项。 如果 emitPaths 为 true
,则索引中包含 type
属性设置为“Path”的资源候选项,否则将排除这些候选项。
以下是包含 String 资源类型但跳过 Path 资源类型的示例配置。
<indexer-config type="priinfo" emitStrings="true" emitPaths="false" />
若要编制索引,转储文件必须以扩展名 .pri.xml
结尾,并且必须符合以下架构。
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" >
<xs:simpleType name="candidateType">
<xs:restriction base="xs:string">
<xs:pattern value="Path|String"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="scopeType">
<xs:sequence>
<xs:element name="ResourceMapSubtree" type="scopeType" minOccurs="0" maxOccurs="unbounded"/>
<xs:element name="NamedResource" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Decision" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:any processContents="skip" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:anyAttribute processContents="skip" />
</xs:complexType>
</xs:element>
<xs:element name="Candidate" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="QualifierSet" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Qualifier" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:attribute name="name" type="xs:string" use="required" />
<xs:attribute name="value" type="xs:string" use="required" />
<xs:attribute name="priority" type="xs:integer" use="required" />
<xs:attribute name="scoreAsDefault" type="xs:decimal" use="required" />
<xs:attribute name="index" type="xs:integer" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:anyAttribute processContents="skip" />
</xs:complexType>
</xs:element>
<xs:element name="Value" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="type" type="candidateType" use="required" />
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="name" use="required" type="xs:string" />
<xs:anyAttribute processContents="skip" />
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="name" use="required" type="xs:string" />
<xs:anyAttribute processContents="skip" />
</xs:complexType>
<xs:element name="PriInfo">
<xs:complexType>
<xs:sequence>
<xs:element name="PriHeader" >
<xs:complexType>
<xs:sequence>
<xs:any minOccurs ="0" maxOccurs="unbounded" processContents="skip" />
</xs:sequence>
<xs:anyAttribute processContents="skip" />
</xs:complexType>
</xs:element>
<xs:element name="QualifierInfo">
<xs:complexType>
<xs:sequence>
<xs:any minOccurs="0" maxOccurs="unbounded" processContents="skip" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="ResourceMap">
<xs:complexType>
<xs:sequence>
<xs:element name="VersionInfo">
<xs:complexType>
<xs:anyAttribute processContents="skip" />
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="unbounded" name="ResourceMapSubtree" type="scopeType" />
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required" />
<xs:anyAttribute processContents="skip" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
MakePri.exe 支持转储类型“Basic”、“Detailed”、“Schema”和“Summary”。 若要将 MakePri.exe 配置为发出的转储类型可以由 PriInfo 索引器读取,请在使用 dump
命令时包含“/DumpType Detailed”。
MakePri.exe 跳过了 .pri.xml
文件的多个元素。 这些元素是在索引编制期间计算的,或在 MakePri.exe 配置文件中指定。 转储文件中包含的资源名称、限定符和值都直接保留在新的 PRI 文件中。 但是,顶层资源映射不会保留在最终 PRI 中。 资源映射合并到索引编制中。
以下是转储文件中有效的 String 类型资源的示例。
<NamedResource name="SampleString " index="96" uri="ms-resource://SampleApp/resources/SampleString ">
<Decision index="2">
<QualifierSet index="1">
<Qualifier name="Language" value="EN-US" priority="900" scoreAsDefault="1.0" index="1"/>
</QualifierSet>
</Decision>
<Candidate type="String">
<QualifierSet index="1">
<Qualifier name="Language" value="EN-US" priority="900" scoreAsDefault="1.0" index="1"/>
</QualifierSet>
<Value>A Sample String Value</Value>
</Candidate>
</NamedResource>
以下是包含转储文件中两个候选项的有效 Path 类型资源的示例。
<NamedResource name="Sample.png" index="77" uri="ms-resource://SampleApp/Files/Images/Sample.png">
<Decision index="2">
<QualifierSet index="1">
<Qualifier name="Scale" value="180" priority="500" scoreAsDefault="1.0" index="1"/>
</QualifierSet>
<QualifierSet index="2">
<Qualifier name="Scale" value="140" priority="500" scoreAsDefault="0.7" index="2"/>
</QualifierSet>
</Decision>
<Candidate type="Path">
<QualifierSet index="1">
<Qualifier name="Scale" value="180" priority="500" scoreAsDefault="1.0" index="1"/>
</QualifierSet>
<Value>Images\Sample.scale-180.png</Value>
</Candidate>
<Candidate type="Path">
<QualifierSet index="2">
<Qualifier name="Scale" value="140" priority="500" scoreAsDefault="1.0" index="1"/>
</QualifierSet>
<Value>Images\Sample.scale-140.png</Value>
</Candidate>
</NamedResource>
ResFiles
ResFiles 索引器由 RESFILES 的 type
属性标识。 它为 .resfiles
文件的内容编制索引。 其配置元素符合以下架构。
<xs:schema id="resx" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:simpleType name="IndexerConfigResFilesType">
<xs:restriction base="xs:string">
<xs:pattern value="((r|R)(e|E)(s|S)(f|F)(i|I)(l|L)(e|E)(s|S))"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="indexer-config">
<xs:complexType>
<xs:attribute name="type" type="IndexerConfigResFilesType" use="required"/>
<xs:attribute name="qualifierDelimiter" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
</xs:schema>
.resfiles
文件是包含文件路径简单列表的文本文件。 .resfiles
文件可以包含“//”注释。 下面是一个示例。
Strings\component1\fr\elements.resjson Images\logo.scale-100.png Images\logo.scale-140.png Images\logo.scale-180.png
ResJSON
ResJSON 索引器由 RESJSON 的 type
属性标识。 它为 .resjson
文件的内容编制索引,该文件是一个字符串资源文件。 其配置元素符合以下架构。
<xs:schema id="resjson" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:simpleType name="IndexerConfigResJsonType">
<xs:restriction base="xs:string">
<xs:pattern value="((r|R)(e|E)(s|S)(j|J)(s|S)(o|O)(n|N))"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="indexer-config">
<xs:complexType>
<xs:attribute name="type" type="IndexerConfigResJsonType" use="required"/>
<xs:attribute name="initialPath" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
</xs:schema>
.resjson
文件包含 JSON 文本(请参阅 JavaScript 对象表示法 (JSON) 的应用程序/json 媒体类型)。 该文件必须包含具有分层属性的单个 JSON 对象。 每个属性必须是另一个 JSON 对象或字符串值。
名称以下划线(“_”)开头的 JSON 属性不会编译到最终 PRI 文件中,但会保留在日志文件中。
该文件还可以包含分析期间忽略的“//”注释。
initialPath
属性通过将所有资源添加到资源名称前来将其放置在此初始路径下。 在为类库资源编制索引时,通常使用此方法。 默认为空。
ResW
ResW 索引器由 RESW 的 type
属性标识。 它为 .resw
文件的内容编制索引,该文件是一个字符串资源文件。 其配置元素符合以下架构。
<xs:schema id="resw" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:simpleType name="IndexerConfigResxType">
<xs:restriction base="xs:string">
<xs:pattern value="((r|R)(e|E)(s|S)(w|W))"/>
</xs:restriction>
</xs:simpleType>
<xs:element name="indexer-config">
<xs:complexType>
<xs:attribute name="type" type="IndexerConfigResxType" use="required"/>
<xs:attribute name="convertDotsToSlashes" type="xs:boolean" use="required"/>
<xs:attribute name="initialPath" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
</xs:schema>
.resw
文件是符合以下架构的 XML 文件。
<xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
<xsd:element name="root" msdata:IsDataSet="true">
<xsd:complexType>
<xsd:choice maxOccurs="unbounded">
<xsd:element name="metadata">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="value" type="xsd:string" minOccurs="0" />
</xsd:sequence>
<xsd:attribute name="name" use="required" type="xsd:string" />
<xsd:attribute name="type" type="xsd:string" />
<xsd:attribute name="mimetype" type="xsd:string" />
<xsd:attribute ref="xml:space" />
</xsd:complexType>
</xsd:element>
<xsd:element name="assembly">
<xsd:complexType>
<xsd:attribute name="alias" type="xsd:string" />
<xsd:attribute name="name" type="xsd:string" />
</xsd:complexType>
</xsd:element>
<xsd:element name="data">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
<xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
</xsd:sequence>
<xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
<xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
<xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
<xsd:attribute ref="xml:space" />
</xsd:complexType>
</xsd:element>
<xsd:element name="resheader">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
</xsd:sequence>
<xsd:attribute name="name" type="xsd:string" use="required" />
</xsd:complexType>
</xsd:element>
</xsd:choice>
</xsd:complexType>
</xsd:element>
</xsd:schema>
convertDotsToSlashes
属性将资源名称(数据元素名称属性)中找到的所有点(“.”)字符转换为正斜杠“/”,但当点字符介于“[”和“]”之间时除外。
initialPath
属性通过将所有资源添加到资源名称前来将其放置在此初始路径下。 在为类库资源编制索引时,通常使用此方法。 默认为空。