PowerToys 新工程如何接入 CDPX 本地化流水线并生成多语言资源【免费下载链接】PowerToysMicrosoft PowerToys is a collection of utilities that supercharge productivity and customization on Windows项目地址: https://gitcode.com/GitHub_Trending/po/PowerToys在 PowerToys 仓库中新开发一个模块或把一个老模块的界面字符串从硬编码改为资源化后如果希望这些字符串跟随官方的 CDPX 本地化流水线被翻译成各语言版本需要按仓库既有约定组织资源文件英文resx/resw/rc文件放在正确位置让流水线能下载到本地化团队产出的翻译文件再按项目类型把本地化资源编进构建产物最后仅 C# 项目把 satellite dll 加入 MSI。本文依据 本地化开发文档 与流水线定义文件给出一条可照做的接入路径。前置约定只有一条代码中不允许硬编码 UI 显示字符串所有展示文本必须来自资源文件。C 用StringTableresource.h存 ID.rc存字符串C#/UWP 用资源文件.resx/.resw。资源文件要放在流水线能识别的位置本地化文件由 Touchdown 服务产出。流水线会按文件路径 glob 下载翻译结果当前 v2 流水线的下载步骤定义在 steps-fetch-and-prepare-localizations.yml- task: TouchdownBuildTask5 displayName: Download Localization Files -- PowerToys 37400 inputs: teamId: 37400 resourceFilePath: | **\Resources.resx **\Resource.resx **\Resources.resw appendRelativeDir: true localizationTarget: false也就是说英文资源必须命名为Resources.resx、Resource.resx或Resources.resw放在对应项目目录下翻译产出才能被这一步匹配到。独立的 夜间本地化构建loc.yml每天 03:00 UTC周二至周六运行产出LocOutput工件本地化团队正是基于英文 resx 的变化提交翻译即下文提到的lcl文件。下载完成后流水线会执行两个整理脚本同样在模板末尾调用move-and-rename-resx.ps1把 Touchdown 按Folder/Language/x.resx目录结构产出的 C# 资源文件改名为Properties/x.Language.resx放在项目Properties目录下脚本只处理Properties目录下的 resx不会动 Win32 项目的 resxmove-uwp-resw.ps1修正 UWPresw文件 Touchdown 产出的错误路径en-us/lang-lang移动到正确位置。按项目类型接入本地化资源C# 项目C# 原生支持resx接入只需保证本地化生成的*.Language.resx参与编译.NET Core 项目会自动包含.csproj无需改动其他项目需要在.csproj中显式加入EmbeddedResource IncludeProperties\Resources.*.resx /如果项目目前用 XAML 资源而需要迁移到 resx文档给出的做法是把x:Key形式改为keyvalue的纯文本用编辑器全局替换或脚本再在Developer Command Prompt for VS中对它运行resgen转换为 resx随后把代码中的字符串引用改为Properties.Resources.resName。构建带本地化资源时可能出现警告Referenced assembly mscorlib.dll targets a different processor这是 VS 的已知 bug文档明确不需要处理。UWP 项目UWP 使用resw且文件必须是fullLangId\Resources.resw的目录结构。把 csproj 中PRIResource IncludeStrings\en-us\Resources.resw /替换为PRIResource IncludeStrings\*\Resources.resw /C 项目CDPX 流水线不支持直接本地化rc文件PowerToys 的解法是英文字符串放在resx中受 CDPX 翻译构建时再用脚本把 resx 转回rc/resource.h。步骤若项目已有.rc把要本地化的字符串表单独拷到一个 txt 文件格式必须是IDS_ResName LResourceValue中间空格数量不限然后运行 convert-stringtable-to-resx.ps1 转换。注意资源名会从全大写改为 Title Case 并去掉IDS_前缀rc 里的转义双引号需先手动替换为。把现有 rc、h 文件改名为ProjName.base.rc、resource.base.h从 rc 中删除要本地化的字符串表从 h 中删除对应的#define。在 vcxproj 中加构建事件文档原文Target NameGenerateResourceFiles BeforeTargetsPrepareForBuild Exec LogStandardErrorAsErrorfalse Commandpowershell -NonInteractive -executionpolicy Unrestricted -NoProfile $(SolutionDir)tools\build\convert-resx-to-rc.ps1 $(MSBuildThisFileDirectory) resource.base.h resource.h ProjName.base.rc ProjName.rc / /Target该事件调用 convert-resx-to-rc.ps1读取目录下所有 resx含各语言版本结合 base 文件在Generated Files目录生成resource.h和ProjName.rc。生成的 rc 中每个语言对应一段带LANGUAGE LANG_*, SUBLANG_*的STRINGTABLE语言代码表硬编码在脚本中脚本内目前覆盖 en、zh-Hans、de、fr、ja、ko 等 28 个语言 ID将来新增语言时必须先更新该脚本。资源 ID 默认从 101 开始脚本第 6 个可选参数可改。配套的两个坑生成物在Generated Files目录下所以原 base 文件里的 include 需要多加一层..\引用头文件时写作Generated Files\resource.hresource.base.h与ProjName.base.rc加入 vcxproj 时不要参与构建写成None IncludeResources.resx /如果同一对 rc/resource.h 被多个项目共用例如 Keyboard Manager文档建议把构建事件提升到目录级见 keyboardmanager 的 Directory.Build.targets。把本地化产物加进 MSI本地化资源文件只存在于流水线机器上本地没有翻译 resx因此安装器相关改动必须保证本地构建不失败、流水线构建才打进翻译产物。C 与 UWP 项目无需改 MSIC 资源直接编进 dll/exeUWP 资源进resources.pri未本地化的项目也有此文件。C# 项目需要加入 satellite dll构建后会按langId\ProjName.resources.dll形式生成langId与 lcl 文件使用的语言格式一致。老安装器installer/PowerToysSetup/Product.wxs的做法是把项目目录名加进按IsPipeline变量判断的 satellite dll 段并按此格式创建资源组件Component IdProjName_$(var.IdSafeLanguage)_Component DirectoryResource$(var.IdSafeLanguage)ProjNameInstallFolder File IdProjName_$(var.IdSafeLanguage)_File Source$(var.BinX64Dir)modules\ProjName\$(var.Language)\ProjName.resources.dll / /Component用IsPipeline做开关的原因是本地没有本地化 resx不加这个判断会导致本地构建安装器直接失败。硬性顺序资源 dll 必须在本地化团队完成 lcl 文件的首次提交之后才能加入 MSI否则流水线因找不到可生成 dll 的 resx 而失败。签名方面确认新 dll 形如*.resources.dll会被流水线签名步骤覆盖。验证方式与边界UWP打开Developer Command Prompt for VS进入含resources.pri的目录执行makepri.exe dump /if .\resources.pri检查生成的resources.pri.xml末段应包含各语言的Candidate。文档示例来自 Keyboard Manager 的翻译条目非固定预期值NamedResource nameGeneralSettings_RunningAsAdminText urims-resource://f4f787a5-f0ae-47a9-be89-5408b1dd2b47/Resources/GeneralSettings_RunningAsAdminText Candidate qualifiersLanguage-FR typeString ValueRunning as administrator/Value /Candidate Candidate qualifiersLanguage-EN-US isDefaulttrue typeString ValueRunning as administrator/Value /Candidate /NamedResourceC#/C以构建结果为准。本地化 PRLEGO PR会更新lcl文件此类 PR 要求跑 build farm若本地化步骤报错检查对应 resx/lcl 文件是否有冲突典型坏例同一个资源出现两个Tgt元素。fail-safe 机制CDPX 会比对 lcl 文件中Val![CDATA[...]]/Val里的英文串与英文Resources.resx中的当前值两者不一致时该条翻译不会被写入本地化 resx而是回退用英文串。这意味着修改英文资源后旧翻译会自动失效不需要手工清理。lcl 文件结构lcl 包含英文 resx 的全部条目及翻译如有。初次提交时只有英文Val没有Tgt元素。下一步接入后英文resx有改动时 CDPX 流水线会通知本地化团队翻译经 lcl 文件回流[loc.yml](https://link.gitcode.com/i/abc693a08868386fab7f4591304cc131)的夜间构建持续产出LocOutput工件可用于在本地检查翻译产出内容。流水线变量与流程的更多细节文档指向 OneBranch 的内部 Localization wiki需内部账号仓库内可见的完整链路即本文所引的模板与脚本。【免费下载链接】PowerToysMicrosoft PowerToys is a collection of utilities that supercharge productivity and customization on Windows项目地址: https://gitcode.com/GitHub_Trending/po/PowerToys创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考