cocoapods使用 swift注意事项
版权声明:本文为博主原创文章,未经博主允许不得转载。
说明:2015年12月2日更新,增加一个可能遇到的问题,优化排版。使用CocoaPods过程中遇到问题,欢迎评论交流。
一、CocoaPods的安装
(1)使用淘宝的Ruby镜像替换官方的ruby源,在终端输入命令
$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l
如果结果为下面的样子,说明替换成功了。
***CURRENT SOURCES ***
https://ruby.taobao.org/
(2)升级gem,在终端输入命令
$ sudo gem update --system
接着会要求输入电脑密码,输入密码后回车,就开始升级了。如果看到下面这句话,说明升级成功了。
RubyGems system software updated
(3)安装CocoaPods,在终端输入命令
$ sudo gem install cocoapods
输入密码后开始安装。
二、CocoaPods的使用
(1)查找第三方库,在终端输入命令
$ pod search AFNetworking
会显示出AFNetworking相关的库
(2)在工程中创建一个Podfile文件,在终端输入命令
$cd 工程根目录路径
$ touch Podfile
(3)使用Xcode打开Podfile,然后按如下格式编辑Podfile,保存。
platform :ios, '7.0'
pod 'AFNetworking', '~>2.0'
pod 'MJExtension'
platform :ios, '6.1'
pod 'SDWebImage', '~>3.7'
pod 'MBProgressHUD', '~>0.9.1'
pod 'Reachability', '~> 3.2'
(4)安装第三方库,在终端输入命令
$cd 工程根目录路径
$ pod install
至此,你的所有第三方库都已经下载完成并且设置好了编译参数和依赖。
三、日常使用
(1)使用CocoaPods 生成的 .xcworkspace 文件来打开工程,而不是以前的.xcodeproj 文件。
(2)每次更改了Podfile 文件,你需要cd到工程根目录,然后重新执行一次pod update命令。
四、可能遇到的问题
(1)使用cocoapods导入第三方类库后头文件没有代码提示?
解决办法: 选择Target -> Build Settings 菜单,找到\”User Header Search Paths\”设置项,新增一个值"${SRCROOT}",并且选择\”Recursive\”
(2)出现如下警告
[!] Your Podfile has had smart quotessanitised. To avoid issues in the future, you should not use TextEdit forediting it. If you are not using TextEdit, you should turn off smart quotes inyour editor of choice.
解决办法:不要使用文本编辑去编辑Podfile,使用Xcode编辑,或者使用终端敲命令去编辑。
(3) 执行pod install 或pod update 命令后,updating local specsrepositories 卡住不动
解决办法:pod install 被墙了,换成新的命令pod install --verbose --no-repo-update
(4) 项目运行时报错:Thefile “Pods.xcconfig” couldn’t be opened because there is no such file.
Swift使用时:
注意:你不能使用TextEdit来编辑Podfile,因为它有可能用图形化的更有吸引力的typeset quotes代替standard quotes,这可能导致CocoaPods不能理解并抛出错误,所以最好用Xcode或者别的编程文本编辑器来编辑你的Podfile。
默认的podFile看起来是这样的:
1
2
3
4
5
|
# Uncomment this line to define a global platform for your project# platform :ios, '6.0' target 'IceCreamShop' do end target 'IceCreamShopTests' do end |
将注释的内容替换成下面的两行:
1
|
platform :ios, "8.0" use_frameworks! |
这就告诉了CocoaPods--你的项目使用的是iOS 8.0,并且将使用框架来代替静态库。
想要在Swift中使用CocoaPods,你必须明确的写出use_frameworks! 来选择使用框架。如果你忘了写这个,CocoaPods能检测到你使用使用Swift CocoaPods,你安装pods的时候就会报错。
Swift podfile 格式
source 'https://github.com/CocoaPods/Specs.git' platform :ios, ‘8.0’ use_frameworks! target 'Alamofire+SwiftyJSON' do pod 'Alamofire', '~> 3.0' pod 'SwiftyJSON', '~> 3.0' end
Cocoapods 引用第三方库的几种方式
使用过 Cocoapods 的童鞋应该都知道,Cocoapods 的引用方式有三种:
方式 | 例子 | 说明 |
---|---|---|
版本号引用 | pod 'Alamofire', '~> 3.0' | 这种方式引用的是已经发布的版本,包含了 >``>=``<``<=``~> 几种版本限制符号,其中~> 符号代表只更新最新的小版本号,比如 ~> 1.0.0 则只会更新到 1.0.x 的最新版本,而不会更新 1.x.0 以上的版本 |
本地路径引用 | pod 'Alamofire', :path => '~/Documents/Alamofire' | 这种方式直接引用本地的代码,这种方式下对引用库的修改仍然会提交到引用库的 git 上,而不会提交到主工程。 |
远程 git 路径引用 | pod 'Alamofire', :git => 'https://github.com/Alamofire/Alamofire.git' | 这种方式直接引用远程 git 代码,不需要引用的库进行发布,而且还支持 :branch => 、:tag => 和 :commit => 三种选项 |