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

2025-11-19 12:49:12

1、打开Mac自带“终端”

      在Launchpad找到“其他”软件文件夹,找到终端打开。

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

2、替换Ruby的默认源,移除rubygems.org和淘宝的,改为ruby-china源

      gem sources --remove https://rubygems.org/

      gem sources --remove  https://ruby.taobao.org

      gem source -a https://gems.ruby-china.com

3、验证是否成功替换Ruby的默认源

      gem sources -l

最后只保留:

     https://gems.ruby-china.com

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

4、更新Mac 的Gem,Gem是管理Ruby库和程序的标准包

      sudo gem update --system 

或者(Mac OSX 10.11之后)

      sudo gem update -n /usr/local/bin —system

然后输入管理员权限密码(看不到输入结果的,输完密码之后直接回车)

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

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

5、完成安装CocoaPods

      sudo gem install cocoapods  

或者(Mac OSX 10.11之后)

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

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

1、查找自己需要添加的第三方库

      pod search + 库名

如输入:pod search AFNetworking 后,等待返回所有符合搜索条件的结果。可以直接利用的是:pod 'AFNetworking', '~> 3.1.0'

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

2、找到项目文件路径

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

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

3、创建并编辑Podfile文件(可以终端操作,也可以直接手动操作)

      终端输入:vim podfile 或者 pod init(推荐)

编辑文件,没有文件就自动在当前目录添加一个文件再编辑。输入内容:

      platform :ios, '8.0'

      target “target名称” do

      pod 'AFNetworking', '~> 3.1.0'

      end

按Esc退出编辑,然后按Shift +冒号,输入wq退出文件编辑。

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

4、为项目导入第三方库和相关依赖库

      终端输入:pod install

然后耐心等待下载第三方库,如果文件大,可能要花长时间。终端会打印进度的。

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

5、至此,添加已经完成。可以看到项目目录里面多了4个文件,以后运行工程都使用.xcworkspace文件,而不再用.xcodeproj了。

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

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

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

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

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

4、TARGETS - Build Phases 删除有关pods的选项,至此完成删除。

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了。所以gem sources -a http://ruby.taobao.org/ 需要替换成:gem sources -a https://ruby.taobao.org/ 

2、ERROR:  While executing gem ... (Errno::EPERM)

    Operation not permitted - /usr/bin/update_rubygems

说明:

      Mac OSX 10.11不能使用sudo gem update —system了,需要替换成:sudo gem update-n /usr/local/bin —system

3、ERROR:  While executing gem ... (Errno::EPERM)

    Operation not permitted - /usr/bin/pod

说明:

      Mac OSX 10.11不能使用sudo gem install cocoapods了,需要替换成: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。
猜你喜欢