游戏引擎 / 系统课时
准备移动端和小游戏构建
准备移动端和小游戏构建
浏览器预览通过后,移动端与小游戏仍需要各自的构建配置、平台工具和真机验证。本节整理构建入口与适配条件,用运行探针确认包确实运行在目标环境,而不是只在桌面模拟成功。
学习目标
- 为目标平台准备场景与标识配置
- 检查画面适配和前后台行为
- 区分构建完成、真机运行与发布
为每种平台建立配置记录
在项目构建面板选择目标平台,确认 Menu 和 Game 已加入、初始场景为 Menu,再记录 Creator 3.8.8、项目提交版本与构建时间。Android 原生构建需要匹配的原生开发环境、包名与签名;iOS 构建与签名需对应 Apple 开发环境;微信小游戏则需要真实项目 AppID 与开发者工具。不要在教程示例中伪造可用于发布的身份或证书。
| 检查项 | 移动原生 | 小游戏 |
|---|---|---|
| 项目标识 | 包名或 Bundle ID | 平台 AppID |
| 运行验证 | 安装包与真机日志 | 开发者工具与真机预览 |
| 资源策略 | 包体与必要远程资源 | 首包、分包及平台资源规则 |
| 平台能力 | 原生权限与 SDK | 平台 API、基础库和权限 |
平台工具与要求会更新,实际安装版本和发布限制应以当次官方文档为准。Android 发布流程 与微信小游戏发布流程 用于核对 3.8 的构建接线。
在目标包中打印运行环境
保存 PlatformProbe.ts,挂到启动场景的空节点。构建后在目标运行日志中查找 probe 标识;visible 是引擎可见设计坐标范围,不是设备物理像素,不能据此直接估算纹理内存。
import { _decorator, Component, sys, view, game, Game } from 'cc';
const { ccclass } = _decorator;
@ccclass('PlatformProbe')
export class PlatformProbe extends Component {
onEnable(): void { game.on(Game.EVENT_HIDE, this.hidden, this); }
onDisable(): void { game.off(Game.EVENT_HIDE, this.hidden, this); }
start(): void {
const visible = view.getVisibleSize();
console.log('platform-probe', {
platform: sys.platform,
mobile: sys.isMobile,
visible: visible.width + 'x' + visible.height,
});
}
private hidden(): void { console.log('platform-probe:hidden'); }
}预期结果:启动日志包含 platform-probe、平台值与可见范围;切入后台时,在支持的目标环境出现 platform-probe:hidden。具体平台枚举和尺寸随目标变化,不要求所有移动或小游戏环境报告完全相同的值。
验证适配与资源路径
根据设计分辨率和 Canvas 适配策略检查宽屏、窄屏、横竖屏与安全区域。关键按钮不能落到刘海、系统手势区或屏幕外;不能只修改全局缩放让文字看似装下,却缩到无法点击。触摸控制应覆盖多指、取消和恢复前台后清空输入。
在目标包执行 Menu→Game、动态 Prefab 与图片加载、暂停恢复、结算重开和断网恢复路径。浏览器全局对象、桌面键盘和本地文件路径不一定在目标平台存在。远程资源与网络请求要使用平台允许的域名和协议,并验证真实失败反馈。
构建成功只表示产物生成;安装、启动、真机功能与平台审核是后续独立步骤。保存每个平台的构建配置和验证记录,确认本次测试对应同一份产物,再进入发布前检查。