
文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载导读EditorExportPlatformLinuxBSD是 Godot Engine 中负责 Linux 与 BSD 桌面平台项目导出的核心类它把项目文件打包为data.pck资源包并与精简优化过的运行时二进制捆绑产出去除编辑器与调试器的可执行程序。本文以该类的官方类参考文档为主线系统拆解其全部 14 个导出属性架构选择、PCK 内嵌、自定义模板、控制台包装器、着色器预编译、SSH 远程部署、纹理格式等并结合仓库中的导出教程与一键部署指南帮助你完整掌握 Linux/BSD 平台导出的配置方法与底层原理。类继承结构与定位EditorExportPlatformLinuxBSD的继承链为EditorExportPlatformLinuxBSD └── EditorExportPlatformPC └── EditorExportPlatform └── RefCounted └── Object从类参考文档可见其直接父类是EditorExportPlatformPCPC 桌面平台导出器的基类同时涵盖 Windows 与 Linux/BSD但不包括 macOS再向上继承自通用的EditorExportPlatform导出平台抽象基类以及RefCounted、Object。该类的职责一句话概括Exporter for Linux/BSD即 Linux 与 BSD 系操作系统的专用导出器。它继承了 PC 平台导出器共有的能力如可执行文件架构、PCK 嵌入、自定义模板、控制台包装器、纹理格式并扩展出 Linux/BSD 平台特有的 SSH 远程部署功能。官方文档还给出了配套教程链接Exporting for Linux这是理解本类各属性实际用途的首选参考。导出流程从项目文件到 data.pck理解各属性前先明确 Linux 导出的整体工作流依据 exporting_for_linux.rst导出器收集项目全部资源文件打包成一个data.pck文件该文件与一个专门优化过的二进制不含编辑器与调试器、体积更小、运行更快捆绑用户只需分发该可执行文件或打包成压缩包即可在目标 Linux/BSD 机器上运行。data.pck默认作为独立文件与可执行文件并列分发若希望单文件分发则启用下文binary_format/embed_pck属性将资源嵌入可执行文件内部。属性总览EditorExportPlatformLinuxBSD共暴露 14 个导出属性按功能可分为五组分组属性类型默认用途二进制格式binary_format/architectureString可执行文件目标架构二进制格式binary_format/embed_pckbool是否将资源嵌入可执行文件自定义模板custom_template/debugStringDebug 自定义导出模板路径自定义模板custom_template/releaseStringRelease 自定义导出模板路径调试辅助debug/export_console_wrapperint是否同时导出控制台包装器着色器shader_baker/enabledbool是否预编译并嵌入着色器远程部署ssh_remote_deploy/enabledbool启用 SSH/SCP 远程部署远程部署ssh_remote_deploy/hostString远程主机useraddress远程部署ssh_remote_deploy/portString远程主机 SSH 端口远程部署ssh_remote_deploy/extra_args_sshString附加 SSH 命令行参数远程部署ssh_remote_deploy/extra_args_scpString附加 SCP 命令行参数远程部署ssh_remote_deploy/run_scriptString应用运行前在远程执行的脚本远程部署ssh_remote_deploy/cleanup_scriptString应用结束后在远程执行的脚本纹理格式texture_format/etc2_astcbool纹理导出为 ETC2/ASTC纹理格式texture_format/s3tc_bptcbool纹理导出为 S3TC/BPTC二进制格式架构选择与 PCK 嵌入binary_format/architecture选择目标 CPU 架构该属性指定导出可执行文件的目标处理器架构。官方支持以下 7 种取值x86_32— 32 位 x86仅建议用于老旧 32 位发行版与处理器x86_64— 64 位 x86默认值当前 PC 处理器Intel/AMD最通用的架构arm64— 64 位 ARM如 Raspberry Pi 3 及更新版本Pi 5 等适合作为 itch.io 等多平台发布站的备选可执行文件arm32— 32 位 ARM对应 Raspberry Pi 1/2 等老设备如今已不常见不建议默认导出rv64— RISC-V 处理器ppc64— 64 位 PowerPC 处理器loongarch64— 64 位 LoongArch 处理器。重要限制官方提供的导出模板仅包含x86_32、x86_64、arm32、arm64四种二进制的预编译版本rv64、ppc64、loongarch64属于更小众的架构Godot 官方不提供现成模板需要自行编译引擎与模板参见 exporting_for_linux.rst 中指向编译指南的说明。因此若需导出 RISC-V 等架构务必先自行准备对应模板再配置本属性。另需留意Fedora 等主流发行版已讨论移除 32 位库x86_32产物可能无法在未来版本上运行仅在确有老设备兼容需求时使用。binary_format/embed_pck单文件分发当binary_format/embed_pck为true时项目资源PCK 数据会被直接嵌入可执行文件内部得到单一的自包含可执行文件无需再携带data.pck文件便于直接复制分发。默认关闭时data.pck与可执行文件分开发布。自定义导出模板custom_template/debugDebug 构建使用的自定义导出模板路径custom_template/releaseRelease 构建使用的自定义导出模板路径。两者均为String类型指向磁盘上的模板文件。留空时使用默认官方模板。当需要针对特定架构如 rv64或对引擎做定制构建时通常在这里指定自编译模板。调试辅助控制台包装器debug/export_console_wrapperint类型按布尔语义使用当为true时除主可执行文件外还会导出一个控制台包装器console wrapper用于在运行项目时开启控制台输出。这对调试阶段查看引擎日志、脚本错误输出非常有用正式发布时通常关闭避免弹窗控制台窗口影响体验。着色器预编译shader_bakershader_baker/enabledbool当为true时导出过程中会将着色器编译并嵌入到应用中即提前进行管线编译避免运行时首帧卡顿。使用前提与限制据类参考文档原文仅在使用Forward或Mobile渲染器时支持导出为专用服务器dedicated server时由于不执行任何渲染着色器烘焙始终被禁用。关于着色器预编译Shader Precompilation / Shader Baking的背景与排查可参考 pipeline_compilations.rst 中的shader_baker小节。SSH 远程部署一键部署到远程主机SSH 远程部署Remote Deploy是 Linux/BSD 导出器的特色功能允许通过 SSH/SCP 将项目导出并直接运行到远程计算机上。这与编辑器的一键部署one-click deploy机制直接相关在一键部署指南中明确说明桌面平台含 Linux通过 SSH 将带调试功能启用的项目导出并运行到远程计算机前提是启用SSH Remote Deploy并在项目导出设置中配置连接信息且存在标记为Runnable的导出预设。连接配置ssh_remote_deploy/enabledbool总开关启用 SSH/SCP 远程部署ssh_remote_deploy/hostString远程主机 SSH 用户名与地址格式为useraddressssh_remote_deploy/portString远程主机 SSH 端口号注意类型为 String配置时按字符串填写ssh_remote_deploy/extra_args_sshString传递给 SSH 的额外命令行参数数组ssh_remote_deploy/extra_args_scpString传递给 SCP 的额外命令行参数数组。典型场景下extra_args_ssh/extra_args_scp可用于指定非默认密钥、代理跳板、SSH 选项等自定义连接参数例如-i /path/to/key、-o StrictHostKeyCheckingno等。自定义远程脚本ssh_remote_deploy/run_script与ssh_remote_deploy/cleanup_script用于在远程主机上执行自定义脚本代码前者在应用运行时执行后者在应用结束后执行用于清理现场。两类脚本中均可使用以下占位变量变量含义{temp_dir}远程端临时文件夹路径用于上传应用与脚本{archive_name}包含上传应用 ZIP 包的名称{exe_name}应用可执行文件的名称{cmd_args}传给应用的命令行参数数组典型用法run_script中组合{temp_dir}、{archive_name}、{exe_name}解压并启动应用cleanup_script中删除{temp_dir}下的临时文件完成清理。纹理格式ETC2/ASTC 与 S3TC/BPTCLinux 平台桌面 GPU 生态较杂纹理导出格式影响兼容性与体积texture_format/etc2_astcbool为true时项目纹理以ETC2/ASTC格式导出texture_format/s3tc_bptcbool为true时项目纹理以S3TC/BPTC格式导出。实际导出的最终纹理格式由这两项与引擎纹理导入设置共同决定可参考 feature_tags.rst 中与渲染/纹理相关的特性标签机制。在配置导出预设时应根据目标机器的 GPU 驱动能力选择合适的一项或组合。环境变量覆盖导出选项除编辑器内配置外Linux 导出还支持通过环境变量在编辑器之外覆盖导出选项导出过程中其值优先于导出菜单中的设置导出选项环境变量Encryption / Encryption KeyGODOT_SCRIPT_ENCRYPTION_KEY该机制在 exporting_for_linux.rst 中有明确记载适用于 CI/CD 流水线中在无编辑器交互的情况下注入脚本加密密钥。导出前自查清单综合类参考与导出教程配置一个可用的 Linux/BSD 导出预设时建议依次核对模板已安装对应版本的官方导出模板或在custom_template/debug/custom_template/release中指定自编译模板导出rv64/ppc64/loongarch64时必须自备架构binary_format/architecture与目标设备 CPU 匹配默认x86_64资源形态按分发需求决定是否开启binary_format/embed_pck单文件模式纹理兼容按目标 GPU 启用 ETC2/ASTC 与 S3TC/BPTC 的合理组合调试/发布差异调试预设可开启debug/export_console_wrapper发布预设确认着色器烘焙与渲染器匹配Forward/Mobile且专用服务器导出会自动禁用着色器烘焙远程部署如需一键部署到远程 Linux 机器开启ssh_remote_deploy/enabled填写hostuseraddress、port并按需编写run_script/cleanup_script。总结EditorExportPlatformLinuxBSD是 Godot Linux/BSD 桌面导出的总控台它既继承 PC 平台导出器的通用能力架构选择、PCK 嵌入、自定义模板、控制台包装器、纹理格式又自带面向 Linux/BSD 生态的 SSH 远程部署脚本体系。通过类参考中这 14 个属性与 exporting_for_linux.rst、one-click_deploy.rst 等教程配合使用开发者可以完成从单文件分发、异构架构适配到远程设备调试的完整 Linux 发布工作流。赞分享文档教程游戏开发【免费下载链接】godot-docsGodot Engine official documentation项目地址https://gitcode.com/GitHub_Trending/go/godot-docs点击查看免费下载相关推荐Godot 引擎 Android 导出平台配置全解析EditorExportPlatformAndroid 属性参考与实战指南Godot 引擎 Android 导出平台配置全解析EditorExportPlatformAndroid 属性参考与实战指南 本文以 Godot 官方文档类文档教程游戏开发Godot打包与发布多平台导出配置指南Godot打包与发布多平台导出配置指南 还在为游戏发布到不同平台而头疼吗Godot Engine的强大导出系统让你一次配置多平台部署本文将深入解析God文档教程游戏开发Godot 导出平台基类 EditorExportPlatform 完全指南架构、方法体系与实战导出流程Godot 导出平台基类 EditorExportPlatform 完全指南架构、方法体系与实战导出流程 EditorExportPlatform 是 God文档教程游戏开发上一篇如何用SPT-AKI存档编辑器彻底掌控你的塔科夫离线体验下一篇Simple Video Download Helper专业高效的浏览器视频下载扩展终极指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考