iOS开发 CocoaPods安装、移除和常见问题

2025-07-06 15:39:36

CocoaPods是iOS项目的依赖管理工具,让开发者可以快速集成第三方开源库和添加依赖库。随着Ruby、Gem、Mac OSX、Xcode和CocoaPods的更新,CocoaPods的安装方法也随着变化,当然也会产生各种这样的问题。

工具/原料

Mac OSX操作系统:OS X 10.11.5

编译环境:Xcode 7.3.1

Mac自带终端

搭建CocoaPods环境

1、打开Mac自带“终端” 在Launchpad找到“其他”软件文件夹,找到终端打开。

iOS开发 CocoaPods安装、移除和常见问题

4、更新Mac 的Gem,Gem是管理Ruby库和程序的标准包 sudogemupdate--system或者(Mac OSX 10.11之后) sudo gem update -n /usr/local/bin —system然后输入管理员权限密码(看不到输入结果的,输完密码之后直接回车)

iOS开发 CocoaPods安装、移除和常见问题

5、完成安装CocoaPods sudogeminstallcocoapods 或者(Mac OSX 10.11之后) sudo gem install -n /usr/local/bin cocoapods

iOS开发 CocoaPods安装、移除和常见问题

2、找到项目文件路径 在终端输入cd+空格,然后拖动项目文件夹到终端,自动生成路径。

iOS开发 CocoaPods安装、移除和常见问题

4、为项目导入第三方库和相关依赖库 终端输入:pod install然后耐心等待下载第三方库,如果文件大,可能要花长时间。终端会打印进度的。

iOS开发 CocoaPods安装、移除和常见问题

移除CocoaPods

1、编辑Podfile文件,清除里面所有库,然后终端输入:pod install。这时会清空第三方库和相关依赖库。

2、删除之前的4个文件,Podfile、Podfile.lock、Pods文件夹和.xcworkspace文件。

3、然后打开.xcodeproj,删除项目中的libpods.a和Pods.xcconfig引用。

iOS开发 CocoaPods安装、移除和常见问题

常见问题

1、Error fetching http://ruby.taobao.org/: bad response Not Found 404 烫喇霰嘴(http://ruby.taobao.org/specs.4.8.gz)说明: 链接不到Ruby淘宝源,常见的404错误,可能因为https替换http了。所以gemsources-ahttp://ruby.taobao.org/ 需要替换成:gemsources-ahttps://ruby.taobao.org/

2、ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/update_rubygems说明: Mac OSX 10.11不能使用sudogemupdate—system了,需要替换成:sudo gemupdate-n /usr/local/bin—system

3、ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/pod说明: Mac OSX 10.11不能使用sudogeminstallcocoapods了,需要替换成:sudo gem install -n /usr/local/bin cocoapods

4、[!] Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master-1`. You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.说明: 由于安装了多个Xcode导致路径变了,需要变换路径:sudo xcode-select -switch /Applications/Xcode6.4/Xcode.app

5、The dependency `` is not used in any concrete target说明: Podfile升级之后到1.0.0版本,Pod里的内容必须明确指出所用第三方库的target,所以在podfile文件需要明确: target “YOUR_TARGRT_NAME” do ... end

6、Error installing cocoapods:activesupport requires Ruby version >= 2.2.2.说明: 在安装cocoapods过程中提示需要Ruby的版本在2.2.2以上。 查看当前Ruby版本,输入指令:ruby -v解决方法: 通过rvm安装新版Ruby,输入指令:curl -L get.rvm.io | bash -s stable 重装rvm,输入指令:rvm reload 然后安装Ruby,输入指令:rvm install ruby 如果出现:Requirements installation failed with status: 1.则需要输入: 第一行:ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 第二行:rvm autolibs read-only # read more here:https://rvm.io/rvm/autolibs 第三行,再次安装:rvm install ruby然后终端就疯狂的开始下载了。

7、[!] Unable to find a pod with name, author, 衡痕贤伎summary, or description 罪焐芡拂matching `xxx`说明: 搜索库:pod search xxx报错; 是search_index.json这个文件的原因,可以将其删除,然后重新生成便可解决此问题。解决方法: 输入指令:rm ~/Library/Caches/CocoaPods/search_index.json 完成即可重新搜索。

声明:本网站引用、摘录或转载内容仅供网站访问者交流或参考,不代表本站立场,如存在版权或非法内容,请联系站长删除,联系邮箱:site.kefu@qq.com。
猜你喜欢