3 个平台一次跑通Godot 桌面发布Windows / macOS / Linux实操指南【免费下载链接】godot-docsGodot Engine official documentation项目地址: https://gitcode.com/GitHub_Trending/go/godot-docs你收到一条玩家反馈游戏在 Windows 上弹蓝色安全警告在 Mac 上双击打不开Linux 下一句error while loading shared libraries。这三件事是 Godot 桌面发布最常见的三个现场。好消息是它们各有确定的解法Windows 靠代码签名macOS 靠签名加公证Linux 靠依赖处理。这篇文章按全局链路 → 分平台攻坚 → 自动化 → 排错速查的顺序带你把 Godot 项目发到 Windows、macOS、Linux 三个平台。动手前先把这份清单过一遍不满足任何一条后面都会卡住编辑器里装好了对应平台的导出模板项目设置的名称、版本号、图标已确认敏感项签名密码、脚本加密密钥走环境变量不写死在仓库里三个平台各有一个可运行的导出预设发布链路从编辑器到三个平台产物先见森林。整条链路只有一条主线在编辑器配好项目与导出预设 → 下载并安装导出模板 → 每个平台各导出一次得到对应产物。模板安装入口在编辑器的导出预设管理器里打开后找到下载并安装导出模板选与编辑器版本一致的模板包。装错版本是新手最常见的卡点——如果看到导出时报模板不匹配先去核对版本号。项目基础设置决定了所有平台的身份设置项位置说明应用名称 / 版本号项目设置 → Application三平台共用只维护一处图标项目设置 → Application建议准备不同尺寸含 Windows 的 ico脚本加密密钥可选导出预设的 Encryption 页签见下方说明关于脚本加密它能把场景和脚本用 AES 加密防止被直接抠走。但注意一个前提——官方预编译模板不支持你必须用同一把密钥自己从源码编译导出模板。如果只是普通发行可以先跳过这项。更多细节见仓库中的 从源码编译导出模板。Windows 发布攻坚先解决 SmartScreen 警告最容易翻车的点玩家双击后看到Windows 已保护你的电脑。如果你看到这句说明 EXE 没做代码签名。签名不是可选项——没有证书Windows SmartScreen 会拦下绝大多数 Godot 导出包。基础配置。导出产物分两个文件game.exe可执行程序本体game.pck资源包装场景、脚本、贴图等PCK 与 EXE 分离意味着改资源后重导 PCK 即可不用重新签名主程序。导出的核心参数写在项目的export_presets.cfg里关键项如下# export_presets.cfg 关键配置 [preset.0] nameWindows Desktop platformWindows Desktop runnabletrue export_pathbuild/windows/StarRunner.exe [preset.0.options] application/iconassets/icon.ico application/file_version1.2.0.0 application/product_version1.2.0 application/company_namePixel Forge Studio application/product_nameStarRunner application/file_descriptionA side-scrolling shooter进阶配置代码签名。签名工具按你所在的系统二选一在 Windows 上构建用系统自带的SignTool.exe在 macOS / Linux 上构建用osslsigncode证书、密码这类敏感值不要写进export_presets.cfg那是要进版本库的改成环境变量注入# Windows 导出相关的敏感项全部走环境变量 set GODOT_SCRIPT_ENCRYPTION_KEYyour_encryption_key set GODOT_WINDOWS_CODESIGN_IDENTITYyour_certificate set GODOT_WINDOWS_CODESIGN_PASSWORDyour_password官方教程里 Windows 导出章节也单独讲了证书获取与配置见 导出到 Windows。macOS 发布攻坚签名和公证一个都不能少最容易翻车的点玩家右键打开后看到无法打开因为来自身份不明的开发者。如果看到这句说明应用没经过签名和公证——macOS 的 Gatekeeper 对两者都要求严格。基础配置先看产物结构。导出结果不是单个文件而是一个标准的.app包YourGame.app/ ├── Contents/ │ ├── Info.plist # 应用元信息 │ ├── MacOS/ │ │ └── YourGame # 可执行文件 │ ├── Resources/ │ │ └── data.pck # 资源文件 │ └── PkgInfo进阶配置签名。三种方式按场景选方式适用场景工具要求局限Xcode codesign在 macOS 上构建Xcode 命令行工具需要开发者账号只能 macOS 执行rcodesignPyOxidizer 工具链CI / 跨平台构建rcodesign需在流水线里装好工具ad-hoc 内置签名本地测试无额外工具无法公证出不了自己电脑生产发布用前两者ad-hoc 只用来在本地验证逻辑。公证Notarization流程。签名之后还必须过公证Gatekeeper 才放行。链路是导出并签名应用把应用提交给 Apple 服务器Apple 执行安全扫描扫描通过后返回公证结果公证完成玩家机器上可正常打开权限声明Entitlements。应用需要明确声明自己要用的能力例如沙盒开关或设备访问权限!-- entitlements 示例 -- keycom.apple.security.app-sandbox/key true/ keycom.apple.security.device.usb/key true/ keycom.apple.security.device.bluetooth/key true/游戏如果要读手柄外设或蓝牙设备相应条目必须加上否则签名后功能会被系统直接禁掉。完整流程参考仓库里的 导出到 macOS。Linux 发布攻坚先跑 ldd再谈分发最容易翻车的点你的机器上能跑玩家的机器上弹出缺库报错error while loading shared libraries。原因是独立二进制依赖动态库而各发行版版本不一。依赖处理。先检查产物依赖了哪些库ldd StarRunner.x86_64输出里凡是 /lib/...这类绝对路径的库就是潜在缺库风险点。如果目标机器上出现 not found两种处置把缺的库打包进发布目录或者改用静态链接。打包脚本示例#!/bin/bash # 收集依赖库 mkdir -p libs ldd $1 | grep / | awk {print $3} | xargs -I {} cp -v {} libs/发布格式选型。四种格式各有取舍格式优点缺点适合谁独立二进制简单直接依赖库问题小范围分发、自己用AppImage无需安装文件较大跨发行版通用分发Flatpak沙盒隔离需要运行时规范化的商店分发Snap自动更新Canonical 控制Ubuntu 生态用户桌面集成。无论哪种格式都建议配一个.desktop文件让文件管理器知道这是什么程序、用什么图标、执行哪条命令[Desktop Entry] Version1.0 TypeApplication NameStarRunner CommentA game made with Godot Exec/opt/starrunner/StarRunner.x86_64 Icon/opt/starrunner/icon.png CategoriesGame;Linux 侧的纹理格式、架构选项在导出预设里都有独立开关导出前对照目标机器确认一次。统一导出配置与 CI/CD 自动化三平台都跑通后要收敛配置策略每平台一个预设身份类信息名称/版本/图标放项目设置只维护一处签名密码和加密密钥走环境变量。这样export_presets.cfg可以放心进版本库同事拉下来就能复现同样的产物。再用 GitHub Actions 把发布自动化——打 tag 触发一次构建三平台# .github/workflows 中的构建示例 name: Build and Export on: push: tags: - v* jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Setup Godot uses: firebelley/godot-actionv1 with: godot_version: 4.2 - name: Export Windows run: godot --export-release Windows Desktop game.exe - name: Export Linux run: godot --export-release Linux game.x86_64 - name: Upload artifacts uses: actions/upload-artifactv3 with: name: game-builds path: | game.exe game.x86_64自动化跑起来之后再把优化做进去按收益从大到小分三层资源层纹理选合适的压缩格式精简网格和动画数据压内存占用启动层预加载关键资源、优化初始化顺序把首帧时间压下来包体积层删掉没引用的资源、用压缩格式、大资产考虑流式加载排错速查表现场现象大概率原因处置动作Windows 蓝色安全警告未代码签名申请证书配 SignTool / osslsigncode 后重导macOS 无法打开未签名或未公证完成签名并走公证流程Linux 缺库报错动态库依赖缺失ldd定位缺哪个库打包或静态链接玩家机器卡顿、加载慢资源过大 / 未压缩压纹理格式、删冗余资源、流式加载三个常用的调试动作# 1) 调试导出保留调试信息便于玩家回传日志 godot --export-debug Windows Desktop game_debug.exe # 2) Linux 可执行文件开详细日志 ./game.x86_64 --verbose # 3) 性能分析模式 godot --profile发布 Checklist 与下一步行动发布前最后一遍核对逐项打勾三平台预设都在模板版本与编辑器一致名称、版本号、图标核对无误Windows 产物已签名玩家机器不再出 SmartScreen 警告macOS 产物已签名并完成公证Linux 产物在干净环境跑过ldd无缺库加密密钥 / 签名密码只存在于环境变量CI 流水线能一键产出三平台产物下一步建议按顺序做先跑通一个最小发布版本哪怕只有一个 Demo 场景→ 把上面的 GitHub Actions 流程建起来 → 找两三个不在你身边的真实用户实测一遍按反馈修完再发正式版。三平台发布没有银弹但每一个坑都有确定解法——照这份清单走完你的 Godot 游戏就能在 Windows、macOS 和 Linux 上稳定跑起来。【免费下载链接】godot-docsGodot Engine official documentation项目地址: https://gitcode.com/GitHub_Trending/go/godot-docs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
3 个平台一次跑通：Godot 桌面发布（Windows / macOS / Linux）实操指南
3 个平台一次跑通Godot 桌面发布Windows / macOS / Linux实操指南【免费下载链接】godot-docsGodot Engine official documentation项目地址: https://gitcode.com/GitHub_Trending/go/godot-docs你收到一条玩家反馈游戏在 Windows 上弹蓝色安全警告在 Mac 上双击打不开Linux 下一句error while loading shared libraries。这三件事是 Godot 桌面发布最常见的三个现场。好消息是它们各有确定的解法Windows 靠代码签名macOS 靠签名加公证Linux 靠依赖处理。这篇文章按全局链路 → 分平台攻坚 → 自动化 → 排错速查的顺序带你把 Godot 项目发到 Windows、macOS、Linux 三个平台。动手前先把这份清单过一遍不满足任何一条后面都会卡住编辑器里装好了对应平台的导出模板项目设置的名称、版本号、图标已确认敏感项签名密码、脚本加密密钥走环境变量不写死在仓库里三个平台各有一个可运行的导出预设发布链路从编辑器到三个平台产物先见森林。整条链路只有一条主线在编辑器配好项目与导出预设 → 下载并安装导出模板 → 每个平台各导出一次得到对应产物。模板安装入口在编辑器的导出预设管理器里打开后找到下载并安装导出模板选与编辑器版本一致的模板包。装错版本是新手最常见的卡点——如果看到导出时报模板不匹配先去核对版本号。项目基础设置决定了所有平台的身份设置项位置说明应用名称 / 版本号项目设置 → Application三平台共用只维护一处图标项目设置 → Application建议准备不同尺寸含 Windows 的 ico脚本加密密钥可选导出预设的 Encryption 页签见下方说明关于脚本加密它能把场景和脚本用 AES 加密防止被直接抠走。但注意一个前提——官方预编译模板不支持你必须用同一把密钥自己从源码编译导出模板。如果只是普通发行可以先跳过这项。更多细节见仓库中的 从源码编译导出模板。Windows 发布攻坚先解决 SmartScreen 警告最容易翻车的点玩家双击后看到Windows 已保护你的电脑。如果你看到这句说明 EXE 没做代码签名。签名不是可选项——没有证书Windows SmartScreen 会拦下绝大多数 Godot 导出包。基础配置。导出产物分两个文件game.exe可执行程序本体game.pck资源包装场景、脚本、贴图等PCK 与 EXE 分离意味着改资源后重导 PCK 即可不用重新签名主程序。导出的核心参数写在项目的export_presets.cfg里关键项如下# export_presets.cfg 关键配置 [preset.0] nameWindows Desktop platformWindows Desktop runnabletrue export_pathbuild/windows/StarRunner.exe [preset.0.options] application/iconassets/icon.ico application/file_version1.2.0.0 application/product_version1.2.0 application/company_namePixel Forge Studio application/product_nameStarRunner application/file_descriptionA side-scrolling shooter进阶配置代码签名。签名工具按你所在的系统二选一在 Windows 上构建用系统自带的SignTool.exe在 macOS / Linux 上构建用osslsigncode证书、密码这类敏感值不要写进export_presets.cfg那是要进版本库的改成环境变量注入# Windows 导出相关的敏感项全部走环境变量 set GODOT_SCRIPT_ENCRYPTION_KEYyour_encryption_key set GODOT_WINDOWS_CODESIGN_IDENTITYyour_certificate set GODOT_WINDOWS_CODESIGN_PASSWORDyour_password官方教程里 Windows 导出章节也单独讲了证书获取与配置见 导出到 Windows。macOS 发布攻坚签名和公证一个都不能少最容易翻车的点玩家右键打开后看到无法打开因为来自身份不明的开发者。如果看到这句说明应用没经过签名和公证——macOS 的 Gatekeeper 对两者都要求严格。基础配置先看产物结构。导出结果不是单个文件而是一个标准的.app包YourGame.app/ ├── Contents/ │ ├── Info.plist # 应用元信息 │ ├── MacOS/ │ │ └── YourGame # 可执行文件 │ ├── Resources/ │ │ └── data.pck # 资源文件 │ └── PkgInfo进阶配置签名。三种方式按场景选方式适用场景工具要求局限Xcode codesign在 macOS 上构建Xcode 命令行工具需要开发者账号只能 macOS 执行rcodesignPyOxidizer 工具链CI / 跨平台构建rcodesign需在流水线里装好工具ad-hoc 内置签名本地测试无额外工具无法公证出不了自己电脑生产发布用前两者ad-hoc 只用来在本地验证逻辑。公证Notarization流程。签名之后还必须过公证Gatekeeper 才放行。链路是导出并签名应用把应用提交给 Apple 服务器Apple 执行安全扫描扫描通过后返回公证结果公证完成玩家机器上可正常打开权限声明Entitlements。应用需要明确声明自己要用的能力例如沙盒开关或设备访问权限!-- entitlements 示例 -- keycom.apple.security.app-sandbox/key true/ keycom.apple.security.device.usb/key true/ keycom.apple.security.device.bluetooth/key true/游戏如果要读手柄外设或蓝牙设备相应条目必须加上否则签名后功能会被系统直接禁掉。完整流程参考仓库里的 导出到 macOS。Linux 发布攻坚先跑 ldd再谈分发最容易翻车的点你的机器上能跑玩家的机器上弹出缺库报错error while loading shared libraries。原因是独立二进制依赖动态库而各发行版版本不一。依赖处理。先检查产物依赖了哪些库ldd StarRunner.x86_64输出里凡是 /lib/...这类绝对路径的库就是潜在缺库风险点。如果目标机器上出现 not found两种处置把缺的库打包进发布目录或者改用静态链接。打包脚本示例#!/bin/bash # 收集依赖库 mkdir -p libs ldd $1 | grep / | awk {print $3} | xargs -I {} cp -v {} libs/发布格式选型。四种格式各有取舍格式优点缺点适合谁独立二进制简单直接依赖库问题小范围分发、自己用AppImage无需安装文件较大跨发行版通用分发Flatpak沙盒隔离需要运行时规范化的商店分发Snap自动更新Canonical 控制Ubuntu 生态用户桌面集成。无论哪种格式都建议配一个.desktop文件让文件管理器知道这是什么程序、用什么图标、执行哪条命令[Desktop Entry] Version1.0 TypeApplication NameStarRunner CommentA game made with Godot Exec/opt/starrunner/StarRunner.x86_64 Icon/opt/starrunner/icon.png CategoriesGame;Linux 侧的纹理格式、架构选项在导出预设里都有独立开关导出前对照目标机器确认一次。统一导出配置与 CI/CD 自动化三平台都跑通后要收敛配置策略每平台一个预设身份类信息名称/版本/图标放项目设置只维护一处签名密码和加密密钥走环境变量。这样export_presets.cfg可以放心进版本库同事拉下来就能复现同样的产物。再用 GitHub Actions 把发布自动化——打 tag 触发一次构建三平台# .github/workflows 中的构建示例 name: Build and Export on: push: tags: - v* jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Setup Godot uses: firebelley/godot-actionv1 with: godot_version: 4.2 - name: Export Windows run: godot --export-release Windows Desktop game.exe - name: Export Linux run: godot --export-release Linux game.x86_64 - name: Upload artifacts uses: actions/upload-artifactv3 with: name: game-builds path: | game.exe game.x86_64自动化跑起来之后再把优化做进去按收益从大到小分三层资源层纹理选合适的压缩格式精简网格和动画数据压内存占用启动层预加载关键资源、优化初始化顺序把首帧时间压下来包体积层删掉没引用的资源、用压缩格式、大资产考虑流式加载排错速查表现场现象大概率原因处置动作Windows 蓝色安全警告未代码签名申请证书配 SignTool / osslsigncode 后重导macOS 无法打开未签名或未公证完成签名并走公证流程Linux 缺库报错动态库依赖缺失ldd定位缺哪个库打包或静态链接玩家机器卡顿、加载慢资源过大 / 未压缩压纹理格式、删冗余资源、流式加载三个常用的调试动作# 1) 调试导出保留调试信息便于玩家回传日志 godot --export-debug Windows Desktop game_debug.exe # 2) Linux 可执行文件开详细日志 ./game.x86_64 --verbose # 3) 性能分析模式 godot --profile发布 Checklist 与下一步行动发布前最后一遍核对逐项打勾三平台预设都在模板版本与编辑器一致名称、版本号、图标核对无误Windows 产物已签名玩家机器不再出 SmartScreen 警告macOS 产物已签名并完成公证Linux 产物在干净环境跑过ldd无缺库加密密钥 / 签名密码只存在于环境变量CI 流水线能一键产出三平台产物下一步建议按顺序做先跑通一个最小发布版本哪怕只有一个 Demo 场景→ 把上面的 GitHub Actions 流程建起来 → 找两三个不在你身边的真实用户实测一遍按反馈修完再发正式版。三平台发布没有银弹但每一个坑都有确定解法——照这份清单走完你的 Godot 游戏就能在 Windows、macOS 和 Linux 上稳定跑起来。【免费下载链接】godot-docsGodot Engine official documentation项目地址: https://gitcode.com/GitHub_Trending/go/godot-docs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
