网上关于cocoapods的安装可谓是不可胜数。但是对于新版的系统来说,的确存在很多的坑点,本文只是对网上资源做了整合和自己的一些使用见解。
一:卸载cocopods
1.卸载老版本cocopods
$ sudo gem uninstall cocoapods
2.查看本地安装过的cocopods相关东西
$ gem list --local | grep cocoapods
结果如下:
cocoapods (1.0.1)
cocoapods-core (1.0.1)
cocoapods-deintegrate (1.0.1)
...
3.然后使用命令逐个删除
$ sudo gem uninstall +你要删除的库名称
比如:$ sudo gem uninstall cocoapods-core
.cocopods 文件有可能因为权限问题删除不了,可以直接找到 .cocopods 文件(隐藏文件)删掉就好
显示隐藏文件 :
defaults write com.apple.finder AppleShowAllFiles -bool true
killall Finder
二:安装cocopods
1.终端输入
$ curl -L https://get.rvm.io | bash -s stable
2.载入 RVM 环境
$ source ~/.rvm/scripts/rvm
检查一下是否安装正确
$ rvm -v
打印结果为:rvm 1.27.0 (latest) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]
3.用RVM安装Ruby环境
- 可以先查询已经安装的ruby
$ rvm list
- 如果你想卸载一个已安装版本
$ rvm remove 1.9.2
- 列出已知的ruby版本
$ rvm list known
- 可以选择现有的rvm版本来进行安装(下面以rvm 2.3.0版本的安装为例)
$ rvm install 2.3.0
- 设置Ruby版本
- RVM 装好以后,需要执行下面的命令将指定版本的 Ruby 设置为系统默认版本
$ rvm 2.3.0 --default
- 验证RVM
$ ruby -v
打印如下:ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
- 查看ruby源
$ gem sources -l
- 可以查看当前是什么连接,然后替换方式如下:
$ gem source -r https://rubygems.org/
$ gem sources --add https://gems.ruby-china.com/
- 有多余的镜像可以移除
gem sources --remove 镜像链接
- 要想验证是否替换成功了,可以执行:
$ gem sources -l
- 成功显示
*** CURRENT SOURCES ***
https://gems.ruby-china.com/
- 开始安装cocoapods
$ sudo gem install cocoapods
等到提示:gems installed
$ pod setup
- 如果报异常可先执行
$ sudo rm -fr ~/.cocoapods/repos/master
再执行$ pod setup
- 如果报git相关异常估计是系统升级导致的,先执行
$ xcode-select --install
再执行$ pod setup
漫长的等待,估计有五百多兆...
如果安装过程中报如下错误:
unable to access 'https://github.com/CocoaPods/Specs.git/': SSLRead() return error -9806
遇到这种问题的话,可以手动去克隆一份到repos目录下面。
- 步骤1.通过finder的前往文件夹进行查看 ~/.cocoapods/repos
- 步骤2.通过终端,进入到 ~/.cocoapods/repos
- 步骤3.然后通过 git clone https://github.com/CocoaPods/Specs.git
可怜的你发现,速度真是慢啊,你等不了,还有二个解决方法
直接打开仓库链接,下载下来拷贝到相应的问价夹
可怜的你还是发现,下载速度也很慢啊,这里还有一个解决方案,等!等等就快了,笔者试了的确比克隆快-
终极解决方案,找一台工作正常的电脑,到他的~/.cocoapods/repos目录下面拷贝出master文件到自己的Mac上的相应位置
好了,现在我们重新检测一下是否能正常运行。
三:使用cocoapods
- 终端进入项目目录下
cd 空格一下 + 文件路径(直接把项目拉入终端即可)
如:cd ~/Path/To/Folder/Containing/IceCreamShop
- 创建一个PodFile
pod init
这将为你的项目创建一个PodFile文件
- 输入下面的命令行打开PodFile,并使用Xcode进行编辑:
open -a Xcode Podfile
注意:你不能使用TextEdit来编辑Podfile,因为它有可能用图形化的更有吸引力的typeset quotes代替standard quotes,这可能导致CocoaPods不能理解并抛出错误,所以最好用Xcode或者别的编程文本编辑器来编辑你的Podfile。
默认的podFile看起来是这样的:
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
target 'testProject' do
# Comment the next line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!
# Pods for testProject
end
- 将
# platform :ios, '9.0'
的#号去掉,后面的9.0可以根据项目需要更改,这段话就告诉了CocoaPods--你的项目使用的是iOS 9.0,并且将使用框架来代替静态库。 - 安装你的第一个库,将下面的内容添加到你的Podfile里面
pod 'Alamofire', '1.2.3'
保存并关闭podFile
- 开始给项目安装CocoaPods
pod install
- 如果库比较多,在重新导入库用
pod install
就比较慢,下面的2个命令在安装新的库的前面不会重新更新前面已经安装的库
pod install --no-repo-update
或
pod update --no-repo-update
四:Podfile的语法解释
示列一个稍微复杂的Podfile:
source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
use_frameworks!
inhibit_all_warnings!
workspace 'JYCocoaPodsTest'
target 'JYCocoaPodsTest' do
pod 'AFNetworking'
pod 'JYCarousel', '0.0.1'
pod 'WCJCache', :git => "http://gitlab.9ijx.com/iOS/WCJCache.git"
target :JYCocoaPodsTestUITests do
inherit! :search_paths
pod 'YYText'
end
end
1.platform :iOS, '7.0'
- 指定了开源库应该被编译在哪个平台以及平台的最低版本。
- 若不指定平台版本,官方文档里写明各平台默认值为iOS:4.3,OS X:10.6,tvOS:9.0,watchOS:2.0
inhibit_all_warnings!
- 屏蔽cocoapods库里面的所有警告
- 这个特性也能在子target里面定义,如果你想屏蔽某pod里面的警告也是可以的:
pod 'JYCarousel', :inhibit_warnings => true
-
xcodeproj
现在被project
代替,这个变量就别使用了
- 允许你指定需要链接的工程
-
use_frameworks!
使用frameworks动态库替换静态库链接
- swift项目cocoapods 默认 use_frameworks!
- OC项目cocoapods 默认 #use_frameworks!
-
workspace
- 指定应该包含所有projects的Xcode workspace.
- 如果没有显示指定workspace并且在Podfile所在目录只有一个project,那么project的名称会被用作于workspace的名称
project
默认情况下是没有指定的,当没有指定时,会使用Podfile目录下与target同名的工程:(我们只有一个工程JYCocoaPodsTest)
# JYCocoaPodsTest这个Target只有在JYCocoaPodsTest工程中才会链接
target 'JYCocoaPodsTest' do
project 'JYCocoaPodsTest'
...
end
target 'xxxx' do ...end
- 指定特定Target的依赖库
- 可以嵌套子Target的依赖库
inherit! :search_paths
- 明确指定继承于父层的所有pod,默认就是继承的
source
- 指定specs的位置,自定义添加自己的podspec。公司内部使用
cocoapods 官方source是隐式的需要的,一旦你指定了其他source 你就需要也把官方的指定上
例如:
source 'ssh://git@gitlab.9ijx.com:9830/iOS/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
- 依赖库的基本写法:
pod 'JYCarousel', //不显式指定依赖库版本,表示每次都获取最新版本
pod 'JYCarousel', '0.01'//只使用0.0.1版本
pod 'JYCarousel', '>0.0.1' //使用高于0.0.1的版本
pod 'JYCarousel', '>=0.0.1' //使用大于或等于0.0.1的版本
pod 'JYCarousel', '<0.0.2' //使用小于0.0.2的版本
pod 'JYCarousel', '<=0.0.2' //使用小于或等于0.0.2的版本
pod 'JYCarousel', '~>0.0.1' //使用大于等于0.0.1但小于0.1的版本,相当于>=0.0.1&&<0.1
pod 'JYCarousel', '~>0.1' //使用大于等于0.1但小于1.0的版本
pod 'JYCarousel', '~>0' //高于0的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本
// 依赖库的自定义写法
pod 'JYCarousel', :path => '/Users/Dely/Desktop/JYCarousel'
end
查看最新CocoaPods的下载地址 https://ruby-china.org/