Unity命令行打包是自动化构建流程的重要手段，尤其在持续集成（CI/CD）、批量构建或需要远程触发打包场景中具有广泛应用，通过命令行打包，开发者可以跳过Unity编辑器的图形界面操作，直接通过脚本或指令控制打包过程,提高构建效率并减少人为错误。
（图片来源网络，侵删）
Unity命令行打包基础流程
Unity命令行打包的核心是通过-executeMethod参数指定一个C#方法，该方法在Unity编辑器启动后自动执行，完成资源加载、场景设置、平台配置等操作后调用BuildPipeline.BuildPlayer方法执行打包,具体步骤如下：
-
准备项目与脚本
在Unity项目中创建一个Editor脚本（位于Editor文件夹下），例如AutoBuilder.cs，编写打包逻辑，脚本需包含一个静态方法，方法名可自定义（如PerformBuild），并在该方法中定义打包参数，如目标平台、输出路径、场景列表等。 -
命令行参数配置
通过Unity的命令行工具（Unity.exe或Unity.app）启动项目，并传入关键参数：-projectPath：指定Unity项目的路径。-executeMethod：指定要执行的静态方法（格式：命名空间.类名.方法名）。-batchmode：以无头模式运行，不显示编辑器界面，适合自动化脚本。-quit：打包完成后自动退出Unity进程。- 其他平台特定参数（如
-buildTarget指定目标平台，如iOS、Android等）。
-
执行打包命令
以Windows为例，命令行格式为：
（图片来源网络，侵删）"C:\Program Files\Unity\Hub\Editor\2021.3.1f1\Editor\Unity.exe" -projectPath "D:\MyUnityProject" -executeMethod MyAutoBuilder.PerformBuild -batchmode -quit -buildTarget Android
macOS/Linux环境下需替换Unity可执行文件路径,并调整路径分隔符。
高级配置与注意事项
- 多场景打包：在脚本中通过
BuildSettings.scenes数组添加需要打包的场景，或直接传入场景路径列表。 - 依赖处理：确保脚本中引用了必要的命名空间（如
UnityEditor.Build），并处理平台特有的依赖（如Android的NDK配置、iOS的签名证书）。 - 错误处理：在脚本中添加异常捕获，通过
Debug.LogError输出错误信息，便于命令行排查问题。 - 日志记录：使用
File.AppendAllText将构建日志写入文件,避免命令行窗口输出限制。
常见问题与解决方案
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 打包失败，提示“未找到方法” | 方法名拼写错误、脚本未保存或未编译 | 检查方法名与-executeMethod参数是否一致，确保脚本已保存并重新编译 |
| Android打包时提示“keystore未配置” | 未在脚本中指定签名密钥或密钥路径 | 在脚本中通过PlayerSettings.Android.keystoreName和PlayerSettings.Android.keystorePass等参数配置 |
相关问答FAQs
Q1: 如何在命令行打包时动态切换Build Settings中的场景？
A: 可在脚本中通过EditorBuildSettings.scenes动态修改场景列表。
string[] scenesToBuild = new string[] { "Assets/Scene1.unity", "Assets/Scene2.unity" };
List<EditorBuildSettingsScene> sceneList = new List<EditorBuildSettingsScene>();
foreach (var scene in scenesToBuild) {
sceneList.Add(new EditorBuildSettingsScene(scene, true));
}
EditorBuildSettings.scenes = sceneList.ToArray();
BuildPipeline.BuildPlayer(...);
Q2: 命令行打包如何支持多平台配置（如同时打包Android和iOS）？
A: 可通过编写多个方法或循环调用不同平台的构建逻辑。
public static void PerformBuild() {
BuildForAndroid();
BuildForiOS();
}
private static void BuildForAndroid() {
BuildPipeline.BuildPlayer(..., BuildTarget.Android);
}
private static void BuildForiOS() {
BuildPipeline.BuildPlayer(..., BuildTarget.iOS);
}
然后通过多次调用Unity命令行（分别指定-buildTarget）或在一个方法中切换平台后执行打包。
（图片来源网络，侵删）
