Unity iOS构建后脚本执行pod install失败问题排查

核心原因总结 #

Unity编辑器进程和终端进程的环境上下文不一致，是导致命令执行异常的主要原因，具体分这几点：

• 环境变量不匹配：终端里的PATH、Ruby/Gem环境变量不会自动同步到Unity进程，导致执行的pod可能是系统旧版本，或者找不到正确的依赖路径。
• 工作目录未指定：C# Process默认工作目录是Unity项目根目录，不是Podfile所在的构建输出目录，pod install找不到配置文件自然无效果。
• 输出流未捕获：没读取进程的标准输出/错误流，导致看不到实际的错误信息，误以为无输出。
• 文件状态未确认：修改Podfile后没确保文件写入完成就执行命令，Podfile还是旧内容，所以Podfile.lock无变化。

针对性解决办法 #

1. 强制同步环境变量 #

先在终端执行以下命令，复制输出的环境变量值：

echo $PATH
echo $GEM_HOME
echo $GEM_PATH

在C#脚本中设置Process的环境变量：

var startInfo = new ProcessStartInfo
{
    FileName = "/usr/local/bin/pod",
    Arguments = "install --verbose",
    UseShellExecute = false,
    RedirectStandardOutput = true,
    RedirectStandardError = true,
    CreateNoWindow = true
};
// 把终端复制的变量填进去
startInfo.EnvironmentVariables["PATH"] = "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"; // 替换成你的PATH值
startInfo.EnvironmentVariables["GEM_HOME"] = "/usr/local/lib/ruby/gems/3.2.0"; // 替换成你的GEM_HOME值

2. 明确设置工作目录 #

确保Process的工作目录是Podfile所在的构建输出目录：

// 比如构建输出的Xcode项目路径是Build/iOS/Unity-iPhone
startInfo.WorkingDirectory = Path.Combine(Application.dataPath, "../Build/iOS/Unity-iPhone");

3. 完整捕获输出流 #

必须读取标准输出和错误流，否则可能因为缓冲区满导致进程卡住，同时能看到真实错误：

var process = new Process { StartInfo = startInfo };
process.OutputDataReceived += (sender, e) => 
{
    if (!string.IsNullOrEmpty(e.Data))
        Debug.Log($"Pod Output: {e.Data}");
};
process.ErrorDataReceived += (sender, e) => 
{
    if (!string.IsNullOrEmpty(e.Data))
        Debug.LogError($"Pod Error: {e.Data}");
};
process.Start();
process.BeginOutputReadLine();
process.BeginErrorReadLine();
process.WaitForExit();

// 检查退出码，确认是否执行成功
if (process.ExitCode != 0)
    Debug.LogError($"Pod install failed with exit code: {process.ExitCode}");

4. 确认Podfile修改完成 #

修改Podfile后，要确保文件流关闭，写入完成：

// 比如用File.WriteAllText修改后，不需要手动关闭，但如果用StreamWriter要确保Dispose
File.WriteAllText(podfilePath, modifiedContent);
// 可以加个短暂延迟或者确认文件存在且内容正确
if (!File.Exists(podfilePath))
{
    Debug.LogError("Podfile not found!");
    return;
}

5. 用完整Ruby路径执行Pod #

如果环境变量同步还是有问题，直接指定正确的Ruby路径来执行Pod：

// 先在终端执行which ruby，得到路径比如/usr/local/opt/ruby/bin/ruby
startInfo.FileName = "/usr/local/opt/ruby/bin/ruby";
startInfo.Arguments = "/usr/local/bin/pod install --verbose";

内容的提问来源于stack exchange，提问作者Kevin