Cocoapods安装、使用

作者: 遛遛食 | 来源:发表于2017-06-16 17:08 被阅读166次

在iOS开发中,经常会使用到一些第三方库,例如AFNetwoking,MJRefresh等,如果我们都去手动导入的话,有时候还要进行配置非常麻烦,所以就是用Cocoapods让他来帮我们配置和管理第三方库。
网上有很多关于Cocoapods的使用教程,而且写得非常详细,但是我写的这篇,主要就是告诉大家使用,和自己学习的一个总结。下面开始来介绍

Cocoapods安装步骤:

1.升级Ruby环境

打开终端输入:$ gem update --system

如果出现:ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/ Gems/2.0.0 directory. 就更新Ruby

强制更新

$ sudo gem update —system

2.更新Ruby源

$ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
$ gem sources -l
*** CURRENT SOURCES ***
</br>
https://gems.ruby-china.org
# 请确保只有 gems.ruby-china.org
$ gem install rails

3.安装Cocoapods

$ sudo gem install cocoapods
这个时候会提示你输入密码,注:在终端输密码不会有提 ,光标也不会移动。
第一次安装时间会比较长

如果报以下错误:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/xcodeproj
解决办法:

终端输入:$sudo gem install -n /usr/local/bin cocoapods
pod setup

cocoapods安装路径是在~/.cocoapods文件夹里如果安装失败建议把这个文件里面的东西全部删除,重新安装

如果想查看下载进度的话,先到cocoapods文件夹下
$cd ~/.cocoapods
然后在终端输入:
$du -sh *
即可查看下载的文件大小。也就可以知道是网速不好,还是源不可用了。

安装成功后,你会看到:Setup completed


Cocoapods使用

1.创建podfile文件

使用时,先创建iOS工程,然后cd 到工程目录下,创建podfile文件
以前我们可以使用touch来创建,但是这样创建的没有格式,所以推荐使用pod init 或 pod vim(直接在终端进行编译操作)
终端输入:
$pod init

podfile文件创建
2.搜索版本号

当我们要使用某一个第三方库的时候,建议先搜索一下,查看版本号,和如何导入
终端输入:$pod search 第三方库名称

pod 搜索结果

输入"q"退出

3.编辑podfile文件

使用Xcode打开编辑,这里不建议使用文本编辑器,因为有时使用文本编辑器打开编辑或出现莫名其妙的错误。

输入要导入的第三方库和版本号(不填写版本号,默认导入最新的版本,建议填写防止以后三方库API替换)

pod 'AFNetworking', '~>3.1.0' 或 pod 'AFNetworking'

"#" 为注释
platform :ios, '9.0' 这里是支持的最低版本,建议与工程支持的最低版本一致
use_frameworks! 这行是确定pod安装完成后第三方是.a还是.framework,如果是.a的话在Swift中是不好引入的,所以建议要有这行代码

# Uncomment the next line to define a global platform for your project
platform :ios, '9.0' 

target 'ZhongJingUser' do
  # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
  use_frameworks!

  # Pods for ZhongJingUser
#要导入的第三方库
pod 'AFNetworking', '~>3.1.0'

end
4.安装pod

输入完成后关闭,终端输入$ pod install
就会自动安装了

完成后工程目录

注意:完成后再打开项目的时候就要使用 白色的 工程名.xcworkspace来打开了 而不是 蓝色的 工程名.xcodeproj

补充:当我们要安装或更新podfile文件时建议用下面的命令,这样不会去影响以前的第三方库,从而提高执行效率

$ pod install --verbose --no-repo-update
$ pod update --verbose --no-repo-update

pod.lock文件是第一次pod就会自动生成的文件,描述当前导入的框架版本

2018年3月22日--记一次pod search失效解决办法

今天安装完pod之后,进行pod search的测试,结果一直报

Unable to find a pod with name, author, summary, or description matching 'AFNetwoking'

查找发现一般,我们在安装CocoaPods时会默认执行一下pod setup,但是这个会有可能出现安装失败,这就导致了pod search的失效。
解决办法
1.我们自己在手动执行一下 pod setup 命令
2.删除~/Library/Caches/CocoaPods目录下的search_index.json文件。
终端执行 rm ~/Library/Caches/CocoaPods目录下的search_index.json
然后再去执行pod search命令,这样会触发CocoaPods去寻找这个索引文件

相关文章

网友评论

    本文标题:Cocoapods安装、使用

    本文链接:https://www.haomeiwen.com/subject/xdlmqxtx.html