For the complete documentation index, see llms.txt. This page is also available as Markdown.

构建配置文件

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 命令完成,而是在部署后 在控制台申请审核后才会完成。详细流程见 开始使用

配置文件矩阵

任务
调试控制台
开发构建
WebGL 压缩
剥离级别
LZ4 压缩
调试符号

开发服务器

✅ 启用

✅ 启用

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 压缩。所有配置文件默认启用。

配置文件自定义

  1. AIT > Configuration 打开菜单

  2. 展开“构建配置文件”部分

  3. 展开所需的配置文件(Dev Server、Production 等)

  4. 更改各选项的复选框

  5. 更改会自动保存

配置文件设置位于 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_BUILDAIT_IL2CPP_CONFIGURATION两者都能缩短链接时间,但属于不同层级。前者是 Player 选项,后者是 IL2CPP 编译器优化器级别,因此若要在 CI 中减少构建时间,同时指定这两个设置效果更明显。

SDK 读取的环境变量不止这四个。打包阶段的 AIT_DISABLE_INSTALL_SKIP构建流水线中,以及 Sentry 相关变量 Sentry 集成

构建日志

构建开始时应用的配置文件会输出到 Unity Console。哪些值实际生效,这份日志是最终确认依据——环境变量覆盖也会反映在这里。

压缩格式会按配置文件中保存的值原样(-1如果是 自动)会打印,而 Stripping Level 在 -1为时,会在括号中同时显示实际应用的值。

相关文档

这有帮助吗?