|
|
本页面的内容：
GatherText 命令
用于收集的命令
GatherTextFromSource 命令
GatherTextFromAssets 命令
GatherTextFromMetadata 命令
用于生成的命令
GenerateGatherManifest 命令
GenerateGatherArchive 命令
GenerateTextLocalizationResource 命令
用于维护的命令
RepairLocalizationData 命令
GenerateTextLocalizationReport 命令
GatherText 命令
主要命令行指令，必须运行它才能配置和运行其他本地化的命令行。它只有一个参数：Config，用于指定所需的 INI 格式文件的路径，该文件列出了要执行的其他命令行及各自的配置。该命令会读取指定文件并使用基于 0 的索引数字后缀来查找名为 GatherTextStep 的部分。每一步都必须为 CommandletClass 键（用于指定要执行的命令行的资源文件名称）指定一个值。关于命令行的其他配置可以在 CommonSettings 部分提供。
除非另外指定，提供的所有路径都应当以项目的根资源详细内容作为相对路径。
其他所有命令行都有 Config 参数和 Section 参数，用于读取指定 INI 文件中的指定 Section 部分，以及 CommonSettings 部分。
用于收集的命令
GatherTextFromSource 命令
这个命令可以扫描那些通过指定筛选器的指定资源详细内容，分析匹配文件寻找 LOCTEXT_NAMESPACE、LOCTEXT、NSLOCTEXT 之类的标记以及其他与本地化存在特殊关联的宏， 为后续处理来收集这些文本。
设置
说明
ManifestDependencies对于指定清单中发现的文本将不予收集。IncludePaths指定的路径将被扫描。ExcludePaths与指定样式相匹配的路径将排除在扫描之外。SourceFileSearchFilters与指定样式相匹配的文件将被进行分析。
GatherTextFromAssets 命令
这个命令将扫描通过指定筛选器的特定资源详细内容，加载找到的资源包以及引用到的其他资源包，为后续处理收集文本。
设置
说明
ManifestDependencies对于指定清单中发现的文本将不予收集。ModulesToPreload在迭代引用资源包之前所加载模块的资源文件名称。如果发现的资源包依赖于一个未加载的模块，则使用此配置。IncludePaths指定的路径将被扫描。ExcludePaths与指定样式相匹配的路径将排除在扫描之外。PackageExtensions拥有指定扩展名的资源包将被迭代访问。ExcludeClasses将不会从资源包内这些类型的实例中收集文本。bFixBroken当资源内的文本缺少键或与其他文本存在冲突时，可以通过此项进行修复。
GatherTextFromMetadata 命令
这个命令可以扫描通过指定筛选器的指定资源详细内容，迭代访问从这些资源详细内容获取类的对象的元数据，并通过元数据值创建文本 用于指定的元数据键。必须通过设置来指定要读取的元数据，以及所创建文本的命名空间和键。键可以使用格式化参数，包括：
参数
说明
FieldPath此元数据的来源对象所在的有效路径。MetaDataValue元数据键的字符串值。
设置
说明
ManifestDependencies对于指定清单中发现的文本将不予收集。ModulesToPreload在迭代引用资源包之前所加载模块的资源文件名称。如果发现的资源包依赖于一个未加载的模块，则使用此配置。IncludePaths指定的路径将被扫描。ExcludePaths与指定样式相匹配的路径将排除在扫描之外。InputKeys创建文本时所用的元数据键。OutputNamespaces用于已创建文本的命名空间。OutputKeys要进行格式化并用于已创建文本键的样式字符串。用于生成的命令
GenerateGatherManifest 命令
这个命令可以使用由其他收集类 commandlet 收集的数据，将一个具有指定资源文件名称的清单文件写入到指定资源详细内容。
设置
说明
ManifestDependencies指定清单中发现的文本将不会写入到新的清单。DestinationPath要写入清单文件的资源详细内容所在的路径。ManifestName要写入的清单文件的完整资源文件名称，通常与目标同名并带有“manifest”扩展名。
GenerateGatherArchive 命令
这个命令可以将指定资源文件名称的存档文件写入到某一指定资源详细内容中带有相关文化资源文件名称的指定子资源详细内容（使用指定的清单文件）。已经存在的现有存档将被更新。
设置
说明
DestinationPath包含清单的资源详细内容所在的路径，以及要写入的存档所在的针对特定文化的子资源详细内容的路径。ManifestName要读取的清单文件的完整资源文件名称，通常与目标同名并带有“manifest”扩展名。ArchiveName要写入的存档文件的完整资源文件名称，通常与目标同名并带有“archive”扩展名。SourceCulture源文本所属的文化资源文件名称。该文化对应的存档将直接包含源字符串作为其翻译字符串。CulturesToGenerate生成的存根存档对应的文化资源文件名称。bPurgeOldEmptyEntries如果为_true_，缺少翻译的现有存档文件中的条目将被移除，然后会用清单中的新条目去更新存档。这样，那些已经从清单内消失以及尚未翻译的条目都会被清除。
GenerateTextLocalizationResource 命令
这个命令可以将指定资源文件名称的本地化资源文件写入到某一指定资源详细内容中带有相关文化资源文件名称的指定子资源详细内容（使用指定的清单文件和所有发现的存档文件）。
设置
说明
SourcePath包含清单的资源详细内容所在的路径，以及要写入的存档所在的针对特定文化的子资源详细内容的路径。ManifestName要读取的清单文件的完整资源文件名称，通常与目标同名并带有“manifest”扩展名。CulturesToGenerate生成的本地化资源对应的文化资源文件名称。DestinationPath要写入的本地化资源所在的针对特定文化的子资源详细内容的资源详细内容路径。ResourceName要写入的本地化资源文件的完整资源文件名称，通常与目标同名并带有“locres”扩展名。用于维护的命令
RepairLocalizationData 命令
这个命令可以修复并更新不同版本的本地化数据。它还能特意修复清单和存档。本地化资源可通过修复/更新后的清单和存档重新（正常）生成。
设置
说明
DestinationPath包含清单的资源详细内容所在的路径，以及要读写的存档所在的针对特定文化的子资源详细内容的路径。ManifestName要读写的清单文件的完整资源文件名称，通常与目标同名并带有“manifest”扩展名。ArchiveName要读写的存档文件的完整资源文件名称，通常与目标同名并带有“archive”扩展名。CulturesToGenerate修复和更新的存档对应的文化资源文件名称。
GenerateTextLocalizationReport 命令
这个命令用于生成和更新报告，如字数和文本冲突。
设置
说明
DestinationPath要写入报告的资源详细内容路径。bWordCountReport如果为_true_，将生成字数报告。SourcePath包含清单的资源详细内容所在的路径，以及要读取的存档所在的针对特定文化的子资源详细内容的路径。ManifestName要读取的清单文件的完整资源文件名称，通常与目标同名并带有“manifest”扩展名。CulturesToGenerate读取的存档对应的文化资源文件名称。WordCountReportName包含一段时间内相应文化的字数表格的、要读写的 CSV （逗号分隔值）文件的完整资源文件名称。bConflictReport如果为_true_，将生成冲突报告。ConflictReportName包含所有存在冲突的命名空间/键/文本条目列表的、要写入的文本文件的完整资源文件名称。 |
|
发表于 2016-6-27 16:41:18
发表于 2016-7-2 20:23:21
