Unity引擎命令行代码逻辑实现

这个问题可以分为两个层面来解答：

1. Unity Editor主程序（C++）如何解析和处理命令行参数
2. Unity C#层（如EditorApplication、BuildPipeline等）如何响应和实现命令行功能

由于Unity的C++底层代码不开源，我们只能通过Unity官方开源的C#部分（UnityCsReference）和官方文档、社区逆向分析来推测整体流程。下面我会结合伪代码和真实C#源码，详细梳理Unity命令行的代码逻辑实现。

---

1. C++主程序参数解析（原理推测）

• Unity Editor启动时，操作系统会将命令行参数（argv）传递给主程序。
• C++主程序会有一个参数解析器，识别如-batchmode、-projectPath、-executeMethod等参数。
• 这些参数会设置全局标志，影响后续的初始化流程（如是否加载UI、是否进入无头模式、项目路径等）。
• 解析到-executeMethod等参数时，会将其传递到C#层。

伪代码示例：

int main(int argc, char* argv[]) {
    for (int i = 1; i < argc; ++i) {
        if (strcmp(argv[i], "-batchmode") == 0) {
            g_BatchMode = true;
        } else if (strcmp(argv[i], "-projectPath") == 0 && i+1 < argc) {
            g_ProjectPath = argv[++i];
        } else if (strcmp(argv[i], "-executeMethod") == 0 && i+1 < argc) {
            g_ExecuteMethod = argv[++i];
        }
        // ... 其他参数
    }
    // 初始化Mono/IL2CPP虚拟机，传递参数到C#层
    StartMonoRuntime(g_BatchMode, g_ProjectPath, g_ExecuteMethod, ...);
}

---

2. C#层命令行参数访问与处理

2.1 参数访问

C#层通过Environment.GetCommandLineArgs()或Application.commandLineArgs访问参数。

示例：

string[] args = Environment.GetCommandLineArgs();
foreach (var arg in args) {
    // 解析参数
}

2.2 -executeMethod的实现

Unity在C#层会检测是否有-executeMethod参数，并通过反射调用指定的静态方法。

核心代码（UnityCsReference/EditorApplication.cs）简化版：

internal static void CheckExecuteMethod()
{
    string methodName = GetCommandLineArg("-executeMethod");
    if (!string.IsNullOrEmpty(methodName))
    {
        // 解析命名空间、类名、方法名
        var method = FindStaticMethod(methodName);
        if (method != null)
        {
            try
            {
                method.Invoke(null, null);
            }
            catch (Exception ex)
            {
                Debug.LogError("ExecuteMethod Exception: " + ex);
                EditorApplication.Exit(1); // 非零退出码
            }
        }
        else
        {
            Debug.LogError("Method not found: " + methodName);
            EditorApplication.Exit(1);
        }
    }
}

说明：

• FindStaticMethod会遍历所有已加载的程序集，查找public static方法。
• 方法执行完毕后，如果有-quit参数，会自动调用EditorApplication.Exit(0)退出编辑器。

2.3 构建流程（BuildPipeline）

如果你在-executeMethod中调用了构建方法（如BuildPipeline.BuildPlayer），其内部会自动完成资源打包、脚本编译、平台适配等流程。

示例：

public static void BuildMyGame()
{
    string[] scenes = { "Assets/Scenes/Main.unity" };
    BuildPipeline.BuildPlayer(scenes, "Builds/Windows/MyGame.exe", BuildTarget.StandaloneWindows64, BuildOptions.None);
}

---

3. 日志与退出码

• 日志通过-logFile参数指定输出文件，内部调用Debug.Log、Debug.LogError等API。
• 退出码通过EditorApplication.Exit(int code)设置，CI/CD系统会读取进程的返回值判断成功/失败。

---

4. 资源与脚本编译

• 命令行模式下，Unity会自动编译所有C#脚本（与正常启动一致）。
• 如果有编译错误，-executeMethod不会被执行，Unity会在日志中报错并退出。

---

5. 相关源码线索

• EditorApplication.cs (UnityCsReference)
• BuildPipeline.cs (UnityCsReference)
• Application.cs (UnityCsReference)

---

6. 总结流程图

操作系统启动Unity进程
        │
        ▼
C++主程序解析命令行参数
        │
        ▼
初始化Mono/IL2CPP虚拟机
        │
        ▼
C#层访问参数，查找-executeMethod
        │
        ▼
通过反射调用指定静态方法
        │
        ▼
执行构建/测试/自定义逻辑
        │
        ▼
输出日志，设置退出码，退出进程

---

下面我将更细致地剖析Unity命令行代码逻辑实现，包括：

1. 命令行参数在C#层的具体获取与解析代码
2. -executeMethod参数的完整反射调用流程
3. 如何自定义命令行参数并在脚本中读取
4. 命令行自动化构建的完整代码示例
5. 命令行执行时的生命周期与注意事项
6. 进阶：如何扩展命令行自动化能力

---

1. 命令行参数在C#层的获取与解析

Unity C#层可以通过如下方式获取命令行参数：

// 获取所有命令行参数
string[] args = System.Environment.GetCommandLineArgs();

// 解析参数
for (int i = 0; i < args.Length; i++)
{
    if (args[i] == "-myCustomArg" && i + 1 < args.Length)
    {
        string value = args[i + 1];
        Debug.Log("自定义参数值: " + value);
    }
}

注意：

• args[0]通常是可执行文件路径，实际参数从args[1]开始。
• Unity还提供Application.commandLineArgs，效果类似。

---

2. -executeMethod参数的完整反射调用流程

Unity Editor启动后，会在C#层查找-executeMethod参数，并通过反射调用指定方法。
源码简化流程如下：

// 伪代码，实际在EditorApplication.cs等文件中
void CheckAndInvokeExecuteMethod()
{
    string[] args = Environment.GetCommandLineArgs();
    string methodName = null;
    for (int i = 0; i < args.Length; i++)
    {
        if (args[i] == "-executeMethod" && i + 1 < args.Length)
        {
            methodName = args[i + 1];
            break;
        }
    }
    if (!string.IsNullOrEmpty(methodName))
    {
        // 解析命名空间、类名、方法名
        var lastDot = methodName.LastIndexOf('.');
        if (lastDot < 0) throw new Exception("方法名必须包含类名");
        string className = methodName.Substring(0, lastDot);
        string funcName = methodName.Substring(lastDot + 1);

        // 遍历所有程序集
        foreach (var assembly in AppDomain.CurrentDomain.GetAssemblies())
        {
            var type = assembly.GetType(className);
            if (type != null)
            {
                var method = type.GetMethod(funcName, BindingFlags.Static | BindingFlags.Public | BindingFlags.NonPublic);
                if (method != null)
                {
                    method.Invoke(null, null);
                    return;
                }
            }
        }
        throw new Exception("未找到方法: " + methodName);
    }
}

要点：

• 只能调用public static或internal static方法，且无参数（如需参数可用环境变量或静态字段传递）。
• 方法执行异常会导致Unity以非零码退出。

---

3. 如何自定义命令行参数并在脚本中读取

你可以在命令行中添加自定义参数，例如：

Unity.exe -batchmode -projectPath D:/MyProj -executeMethod MyBuildScript.Build -myArg 123

在C#脚本中读取：

public static void Build()
{
    string[] args = Environment.GetCommandLineArgs();
    for (int i = 0; i < args.Length; i++)
    {
        if (args[i] == "-myArg" && i + 1 < args.Length)
        {
            string value = args[i + 1];
            Debug.Log("命令行自定义参数: " + value);
        }
    }
    // ... 继续构建逻辑
}

---

4. 命令行自动化构建的完整代码示例

命令行调用：

Unity.exe -batchmode -projectPath D:/MyProj -executeMethod MyBuildScript.Build -buildTarget Android -outputPath D:/Builds/MyApp.apk -quit -logFile D:/build.log

C#脚本：

using UnityEditor;
using UnityEngine;

public class MyBuildScript
{
    public static void Build()
    {
        string buildTarget = "StandaloneWindows64";
        string outputPath = "Builds/MyGame.exe";
        string[] args = System.Environment.GetCommandLineArgs();

        for (int i = 0; i < args.Length; i++)
        {
            if (args[i] == "-buildTarget" && i + 1 < args.Length)
                buildTarget = args[i + 1];
            if (args[i] == "-outputPath" && i + 1 < args.Length)
                outputPath = args[i + 1];
        }

        BuildTarget target = (BuildTarget)System.Enum.Parse(typeof(BuildTarget), buildTarget);
        string[] scenes = { "Assets/Scenes/Main.unity" };

        BuildPipeline.BuildPlayer(scenes, outputPath, target, BuildOptions.None);
        Debug.Log("Build finished: " + outputPath);
    }
}

---

5. 命令行执行时的生命周期与注意事项

• 参数解析：C++层先解析，部分参数传递到C#层。
• 项目加载：命令行模式下会自动加载项目和资源。
• 脚本编译：所有C#脚本会自动编译，编译失败则不会执行-executeMethod。
• 方法执行：通过反射调用指定静态方法。
• 自动退出：如有-quit参数，方法执行完毕后自动退出。
• 日志输出：所有日志输出到-logFile指定文件。

注意：

• 命令行模式下没有UI，不能弹窗、不能用EditorUtility.DisplayDialog等。
• 资源路径、输出路径要用绝对路径或项目相对路径，避免路径错误。

---

6. 进阶：如何扩展命令行自动化能力

• 参数传递复杂对象：可用JSON字符串作为参数，脚本中反序列化。
• 多任务串行：可在-executeMethod方法中调用多个子任务。
• 与CI/CD集成：结合Jenkins、GitLab CI等自动化工具，读取Unity进程退出码判断构建是否成功。
• 自定义日志分析：脚本中可自定义日志格式，便于后续自动化分析。

---

7. 参考源码与文档

• UnityCsReference/EditorApplication.cs
• Unity官方命令行参数文档
• Unity BuildPipeline API

---