构建配置文件
AIT 说明菜单的各个构建入口点会自动切换哪些设置,以及如何修改这些值。
任务菜单
AIT > Dev Server > Start Server
运行本地开发服务器(devtools Mock SDK + 面板进行浏览器测试)
AIT > Build & Package
生成发布用包
AIT > Deploy (Test)
增量构建后测试部署(ait deploy) — 通过 QR/URL 在真机上确认
AIT > Deploy (Production)
清理构建后测试部署(ait deploy) — 部署后在控制台申请审核/发布
ait deploy在两个菜单中都 始终会部署到控制台 QR 测试环境(intoss-private://)。面向真实用户的发布不是通过这个 CLI 命令完成,而是在部署后 在控制台申请审核后才会完成。详细流程见 开始使用。
配置文件矩阵
开发服务器
✅ 启用
✅ 启用
Disabled
Minimal
✅ 启用
Embedded
构建并打包
❌ 禁用
❌ 禁用
自动(Brotli)
自动(High)
✅ 启用
External
Deploy (Test)
❌ 禁用
❌ 禁用
自动(Brotli)
自动(High)
✅ 启用
External
Deploy (Production)
❌ 禁用
❌ 禁用
自动(Brotli)
自动(High)
✅ 启用
External
Deploy (Test) 和 Deploy (Production) 使用同一个生产配置文件,因此上面的设置值相同。两者的差异在于本表未列出的 构建范围(增量 vs 清理)以及 部署 memo 前缀(-m "[Test] …" / -m "[Production] …")。——控制台会用这个前缀区分两个部署。
Mock 桥接不是构建配置文件项。devtools(@apps-in-toss/devtools)请参见单独章节。
各设置的含义
devtools
仅适用于 Dev Server, 不是构建配置文件, AIT > Configuration的单独设置。启用后,可以在浏览器中不使用 Toss App,通过 devtools 的 Mock SDK 运行游戏,屏幕上会显示用于状态操作的面板。与构建配置文件不同,它不会修改构建产物,因此在更改设置后 只需重启服务器即可生效即可生效。返回值和限制见 API 使用模式的 devtools 章节中整理。
开发构建
这是 Unity 的 Development Build 选项。
启用
提升构建速度,便于调试(可连接 Profiler)
禁用
优化后的发布构建
调试符号
决定调试符号(源码映射)放在哪里。适用于 Unity 2022.3 及以上。
Embedded
将符号包含在构建文件中(文件体积增加,便于调试)
External
拆分为单独文件(文件体积减小,适合发布)
调试控制台
在屏幕左下角显示调试按钮。点击即可查看日志和 SDK 事件。可在此查看。生产部署时请禁用。
WebGL 压缩
这是最终产物的压缩格式。
自动
使用 Brotli(默认)
Disabled
不压缩(优先构建速度)
Gzip
Gzip 压缩
Brotli
Brotli 压缩(最高压缩率)
只有 Dev Server 为了构建速度设为 Disabled,其余配置文件均为自动(Brotli)。
剥离级别
表示移除未使用的托管代码的程度。
自动
使用 High(默认)
Minimal
仅移除最少量代码
Low
低级别代码移除
Medium
中级别代码移除
High
积极移除代码(最小构建体积)
只有 Dev Server 为了构建速度设为 Minimal,其余均为自动(High)。
参考: 由于 WebGL(IL2CPP)不支持 Disabled,因此已从选项中排除;旧版本中保存为 Disabled 的值会规范化为 Minimal。仅通过反射引用的类型可能会在 High 中被移除,因此如果剥离后行为发生变化,请
link.xml将其指定为保留对象。
LZ4 压缩
这是 Unity 构建流程中的 LZ4 压缩。所有配置文件默认启用。
配置文件自定义
AIT > Configuration打开菜单展开“构建配置文件”部分
展开所需的配置文件(Dev Server、Production 等)
更改各选项的复选框
更改会自动保存
配置文件设置位于 Assets/AppsInToss/Editor/AITConfig.asset中。
环境变量覆盖
在 CI/CD 或自动化脚本中,可以无需修改代码即可覆盖配置文件值。大多数情况下, AITBuildInitializer.ApplyEnvironmentVariableOverrides(profile)会应用到配置文件副本, AIT_IL2CPP_CONFIGURATION仅 初始化 阶段会直接应用到 PlayerSettings。
AIT_DEBUG_CONSOLE
启用调试控制台
true / false
AIT_COMPRESSION_FORMAT
压缩格式
-1 (自动) / 0 (Disabled) / 1 (Gzip) / 2 (Brotli)
AIT_DEVELOPMENT_BUILD
开发构建
true / false
AIT_IL2CPP_CONFIGURATION
IL2CPP 编译器优化级别
Debug / Release / Master
若超出允许值 Debug.LogWarning则通过 Debug.LogWarning 发出警告,并仅忽略该变量——构建会继续。
AIT_DEVELOPMENT_BUILD和 AIT_IL2CPP_CONFIGURATION两者都能缩短链接时间,但属于不同层级。前者是 Player 选项,后者是 IL2CPP 编译器优化器级别,因此若要在 CI 中减少构建时间,同时指定这两个设置效果更明显。
构建日志
构建开始时应用的配置文件会输出到 Unity Console。哪些值实际生效,这份日志是最终确认依据——环境变量覆盖也会反映在这里。
压缩格式会按配置文件中保存的值原样(-1如果是 自动)会打印,而 Stripping Level 在 -1为时,会在括号中同时显示实际应用的值。
相关文档
这有帮助吗?