10.1 多平台导出与踩坑清单

10.1 多平台导出与踩坑清单

本节摘要：导出的机器部分只有两步——装与编辑器版本严格匹配的导出模板、按平台配置导出预设。真正的难度在平台规矩：桌面端的签名与兼容、移动端的权限与包体、网页端的体格与输入。本节讲透三线发布各自的清单与高频坑，并给出导出后回归测试的要点。

游戏在编辑器里跑得好好的，导出后白屏、无声、存档丢失——这是发布周最常见的三连击。原因几乎都不在"导出按钮"，而在导出这条交付线上自己的知识体系：模板、预设、平台规矩、回归测试。按节走完，发布日可以从救火日变成例行公事。

机器部分：模板与预设

导出模板是一整套预编译的引擎运行时（每平台一份），导出的本质是"把你的项目数据塞进对应平台的模板里，拼成可执行程序"。两个纪律：版本严格匹配（编辑器四点二配四点二的模板，版本错位是"导出即崩"的头号原因）；想减包体可以下精简模板（不含调试工具，发布版更小）。

导出预设描述"导成什么样"：目标平台、包含哪些资源、图标、版本信息、平台专属设置。预设本身可以进版本库，团队与自动化流水线共用同一份（第 9 章的命令行导出正是按预设名驱动）。

# 命令行按预设导出（自动化流水线的标准动作）
# 无界面模式 按预设名产出对应平台包
headless --export-release "Windows 桌面" 输出目录/深井矿工.exe
​

资源的包含规则值得单独强调：导出器默认打包被引用到的资源。动态加载的资源（按名字拼路径加载的场景、按字符串取用的贴图）不在引用图里，需要手工加进包含清单——"导出后资源丢失"九成源于此。过滤器语法（按通配符排除大文件）也是控制包体的常用手段，排除掉的目录不进包。

桌面线：看似简单，暗礁在签名

桌面三平台（视窗、苹果、林纽克斯）各有一个"上线门槛"。视窗平台的数字签名：不签名的程序会被浏览器与系统标"未知发布者"，转化率肉眼可见地掉；签名证书要花钱与走流程，独立开发者至少要知情决策。苹果平台是强制关卡：应用必须签名加公证，否则用户首次打开要进系统设置里手动放行；苹果芯片与英特尔芯片要分别出包或做通用包。林纽克斯平台的多样性：发行版众多，动态库依赖问题偶发，打包格式按渠道选（直接压缩包最省事）。

桌面线的高频坑两个：路径大小写（视窗上不区分、林纽克斯上区分，开发时的疏忽在导出后变成"找不到文件"）；用户目录（存档写对位置——第 8 章的铁律在导出后才真正验收：开发环境里项目目录可写，导出版只有用户目录可写）。

移动线：权限与包体的战场

移动端导出前要过"平台工具链"关：安卓线要装对应构建工具链并在编辑器里配好路径；苹果线要在苹果系统上操作（签名证书、描述文件一套流程）。权限最小化是第一条军规：游戏要什么权限，商店审核与用户信任都盯着——只勾真正需要的，麦克风定位通讯录之类，无正当理由一个都别碰。

包体是第二条军规。商店对首装包有大小压力，玩家对流量敏感。压缩手段按序上：贴图用压缩格式（移动端有专用格式，比桌面格式小得多但质量略降）、音频长文件流式加降采样、没有用的大文件过滤器排除。深井矿工的首包从八十兆压到二十二兆，用的就是这三板斧，画质损失在手机屏上不可辨。

⚠️ 常见坑：移动端忘记竖横屏与分辨率适配的最终检查。第 7 章的锚点布局在开发窗口里都对，真机的异形屏（刘海、挖孔、圆角）会切掉钉死角落的界面——安全区适配是移动发布的必过项。

网页线：体格与输入的双考验

网页版让"点链接即玩"成为可能，是试玩与传播的利器，代价是两条硬约束。体格：浏览器加载整个包才能开始，包体直接决定玩家等几秒；网页模板要用网页专用压缩格式（与桌面移动都不同，需在导入设置里启用），流式加载长音频。输入：浏览器环境没有文件系统（存档走浏览器本地存储方案）、全屏与剪贴板要走浏览器的许可流程、移动浏览器的触屏适配（第 7 章虚拟控件）。

另一条不可忽视的约束：跨域隔离。多线程特性需要特殊的响应头配置，静态托管默认不带——不想折腾就关多线程特性，功能回退但部署简单；要性能就把托管配置做对。这类"浏览器规矩"是网页线独有的知识，发布前读一遍官方的网页导出说明能省一整天。

商店上架的通用准备

三线之外，各平台的商店上架还有一层"产品包装"工作，提前备齐能显著缩短审核周期：图标全套（各平台各尺寸一次做齐，从一张原图导出）、截图与预览视频（按商店要求的分辨率与数量）、描述文案与关键词（搜索优化在商店同样存在）、隐私政策页面（收集任何数据都要有交代，零收集也要有页面说明）、分级问卷（按内容如实填，乱填被发现会下架）。这些事的性质与代码无关，但拖发布日期的往往就是它们——发布排期里给"包装材料"单独留一周，是经验之谈。

版本管理上还有一个建议：发布用专门的产品分支，主线继续开发；每个发布版本打标签，商店提交记录对应标签。将来"二点零版本出了个一点八就有的问题"，能精确回到当时的代码与资产状态排查——这套流程在第 9 章自动化流水线里可以做到全自动。

导出后的回归测试

导出完成后、提交商店前，跑一遍真机回归清单：存档读写（在真用户目录里真的写进读出了吗）；音频（每台真机都出声吗，静音开关响应吗）；输入（手柄、键盘、触屏各过一遍）；界面（分辨率切换、异形屏、窗口缩放）；性能（真机帧率贴住预算，第 9 章）；断链资源（动态加载的东西都在包里吗）。六项过堂，每项对应一类"开发机上看不出来"的发布期事故。

图 1 三线发布的关键差异

本节要点回顾

• 模板严格匹配版本：错位是"导出即崩"的头号原因；精简模板换小包体
• 动态资源进清单：按名字加载的不在引用图里，导出丢失九成源于此
• 桌面线：签名与公证是门槛，路径大小写与用户目录是暗礁
• 移动线：权限最小化、包体三板斧（压缩贴图、流式音频、过滤器）、安全区适配
• 网页线：专用压缩格式、浏览器输入规矩、跨域隔离决策（简单部署或多线程性能二选一）
• 六项真机回归：存档、音频、输入、界面、性能、断链——每项拦一类发布期事故

游戏交付出去了。最后一节把镜头拉到引擎生态：那里有轮子、有方向、也有你未来的位置。