Unity中External Dependency Manager安装Cocoapods成功但找不到pod工具求助

问题背景 #

在Apple M1 Pro设备上使用Unity 2022.3.10f1构建iOS项目时，通过External Dependency Manager执行gem install cocoapods --user-install安装成功，但Unity提示无法找到pod工具，导致生成的Xcode项目无法安装Cocoapods，进而引发链接错误。终端环境中pod --version显示1.13.0，Ruby版本3.2.2，Gem版本3.4.10，且已配置$PATH但问题仍存在。

解决步骤 #

1. 确认并修复Gem用户路径的PATH配置 #

• 执行gem environment，找到USER INSTALLATION DIRECTORY下的bin目录路径（例如/Users/[你的用户名]/.gem/ruby/3.2.0/bin）
• 编辑终端配置文件（zsh用户为~/.zshrc，bash用户为~/.bash_profile），添加以下内容：

  export PATH="/Users/[你的用户名]/.gem/ruby/3.2.0/bin:$PATH"
  

• 执行source ~/.zshrc（或对应配置文件）使修改生效，之后通过终端启动Unity：

  open /Applications/Unity/Hub/Editor/2022.3.10f1/Unity.app
  

2. 手动为Unity指定pod绝对路径 #

• 在终端执行which pod获取pod的完整路径（例如/Users/[你的用户名]/.gem/ruby/3.2.0/bin/pod）
• 打开Unity的Window > Package Manager，找到External Dependency Manager for Unity，进入其设置面板，在iOS相关配置中手动填入上述pod路径。

3. 改用Homebrew重新安装Cocoapods（M1设备推荐） #

• 卸载现有Cocoapods版本：

  gem uninstall cocoapods
  

  选择卸载所有已安装版本
• 通过Homebrew安装：

  brew install cocoapods
  

• 执行pod setup完成初始化，确认pod --version正常后重启Unity。

4. 检查Unity iOS构建设置 #

• 进入Unity的Edit > Project Settings > Player > iOS，找到External Dependency Manager部分：
  • 确保Podfile Generation处于启用状态
  • 勾选Use Shell Environment选项，让Unity读取系统PATH配置

5. 解决Branch.io头文件问题 #

• 确认External Dependency Manager生成的Podfile中包含Branch依赖：

  pod 'Branch', '~> 1.39.0' # 替换为项目所需版本
  

• 在生成的Xcode项目中，进入Build Settings > Header Search Paths，添加$(SRCROOT)/Pods/Headers/Public/Branch并设置为Recursive

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