一、概要
CocoaPods可以用来方便的统一管理第三方库
二、安装
第一步,首先要检查Mac是否安装了rvm,打开终端,输入 rvm -v
huangzhdeMacBook-Pro:~ careland$ rvm -v
-bash: rvm: command not found
step1:安装rvm
curl -L get.rvm.io | bash -s stable
step2:指定源
source ~/.rvm/scripts/rvm
step3 :查看版本确认是否安装成功
rvm -v
//会出现类似这种的 表示安装成功
rvm 1.29.4 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
Step 4: 列出所有指定源里的ruby版本
rvm list known
//出现以下内容
# MRI Rubies
[ruby-]1.8.6[-p420]
[ruby-]1.8.7[-head] # security released on head
[ruby-]1.9.1[-p431]
[ruby-]1.9.2[-p330]
[ruby-]1.9.3[-p551]
[ruby-]2.0.0[-p648]
[ruby-]2.1[.10]
[ruby-]2.2[.10]
[ruby-]2.3[.7]
[ruby-]2.4[.4]
[ruby-]2.5[.1]
[ruby-]2.6[.0-preview2]
ruby-head
第二步,用rvm安装ruby环境
一般 Mac OS本身自带Ruby 但是基本都要先升级 (以下是在终端操作)
1、查看当前的ruby的版本
ruby -v
ruby 2.3.3p222 (2016-11-21 revision 56859) [universal.x86_64-darwin17]
2、升级最新版的ruby
在上面操作中 rvm list known 指令中可以看到ruby的最新版本为2.5.1 所以执行以下指令 然后根据提示按“enter”键。
rvm install 2.5.1
3、这里在升级ruby的时候失败的话 可能是gem太老了可以尝试用如下命令升级 gem
sudo gem update --system
4、检查ruby源并移除
移除源,gem sources --remove https://rubygems.org/
添加源,gem sources -a https://gems.ruby-china.org/
查看源,gem sources -l
第三步,安装CocoaPods(sudo 表示管理员执行指令,需要输入密码的)
OS X 10.11之前系统的安装cocoapods 指令:$ sudo gem install cocoapods
OS X 10.11以后系统的安装cocoapods 指令:$ sudo gem install -n /usr/local/bin cocoa pods
然后 执行 完成之后执行 search的操作 看看能否search成功
pod setup
pod search afnetworking
第四 常见的错误
Unable to find a pod with name, author, summary, or description matching
解决办法
rm ~/Library/Caches/CocoaPods/search_index.json (第一步)
pod search afnetworking (第二步)
can't find gem cocoapods (>= 0.a)
解决办法
1: sudo gem uninstall cocoapods
2: gem install cocoapods
三、使用
Step1:使用终端进入到你工程目录下
cd 目标文件路径(直接拖过来就行)
Step2:执行pod init指令
pod init 或 vim Podfile
执行成功后会出现一个 Podfile 的文件 这里可以用终端的vim 进行编辑 我这里直接拖到xcode上打开进行编辑(推荐使用Vim)
Step3:编辑Podfile文件并保存
键盘输入 i,进入编辑模式,输入
platform :ios, '9.0'
pod 'AFNetworking'
然后按Esc,并且输入“ :”号进入vim命令模式,然后在冒号后边输入wq
注意:键盘输入 :后,才能输入wq。
Step4:终端执行命令pod install
执行后出现
Analyzing dependencies
Downloading dependencies
Installing AFNetworking (3.2.1)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `iOS Example.xcworkspace` for this project from now on.
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.
Step5:打开xcworkspace
用pod之后就是用xcworkspace打开工程,然后在工程中导入AFN 可以的话就OK了
xcode import pod 文件不提示问题
选择工程的target--buildSettings--search paths下的User Header Search Paths
添加一项设置为${PODS_ROOT} ,选择:recursive(会在相应的目录递归搜索文件)