UniCli 入门:从安装到首次自动化
了解 UniCli 的安装配置,并通过终端调用 Unity 执行项目编译、测试及编辑器命令,建立可复用的命令行工作流。
- 1
准备 Unity 环境
安装 Unity Hub 与目标编辑器版本,并确认 Unity 可正常打开项目。终端需能调用 Unity 可执行文件,后续命令中的路径应按实际安装位置修改。
- 2
获取并安装 UniCli
打开 UniCli 的 GitHub 仓库,阅读 README 中的安装说明,将仓库克隆到本地,再按照文档要求完成构建或安装,并确认命令已加入 PATH。
- 3
进入 Unity 项目
在终端切换到包含 Assets、ProjectSettings 等目录的 Unity 项目根目录。先执行 UniCli 的帮助或版本命令,确认参数格式与当前环境无误。
- 4
触发项目编译
使用 UniCli 调用指定 Unity 编辑器并执行项目编译命令,检查输出日志及编辑器返回结果。首次执行可能较慢,应等待导入与编译结束。
- 5
运行自动化测试
在项目目录运行测试命令,必要时指定测试平台、过滤条件或报告输出位置。执行后查看终端结果与生成的测试报告,确认用例通过情况。
- 6
执行编辑器命令
根据 README 提供的方法,让 UniCli 调用编辑器内预置的命令或扩展入口。完成后检查场景、资源或项目设置是否按预期发生变化。
💡 实用技巧
- 使用绝对路径调用 Unity,避免版本冲突
- 先运行帮助命令确认参数名称
- 为编译与测试分别保存日志
- 将常用命令写成脚本复用
⚠️ 常见坑
- Unity 路径或版本填写错误
- 项目尚未导入完成便执行命令
常见问题
Q:UniCli 安装后终端提示找不到命令怎么办?
先按仓库 README 完成构建或安装,再确认 UniCli 的可执行文件目录已加入系统 PATH。重新打开终端后运行 UniCli 帮助或版本命令;若仍无法识别,检查 PATH 配置及当前终端环境是否生效。
Q:如何确认终端调用的是正确的 Unity 版本?
在 Unity 项目根目录运行 UniCli 的帮助或版本命令,并核对输出中的 Unity 路径和版本。若机器安装了多个编辑器,调用时填写目标 Unity 可执行文件的绝对路径,避免版本冲突。
Q:编译和测试命令应该从哪里执行?
先切换到包含 Assets、ProjectSettings 等目录的项目根目录,再运行 UniCli 的编译或测试命令。首次执行需等待资源导入和编译结束;测试后可按需指定平台、过滤条件及报告输出位置。