龙经理
黄经理

CocoaPods安装、使用及常见问题解决

一、简介

CocoaPods官网

https://guides.cocoapods.org


什么是CocoaPods?

CocoaPods是OS X和iOS下的一个第三方开源类库管理工具,通过CocoaPods工具我们可以为项目添加被称 为“Pods”的依赖库(这些类库必须是CocoaPods本身所支持的),并且可以轻松管理其版本。


CocoaPods项目的源码 在 Github 上管理。该项目开始于 2011 年 8 月 12 日,经过多年发展,现在已经成为 iOS 开发事实上的依赖管理标准工具。


CocoaPods出现的背景

开发 iOS 项目不可避免地要使用第三方开源库,在使用CocoaPods之前,开发项目需要用到第三方开源库的时候,我们需要


1、把开源库的源代码复制到项目中。


2、添加一些依赖框架和动态库。


3、设置-ObjC,-fno-objc-arc等参数。


4、管理他们的更新


在使用CocoaPods后,我们只需要把用到的开源库放到一个名为Podfile的文件中,然后执行pod install就可以了,Cocoapods就会自动将这些第三方开源库的源码下载下来,并且为我们的工程设置好响应的系统依赖和编译参数。


使用CocoaPods的好处

1、在引入第三方库时它可以自动为我们完成各种各样的配置,包括配置编译阶段、连接器选项、甚至是ARC环境下的-fno-objc-arc配置等。


2、使用CocoaPods可以很方便地查找新的第三方库,这些类库是比较“标准的”,而不是网上随便找到的,这样可以让我们找到真正好用的类库。


CocoaPods的原理

CocoaPods的原理是将所有的依赖库都放到另一个名为Pods的项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中。Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。


二、安装

1、安装ruby环境

以下是安装ruby的方法:

1)、通过Ruby源代码安装

1>、从ruby官网上下载ruby源码, https://www.ruby-lang.org/en/downloads/ , 解压

2>、cd 到解压目录下,执行

$ ./configure



3>、执行


$ make




4>、 执行

$ make install


5>、 执行

$ buby -v

2)、通过rvm升级Ruby(推荐)

1>、安装rvm

RVM:Ruby Version Manager, Ruby版本管理器,包括Ruby的版本管理和Gem库管理(gemset)


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



2>、加载文件,测试是否安装正常(按照提示操作)

$ source ~/.bashrc


$ source ~/.bash_profile


$ source ~/.profile


$ rvm -v



3>、获取rvm列表


$ rvm list known




4>、安装ruby2.4


$ rvm install 2.4




安装过程中可能遇到如下错误:

Error running 'requirements_osx_port_libs_install curl-ca-bundle automake libtool libyaml libffi libksba',showing last 15 lines of /Users/acewill/.rvm/log/1468253599_ruby-2.3.0/package_install_curl-ca-bundle_automake_libtool_libyaml_libffi_libksba.log


原因是需要安装Homebrew, 参照stack overflow上的问题Installing RVM: “Requirements installation failed with status: 1.”

安装Homebrew, 通过以下命令:


$ ruby -e "$(curl -fsSL hhtps://raw.githubusercontent.com/Homebrew/install/master/install)"


安装完Homebrew,重新安装ruby


$ rvm install 2.4


2、设置ruby的软件源

$ gem sources -l #(查看当前ruby的源)


$ gem sources --removehttps://rubygems.org/ #(移除当前ruby的源)


$ gem sources -ahttps://gems.ruby-china.org/ #(设置当前ruby的源,淘宝镜像已经不能用了,可以用https://gems.ruby-china.org)


$ gem sources -l #(再次查看当前ruby的源)


如果Terminal输出:


*** CURRENT SOURCES ***


https://gems.ruby-china.org/

表示切换成功


3、设置gem为最新版本

如果gem太老,可以尝试用如下命令升级gem:


$ gem update --system


升级成功后会提示: Latest version currently installed. Aborting.


如果出现

ERROR: While executing gem ... (OpenSSL::SSL::SSLError)

hostname "upyun.gems.ruby-china.org" does not match the server certificate

原因是之前用的ruby镜像源是淘宝的,需要切换成https://gems.ruby-china.org/,在终端输入


$ gem sources —remove https://ruby.taobao.org/


$ gem sources -a https://gems.ruby-china.org/


4 、安装CocoaPods

第一种方法:git clone 方法安装cocoaPods

$ cd ~/.cocoapods/repos


克隆一个Specs库


$ git clone https://github.com/CocoaPods/Specs


完成后,执行open . 打开当前目录repos


$ open .


然后把Specs目录改名为master即可


如果gitclone还慢的话,直接上https://github.com/CocoaPods/Specs 点击下载,根据上面的目录结构图,放对了就好



然后再执行pod search 第三方框架


$ pod search AFNetworking


看到下面信息说明成功了.



按wq退出


如果出现 [!] Unable to find a pod with name, author, summary, or description matching `AFNetworking`

执行下面操作,删除索引


$ rm ~/Library/Caches/CocoaPods/search_index.json


然后重新执行


$ pod search AFNetworking


第二种方法:用gem命令安装(不推荐,比较慢,建议用第一种方法)

$ sudo gem install cocoa pods


备注:苹果系统升级 OS X EL Capitan 后改为:


$ sudo gem install -n /usr/local/bin cocoapods



$ pod setup



会输出Setting up CocoaPods master repo,但是会等待比较久的时间。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下,如果你等太久,可以试着 cd 到那个目录,用du -sh *来查看下载进度。你也可以参考本文接下来的使用 cocoapods 的镜像索引一节的内容来提高下载速度。


三、使用


1、新建工程,并cd到工程目录



2、新建Podfile文件


$ vim Podfile



3、按i(英文输入状态下)进入编辑状态



4、输入相应的第三方和版本,比如




5、编辑好,先按esc,再输入:wq(英文输入状态下)保存退出



6、导入第三方库


$ pod install


成功后,会在目录下生成一个跟工程名一样但是后缀为.xcworkspace的文件和一个Pods文件夹




7、需要打开后缀为.xcworkspace的工程文件,以后编码也是在此文件中进行操作

工程目录结构如下




8、使用第三方库




执行以下操作






至此,在工程中用CocoaPods导入第三方库已成功完成,接下来就可以继续愉快地撸代码了。如果后期需要再添加其他第三方库或者更新当前第三方库,则重复步骤2-6即可!


google play,苹果应用商店头条 更多资讯>>>
谷歌paly上架步骤一 2022-05-26
谷歌google paly上架遇到的坑? 2022-05-24
谷歌海外上架要注意的问题 2022-05-17
iOS马甲包上架方法 2021-06-22
苹果马甲包上架指南 2021-06-22
ios上架技术之马甲包上架经验总结 2021-06-22
GooglePlay谷歌上架流程 2021-05-21
iOS证书(.p12)和描述文件(.mobileprovision)申请 2021-05-20
iOS 应用审核的通关秘籍 2021-05-20
安卓App上架指南 2021-05-15
google play,苹果市场成功案例 更多资讯>>>
在吗苹果上架成功,引爆市场 2022-05-27
我们努力的目标就是上架成功! 2022-05-26
一大波交友系统苹果上架成功案例,客户信任不负所托。 2022-05-24
上架成功是用户对我们的信用保障! 2022-05-24
我们成功的动力来源于客户百分百信任! 2022-05-24
谷歌成功上架,感谢客户的百分百信任 2022-05-24
又帮客户成功上架了一个APP 2022-05-23
为一个长久合作的客户成功上架谷歌应用市场 2022-05-20
又成功上架一个娱乐app,成功上去google paly应用市场 2022-05-20
感谢客户信任,谷歌成功上架+1 2022-05-20