CocoaPods安装和使用

1.前提

CocoaPods安装的前提是安装了ruby,因为CocoaPods基于Ruby语言开发而成,因此安装CocoaPods前需要安装Ruby环境。而Mac系统默认自带Ruby环境,如果没有请自行查找安装,检查Ruby版本
ruby -v
1-1.注意镜像
检查查看当前镜像源 gem sources -l

gem sources -l
*** CURRENT SOURCES ***

https://gems.ruby-china.org

如果源地址是https://rubygems.org/,就需要改成https://ruby.taobao.org/或者https://gems.ruby-china.org
第一步:移除默认的镜像
gem sources --remove https://rubygems.org/ (gem sources --r https://rubygems.org/
第二步:设置镜像
gem sources -add https://ruby.taobao.org/ (或者gem sources -a https://ruby.taobao.org/)

添加国内ruby源 gem sources --add https://gems.ruby-china.org
报错:Error fetching https://gems.ruby-china.org/: bad response Not Found 404 (https://gems.ruby-china.org/specs.4.8.gz)
这里注意:https://gems.ruby-china.org镜像源服务器地址换了,改成了https://gems.ruby-china.com
命令替换为 gem sources --add https://gems.ruby-china.com 解决

1-2.要更新gem
如果1-1完成后可以直接先尝试安装CocoaPods,如果安装CocoaPods不通过,出现以下问题,那就是要升级更新gem 用gem命令安装CocoaPods: gem install -n /usr/local/bin cocoapods

sudo gem install cocoapods
ERROR:  While executing gem ... (TypeError)
    no implicit conversion of nil into String

更新gem
gem update --system
如果更新gem 出现以下问题,那就是权限问题,那更新gem要用这个命令sudo gem update --system

gem update --system
ERROR:  While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/Gems/2.3.0 directory.

如果更新gem通过就可以进行安装CocoaPods步骤
更新gem后,可以检查gem版本
gem -v

2.安装CocoaPods

//安装 (Mac系统:OS X 10.10 Yosemite(2014年6月3号发布)及之前)
sudo gem install cocoapods

mac osx 10.11 之后
sudo gem install -n /usr/local/bin cocoapods --pre //安装最新版本(或是升级 cocoapods到最新版本) sudo gem install -n /usr/local/bin cocoapods -v 1.4.0 //1.4.0是安装指定版本的cocoapods

//安装CocoaPods并指定路径 不指定cocoapods版本 一般用这个命令安装就可以了(Mac系统:OS X EL Capitan(2015年9月29号发布)及之后)
sudo gem install -n /usr/local/bin cocoapods

总结:安装cocoapods需要权限,命令前用sudo
安装CocoaPods并指定路径 一般用这个命令安装就可以了
sudo gem install -n /usr/local/bin cocoapods
//下载本地库master(~/.cocoapods文件夹可以看到repos里面的master)
pod setup //这一步 过程可能缓慢,请耐心等待

安装cocoapods完成后可以查看cocoapods 版本
pod --version

安装cocoapods完成后也可以查看cocoapods 安装路径
which pod

3.CocoaPods使用

进入项目CFFApp目录下,新建Podfile文件
//进入项目
cd /Users/company/Desktop/demo粒子/CFFApp/
//查看
ls
//vim命令是不存在就创建,存在就打开。创建Podfile文件pod install之后,项目会出现一个CFFApp.xcworkspace的文件,以后双击CFFApp.xcworkspace打开项目(没有创建Podfile时,是双击CFFApp.xcodeproj打开项目)
//第一种:直接vim Podfile 创建并且打开Podfile文件
vim Podfile
打开Podfile,按i可以进入编辑状态,编辑Podfile

platform :ios ,'8.0'
target 'demo' do

# 自动布局
pod 'Masonry', '~> 1.0.2'
pod 'YYKit', '~> 1.0.9'

end

第二种:
init Podfile //初始化Podfile文件
vim Podfile //打开已有的Podfile文件

编辑Podfile文件完成就按esc退出编辑状态,输入:wq 保存退出Podfile文件
//pods安装导入第三方框架
pod install

pod install(安装pods第三方框架)是按照Podfile指定版本下载第三方框架,它不顺带更新本地仓库(repos 安装完cocoapods后,在用户根目录下有个隐藏文件夹,/Users/<user>/.cocoapods,里面是cocoapods收录的所有库的配置信息)
pod update(更新pods第三方框架)是pods修改之后更新变动,它顺带更新本地仓库(repos 查看repos :finder->前往->前往文件夹->~/.cocoapods 可看到.cocoapods的repos)

有时候出现以下问题

 pod install
Analyzing dependencies
[!] Unable to satisfy the following requirements:

- `RTRootNavigationController` required by `Podfile`
- `RTRootNavigationController (= 0.6.1)` required by `Podfile.lock`

None of your spec sources contain a spec satisfying the dependencies: `RTRootNavigationController, RTRootNavigationController (= 0.6.1)`.

You have either:
 * out-of-date source repos which you can update with `pod repo update` or with `pod install --repo-update`.
 * mistyped the name or version.
 * not added the source repo that hosts the Podspec to your Podfile.

Note: as of CocoaPods 1.0, `pod repo update` does not happen on `pod install` by default.

这个错误是RTRootNavigationController跟本地配置信息版本不一致,要更新本地repos
默认情况下,执行pod install不会自动执行pod repo update命令。
简单来说,pod repo update命名是用来更新本地cocoapods的spec资源配置信息。
安装完cocoapods后,在用户根目录下有个隐藏文件夹,/Users/<user>/.cocoapods,里面是cocoapods收录的所有库的配置信息,/Users/<user>/.cocoapods/repos/master/Specs/<lib name>。比如AFNetworking就是/Users/<user>/.cocoapods/repos/master/Specs/AFNetworking,内部分版本包含多个文件夹,每个文件夹内包含一个配置文件,比如AFNetworking.podspec.json。
这个问题可以用pod update解决

pod install和pod update要下载更新repos会有点慢,有时不想更新repos,可以
使用pod install --verbose --no-repo-update
和pod update --verbose --no-repo-update来安装和升级。

4.删除CocoaPods

查看CocoaPods的版本
pod --version
删除cocoapods
sudo gem uninstall CocoaPods

5.升级Cocoapods

升级Cocoapods版本一般用这个命令:sudo gem install -n /usr/local/bin cocoapods (这个命令和安装Cocoapods命令是一样的,可以这么理解:没安装Cocoapods时这个命令是安装,安装Cocoapods后这个命令是升级Cocoapods版本)

升级Cocoapods版本如下:
sudo gem install -n /usr/local/bin cocoapods
pod setup

升级完成后可以查看cocoapods版本号,用pod --version查看

补充:

升级mac系统后,pods可能会失效
像平常一样用pods导入第三方框架 出现以下问题,就需要重新安装CocoaPods,就需要从步骤1开始

pod install
-bash: /usr/local/bin/pod: /System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/ruby: bad interpreter: No such file or directory

pod install出现以下问题
[!] Error installing Masonry
[!] /usr/bin/git clone https://github.com/cloudkite/Masonry.git /var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1308-18wqdi0 --template= --single-branch --depth 1 --branch v1.1.0

Cloning into '/var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1308-18wqdi0'...
fatal: unable to access 'https://github.com/cloudkite/Masonry.git/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443

参考:http://events.jianshu.io/p/869b2325bb74
sudo vim /etc/hosts 进/etc/hosts需要权限

如果pod install 导入YYKit出现以下问题,有时候可能是网不好,重新pod install 就行了
Error installing YYKit
[!] /usr/bin/git clone https://github.com/ibireme/YYKit.git /var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1436-ri4xm8 --template= --single-branch --depth 1 --branch 1.0.9

Cloning into '/var/folders/8c/lrj3mnsn1dg6fbypxm6zf7vw0000gn/T/d20210425-1436-ri4xm8'...
fatal: unable to access 'https://github.com/ibireme/YYKit.git/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443

这个链接的文章也很有作用
http://blog.csdn.net/sharktoping/article/details/52311460

命令:
参考:https://blog.csdn.net/qq_16696763/article/details/82852143?utm_medium=distribute.pc_relevant_t0.none-task-blog-2%7Edefault%7EBlogCommendFromMachineLearnPai2%7Edefault-1.essearch_pc_relevant&depth_1-utm_source=distribute.pc_relevant_t0.none-task-blog-2%7Edefault%7EBlogCommendFromMachineLearnPai2%7Edefault-1.essearch_pc_relevant

pod install 全部下载(还要更新本地spec)
pod update 全部更新(还要更新本地spec)

pod install --verbose --no-repo-update 全部下载(忽略更新本地spec)
pod update --verbose --no-repo-update 全部更新(忽略更新本地spec)

单独更新某个库
pod update MJRefresh --verbose --no-repo-update

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • *CocoaPods安装 1. 替换ruby源 1.1 CocoaPods是基于ruby ecosystem的,需...
    GatesLand阅读 10,297评论 0 6
  • 一.CocoaPods是什么? CocoaPods是一个用Ruby写的、负责管理iOS项目中第三方开源库的工具,C...
    王小祺阅读 4,057评论 1 0
  • //电脑已经安装完成 :cd 到文件夹下 1.touch podfile 2添加 platform :ios,'...
    330PG阅读 1,319评论 0 0
  • cocoaPods的安装每次安装都是去百度一堆博客,进行安装,时不时的还会有坑,避免以后每次安装能顺利进行,...
    森碟儿阅读 5,412评论 1 1
  • 16宿命:用概率思维提高你的胜算 以前的我是风险厌恶者,不喜欢去冒险,但是人生放弃了冒险,也就放弃了无数的可能。 ...
    yichen大刀阅读 11,299评论 0 4

友情链接更多精彩内容