GDevelop 开发者脚本工具链从文档生成、翻译提取到版本发布【免费下载链接】GDevelop Open-source, cross-platform 2D/3D/multiplayer game engine designed for everyone.项目地址: https://gitcode.com/GitHub_Trending/gd/GDevelop本文围绕 GDevelop 开源仓库 scripts/README.md 所定义的开发者脚本工具集展开深入讲解scripts/目录中各类构建辅助脚本的用途、实现细节与运行前提。读完本文你将掌握 GDevelop 仓库中一键生成全量文档提取可翻译字符串为 .pot 文件Windows/Linux 发布产物同步等开发者日常任务的具体做法并了解每个脚本背后对应的源码、配置与测试支撑。scripts/ 目录全景一个脚本对应一类开发任务GDevelop 仓库根目录下的scripts/是面向**开发者自身而非游戏用户**的工具脚本集合。与newIDE/编辑器、GDJS/游戏引擎运行时等业务模块不同这些脚本负责仓库的元工作生成文档、提取翻译、打包发布。按 scripts/README.md 的定义该目录包含以下脚本脚本平台职责ReleaseProcedure.batWindows编译源码、生成文档调用GenerateAllDocs.bat并将 GDevelop 打包为安装器和压缩包ReleaseProcedure.shLinux/Ubuntu编译并打包 GDevelop for Ubuntu参考Binaries/PackagingCopyWindowsToLinuxReleaseFiles.shLinux将Binaries/Output/Release_Windows下所有文件同步到Binaries/Output/Release_Linux在 Windows 发布产物变更后调用GenerateAllDocs.bat/GenerateAllDocs.shWindows / Linux调用 doxygen 等工具把各模块文档生成到docs/目录ExtractTranslations.bat/ExtractTranslations.shWindows / Linux生成包含待翻译字符串的source.pot文件供 Crowdin 在线翻译平台使用需要说明的是当前仓库快照的scripts/目录实际包含的文件是ExtractTranslations.bat、ExtractTranslations.sh、GenerateAllDocs.bat、GenerateAllDocs.sh和gitCloneAndBuildGD.batREADME 中提到的ReleaseProcedure.*与CopyWindowsToLinuxReleaseFiles.sh属于发布流程脚本其行为以 README 描述为准可能位于发布分支或历史版本中。scripts/还随附了 Windows 下 xgettext 所需的运行库intl.dll、libgettextlib-0-17.dll、libgettextsrc-0-17.dll、xgettext.exe说明 Windows 版翻译提取脚本不依赖系统安装 gettext 工具。运行前置依赖在使用这些脚本之前需要确认本机环境满足以下条件各脚本会以不同方式校验doxygenGenerateAllDocs系列脚本依赖全局安装的 doxygenGenerateAllDocs.sh 开头的注释明确写着 Install globally doxygen before starting it。Node.js 与 npmGDJS Runtime 文档生成和 newIDE 文档提取步骤需要执行npm install与npm run。xgettextLinux 脚本会先用type xgettext探测系统 PATH找不到时再到/usr下搜索见下文提取翻译一节Windows 版本则直接使用scripts/目录内置的xgettext.exe。gitgitCloneAndBuildGD.bat要求预装 git 与 Node.js。GenerateAllDocs一键生成四类开发者文档GenerateAllDocs.sh与GenerateAllDocs.bat功能相同、平台实现不同用于一次性生成仓库四个模块的文档Core 文档C 核心库进入Core/docs目录执行doxygen读取该目录下的 doxyfile 配置样式与页面布局由 DoxygenLayout.xml、DoxygenStyle.css 控制。GDJS 文档C 平台层进入GDJS/docs再次执行doxygen。GDJS Runtime 文档TypeScript 运行时回到GDJS/根目录执行npm install和npm run generate-doc。后者在 GDJS/package.json 中定义为typedoc --options docs/typedoc.json --plugin typedoc-plugin-reference-excluder即使用 TypeDoc 从运行时源码生成 API 文档主入口说明见 GDJS/docs/typedoc.json。Wiki 文档newIDE 扩展参考进入newIDE/app/scripts执行npm install然后依次运行node extract-extensions-document.js与node extract-reference-document.jsnewIDE/app/scripts/extract-extensions-document.js、newIDE/app/scripts/extract-reference-document.js这两个脚本会把扩展与参考文档从代码元数据中抽取成 Markdown 形式。两个脚本在日志处理上有差异.sh版本把各步骤的提示直接打印到终端.bat版本则把 doxygen 输出重定向到scripts/logs/下的日志文件如CoreDoxygenLog.txt、CoreDoxygenWarningLog.txt、GDJSDoxygenLog.txt、GDJSDoxygenWarningLog.txt并用IF NOT ERRORLEVEL 0捕获失败。如果你需要排查文档生成告警Windows 下优先查看这些日志文件。ExtractTranslations把源码字符串变成可翻译的 .pot 文件ExtractTranslations系列脚本负责把 GDCore、GDJS 与 Extensions 三部分源码中的用户可见字符串提取成 gettext 标准的.pot模板文件供翻译平台或 PoEdit 等工具使用。整个流程分为收集文件清单与调用 xgettext 提取两步。步骤一收集待翻译的源文件清单Linux 版ExtractTranslations.sh使用findgrep收集并写入临时文件/tmp/listfile.txtfind ../GDJS/GDJS/ -name *.cpp | grep -v /Dialogs/ /tmp/listfile.txt find ../GDJS/GDJS/ -name *.h -o -name *.hpp | grep -v /Dialogs/ /tmp/listfile.txt find ../Extensions/ -name *.cpp /tmp/listfile.txt find ../Extensions/ -name *.h -o -name *.hpp /tmp/listfile.txt find ../Extensions/ -name *.js | grep -v .umd.js | grep -v .min.js \ | grep -v .benchmark.js | grep -v .spec.js | grep -v box2d.js \ | grep -v /node_modules | grep -v /bondage.js \ | grep -v /ExampleJsExtension /tmp/listfile.txt find ../Core/GDCore -name *.cpp | grep -v /Dialogs/ /tmp/listfile.txt find ../Core/GDCore -name *.h -o -name *.hpp | grep -v /Dialogs/ /tmp/listfile.txtWindows 版ExtractTranslations.bat用dir /L /B /S递归列出小写路径再通过find /v /i做同样的排除清单写入%TEMP%\listfile.txt。值得注意的过滤规则及其原因这些规则约束了哪些代码不该被翻译过滤规则排除原因Dialogs/目录编辑器对话框代码字符串不面向最终用户翻译.umd.js/.min.js第三方 UMD 压缩库与压缩产物非 GDevelop 源码.benchmark.js/.spec.js基准测试与单元测试代码box2d.js第三方 Box2D 库打包文件/node_modulesnpm 依赖/bondage.jsDialogueTree 扩展内嵌的第三方对话引擎/ExampleJsExtension官方示例扩展仅用于教学步骤二调用 xgettext 生成 .pot 文件$GETTEXT --from-code utf-8 -o gdcore-gdcpp-gdjs-extensions-messages.pot \ --keywordGD_T --no-wrap -f /tmp/listfile.txt -k_关键参数说明--from-code utf-8源文件以 UTF-8 编码读取避免中文字符串出现乱码-o gdcore-gdcpp-gdjs-extensions-messages.pot输出文件名命名对应 GDCore / GD C 平台 / GDJS / Extensions 四个来源--keywordGD_T与-k_声明两个提取标记——GD_T(...)是 GDevelop 源码中标记可翻译字符串的宏_是 gettext 传统占位符。也就是说源码中任何GD_T(...)包裹的字符串都会被收录进 .pot 文件--no-wrap不在固定列宽处强制换行便于版本管理-f 文件清单从清单文件批量读取输入源。Windows 版额外传入--c选项显式声明 C 语言模式。xgettext 可用性检查方面Linux 版会先尝试 PATH 中的xgettext失败则在/usr下查找两处都找不到时打印❌ Unable to find xgettext on your system.并以非零状态退出。生成的gdcore-gdcpp-gdjs-extensions-messages.pot可直接上传至 Crowdin 项目仓库根目录的 crowdin.yml 定义了该翻译项目的路径映射与同步配置或在 PoEdit 等本地工具中打开创建各语言翻译文件。版本发布脚本ReleaseProcedure 与跨平台产物同步按照 scripts/README.md 的描述GDevelop 的版本发布流程围绕两个脚本展开ReleaseProcedure.bat在 Windows 上执行完整发布流水线——编译源码、调用GenerateAllDocs.bat生成文档最后把 GDevelop 打包为**安装器installer与归档压缩包archive**两种分发形式。ReleaseProcedure.sh在 LinuxUbuntu上编译并打包 GDevelop其打包方式参见仓库的Binaries/Packaging约定。与之配合的CopyWindowsToLinuxReleaseFiles.sh解决跨平台发布的产物同步问题由于部分二进制产物只在 Windows 流水线上生成需要把Binaries/Output/Release_Windows中的全部文件拷贝到Binaries/Output/Release_Linux保证两个平台发布目录内容一致。按 README 的说明该脚本应在每次Binaries/Output/Release_Windows内容变更后重新调用。关于Binaries/目录本身Binaries/README.md 补充说明这里存放 GDCore 与 GDJS 的 C 代码编译出的原生或 WebAssembly 二进制具体编译步骤尤其是 C 源码变更后的重编译以 GDevelop.js/README.md 为准。开发者快速上手gitCloneAndBuildGD.bat虽然scripts/README.md未提及但scripts/目录中的 gitCloneAndBuildGD.bat 是开发者本地搭建开发环境的最快入口其逻辑为若newIDE/electron-app/node_modules已存在说明依赖已安装直接跳到第 4 步启动否则从master分支克隆 GDevelop 仓库脚本中fork4ian指定了上游仓库依次对newIDE/app与newIDE/electron-app执行npm install安装依赖在newIDE/app启动npm start运行编辑器等待 60 秒后通过 Electron 启动桌面应用。该脚本与scripts/README.md中描述的工具集共同构成完整的开发者工作流用gitCloneAndBuildGD.bat快速搭建环境 → 用ExtractTranslations维护翻译 → 用GenerateAllDocs产出文档 → 用ReleaseProcedure系列完成发布。扩展脚本的合理姿势如果你要为 GDevelop 仓库扩展这些脚本可参考以下几点均为对现有实现的可验证推断新增待翻译源码目录在ExtractTranslations.sh/.bat的文件收集段追加对应的find/dir行并注意沿用现有的排除规则尤其是.min.js、node_modules、Dialogs/这三类高频噪声新增文档模块在GenerateAllDocs.sh中按现有顺序追加进入目录 → 生成 → 回到仓库根目录的三段式命令Windows 版则同时把输出重定向到scripts/logs/并保留IF NOT ERRORLEVEL 0错误检查验证翻译提取结果生成的.pot文件可先用 PoEdit 打开预览条目数再对比crowdin.yml中配置的源文件路径确认提取范围与翻译平台同步策略一致。小结scripts/目录是 GDevelop 仓库中体积最小、却贯穿开发全流程的工具集合GenerateAllDocs串联了 doxygen 与 TypeDoc 两代文档生成体系ExtractTranslations用精确的过滤规则守护翻译字符串的纯净ReleaseProcedure系列则定义了跨平台发布的产物标准。理解这些脚本等于理解了 GDevelop 项目如何自我维护的工程实践也为二次开发或复刻类似开源项目提供了可直接借鉴的构建工具链范式。【免费下载链接】GDevelop Open-source, cross-platform 2D/3D/multiplayer game engine designed for everyone.项目地址: https://gitcode.com/GitHub_Trending/gd/GDevelop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考