unity打包ios工程报错iOS framework addition failed due to a Cocoapods installation failure. This will will

本文提供了解决Unity首次导出Xcode工程时遇到的CocoaPods安装失败问题的详细步骤。从Xcode的正确配置到CocoaPods的卸载与重装,再到特定库的安装,最后推荐使用.xcworkspace文件打开项目,确保导出的iOS项目功能正常。

笔者导出xcode工程遇到报错:iOS framework addition failed due to a Cocoapods installation failure. This will will likely result in an non–functional Xcode project
原因就是cocoapods配置有问题,使用的是unity第一次导出xcode后台自动配置的cocoapods。
可以按照以下步骤解决这个问题

1,安装Xcode

2,Sudo xcode-select

打开终端,执行以下命令
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
上面是xcode的默认路径,需要根据自己的情况来执行命令。
有时候输入该命令,可能就可以顺利导出工程。否则的话,继续往下看

3,卸载cocoapods并重装

卸载

sudo gem uninstall cocoapods -n/usr/local/bin

命令窗口中,遇到对话,输入y,并回车

卸载完毕后,继续执行命令

sudo gem install cocoapods -n/usr/local/bin

这样便安装了最新版本的cocoapods

上面可以很快处理好,但是cocoapods还依赖具体的库。
如果你已经安装了.cocoapods,那么通过Command + Shift + G,输入~/.cocoapods是可以看到这个文件夹的,那么请删除它下面的所有文件。
然后按照下面的步骤来安装对应的库。
1,在.cocoapods目录下创建repos文件夹
2,打开命令行terminal工具,依次执行下面3个命令

cd ~/.cocoapods/repos
git clone --depth 1 https://github.com/CocoaPods/Specs.git master
pod repo update

注意,上述命令需要一个一个执行成功后,再执行下一个。
其中第二个要稍微等久一点

4,使用.xcworkspace代替.xcodeproj

上述配置完成后,再通过Unity顺利导出xcode工程后,会有一个.xcworkspace文件,双击它,打开xcode
目录结构如下:
在这里插入图片描述

参考文档:
http://shobhitsamaria.com/cocoapods-installation-failure-while-building-unity-project-for-ios/

### 问题分析 在使用 Unity 导出 Xcode 工程时,若出现错误信息 `iOS framework addition failed due to a CocoaPods installation failure`,通常表明 CocoaPods 的安装或配置存在问题,导致 Xcode 项目无法正确集成所需的依赖库。此问题可能由多种原因引起,包括环境变量配置、CocoaPods 安装状态、Ruby 环境问题等。 --- ### 解决方案 #### 1. 确保 Xcode 正确安装并配置命令行工具 在某些情况下,Xcode 命令行工具未正确配置会导致 CocoaPods 安装失败。可通过以下命令设置 Xcode 命令行工具路径: ```bash sudo xcode-select -s /Applications/Xcode.app ``` 此外,确认 Xcode 是否已接受许可协议: ```bash sudo xcodebuild -license ``` #### 2. 修复 CocoaPods 安装 如果 CocoaPods 已安装但无法正常工作,建议重新安装: ```bash sudo gem install cocoapods ``` 如果安装失败,可能由于 Ruby 源问题,可尝试切换至官方源: ```bash gem sources --remove https://ruby.taobao.org/ gem sources -a https://rubygems.org/ ``` 随后重新安装 CocoaPods: ```bash sudo gem install cocoapods ``` #### 3. 解决终端编码问题(UTF-8) CocoaPods 要求终端使用 UTF-8 编码,否则可能出现警告或安装失败。可通过配置环境变量解决: ```bash cd ~ echo 'export LANG=en_US.UTF-8' >> .profile source .profile ``` 验证当前编码设置: ```bash echo $LANG ``` 输出应为 `en_US.UTF-8`。若未生效,可尝试重启终端或重新登录用户会话。 #### 4. 更新 CocoaPods 仓库 若 CocoaPods 仓库过时或损坏,可能导致依赖解析失败。执行以下命令更新仓库: ```bash pod repo update ``` 如果更新失败,可尝试删除本地仓库后重新初始化: ```bash rm -rf ~/.cocoapods/repos/master pod setup ``` #### 5. 检查 Ruby 环境 CocoaPods 依赖于 Ruby 环境,若 Ruby 版本过旧或配置异常,可能导致安装失败。建议使用 RVM 管理 Ruby 版本: ```bash \curl -sSL https://get.rvm.io | bash -s stable source ~/.rvm/scripts/rvm rvm install ruby rvm use ruby --default ``` 确认 Ruby 版本: ```bash ruby -v ``` 确保版本不低于 2.6。 #### 6. 检查 Podfile 配置 确保导出的 Xcode 工程中 `Podfile` 正确无误,尤其是 `target` 名称与 Xcode 中的项目目标一致。例如: ```ruby platform :ios, '10.0' use_frameworks! target 'Unity-iPhone' do pod 'Google-Mobile-Ads-SDK', '~> 8.0' end ``` 保存后执行: ```bash pod install ``` --- ### 验证修复结果 完成上述步骤后,再次尝试导出 Xcode 工程,并检查是否仍出现 `iOS framework addition failed` 错误。若问题已解决,应能正常生成 `.xcworkspace` 文件,并成功编译运行。 --- ###
评论 7
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

iningwei

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值