IOS-CocoaPods

Posted 2020-06-18 IOS_Bowen

 

一、概要

ios开发时，项目中会引用许多第三方库，CocoaPods（https://github.com/CocoaPods/CocoaPods）

可以用来方便的统一管理这些第三方库。

 

二、安装

由于网上的教程基本都大同小异，但细节之处还不是很完善，所以借机会在这里补充下：

注：要使用CocoaPods，那就要下载安装它，而下载安装CocoaPods需要Ruby环境

 

1、Ruby环境搭建

Mac  OS本身自带Ruby，但还是更新一下保险.

a查看下当前ruby版本：打开终端输入 ruby -v（确实安装了，不过用这个版本接下来工作失败了，所以更新下ruby）

 

// ruby -v 终端显示结果

ruby 2.0.0p645 (2015-04-13 revision 50299) [universal.x86_64-darwin15]

 

 

b更新ruby

终端输入如下命令（把Ruby镜像指向taobao，避免被墙，你懂得）

gem sources --remove https://rubygems.org/

gem sources -a https://ruby.taobao.org/

gem sources -l （用来检查使用替换镜像位置成功）

 

2、下载安装CocoaPods

终端输入：sudo gem install cocoapods

 

最终出现: 8 gem installed (数字8只是我的运行结果,只要看到gem installed就可以了)

这样就下载安装好了CocoaPods

          

3、使用CocoaPods

a 新建一个项目，名字PodTest

 

b 终端中，cd到项目总目录（注意：包含PodTest文件夹、PodTest.xcodeproj、PodTestTest的那个总目录）

 cd /Users/mac/Desktop/podTest

 

c搜索想要使用第三方,查询版本号

终端输入如下命令

pod search MBProgressHUD

 

得到如下版本号

/**

 * -> MBProgressHUD (0.9.1)

 * -> MBProgressHUD+BWMExtension (1.0.0)

 * -> MBProgressHUDExtensions (0.0.1)

 * -> [email protected] (0.3)

 */

 

d 建立Podfile（配置文件）

接着上一步，终端输入 vim Podfile

 

键盘输入 i，进入编辑模式，输入

platform :ios, ‘9.2‘// platform平台, ‘9.2‘当前版本在这里可以只写platform:ios

pod ‘MBProgressHUD‘, ‘~> 0.9.1‘// ‘MBProgressHUD‘第三方名称, ‘~> 0.9.1‘当前版本号

pod ‘JSONKit‘, ‘~> 1.5‘

...//如果需要依赖多个库以上面的格式，将依赖的库名字依次列在文件中即可

 

然后按Esc，并且输入“：”号进入vim命令模式，然后在冒号后边输入wq

注意："键盘输入：后，才能输入wq。回车后发现PodTest项目总目录中多一个Podfile文件"

 

e 执行"pod install (如果终端出现updating local specs repositories,那么请用ctrl+c强制结束命令进程,然后执行 pod install --verbose --no-repo-update 或者 pod install --no-repo-update"

#pragma mark - 注意如果在pod install之后出现Creating shallow clone of spec repo `master-1` from `https://github.com/CocoaPods/Specs.git`卡死情况,就在执行pod install之前执行pod setup

 

 

f 现在，你的所有第三方库都已经下载完成并且设置好了编译参数和依赖，你只需要记住如下 2点即可：

使用 CocoaPods生成的 .xcworkspace文件来打开工程，而不是以前的 .xcodeproj 文件。

每次更改了 Podfile文件，你需要重新执行一次"pod update命令。(如果终端出现updating local specs repositories,那么请用ctrl+c强制结束命令进程,然后执行pod update --verbose --no-repo-update或者pod update --no-repo-update"

 

 

"pod setup时报错解决办法"

出错：pod setup的时候报错， argumenterror , syntax error on line 4, col 0: `min:0.29.0`

 

解决方法如下：

 

1.命令行运行

# -rf ~/.cocoapods/repos

# pod setup（这个我还是没成功，报错ruby里什么找不到文件，于是我更新ruby，如果你成功了，就不用了）

 

2.更新ruby

xcode->preference->download里安装Command Line Tools

 

安装rvm：命令行里运行

$ curl -L get.rvm.io | bash -s stable

 

等待，运行

$ source ~/.bashrc

$ source ~/.bash_profile

 

查看安装

$ rvm -v

 

升级ruby：

$ rvm install ruby 2.1.1

ruby升级好了，查看版本 $ ruby -v

 

3.我ruby安装又失败了，于是谷歌

Error running ‘requirements_osx_port_update_system ruby-2.1.1‘,

根据一篇文章，我又继续了，命令行里

$ sudo port -v selfupdate

结果有出错了，$ sudo:port:command not faund

于是一番搜索，

$ export PATH=$PATH:/opt/local/bin

$ source .profile

升级macports

$sudo port -v selfupdate

终于可以升级ruby了，

$ rvm install 2.1.1

成功，于是，下一步

$ sudo gem install cocoapods

成功

 

4.重新运行

 

$  pod setup

成功