Unity命令行打包如何实现？

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）或在一个方法中切换平台后执行打包。