cocoapods的安装和使用总结

偏执的太偏执、 2022-09-24 04:20 322阅读 0赞

一、CocoaPods 是什么? CocoaPods 是开发 OS X 和 iOS 应用程序的一个第三方库的依赖管理工具。利用CocoaPods,可以定义自己的依赖关系 (称作 pods),并且随着时间的变化,以及在整个开发环境中对第三方库的版本管理非常方便。

CocoaPods 背后的理念主要体现在两个方面。首先,在工程中引入第三方代码会涉及到许多内容。针对 Objective-C 初级开发者来说,工程文件的配置会让人很沮丧。在配置buildphases和linker flags过程中,会引起许多人为因素的错误。CocoaPods 简化了这一切,它能够自动配置编译选项。

其次,通过 CocoaPods,可以很方便的查找到新的第三方库。当然,这并不是说你可以简单的将别人提供的库拿来拼凑成一个应用程序。它的真正作用是让你能够找到真正好用的库,以此来缩短我们的开发周期和提升软件的质量。

CocoaPods的原理,它是将所有的依赖库都放到另一个名为Pods项目中,然后让主项目依赖Pods项目,这样,源码管理工作都从主项目移到了Pods项目中：

1、Pods项目最终会编译成一个名为libPods.a的文件,主项目只需要依赖这个.a文件即可。2、对于资源文件,CocoaPods提供了一个名为Pods-resources.sh的bash脚本,该脚本在每次项目编译的时候都会执行,将第三方库的各种资源文件复制到目标目录中。3、CocoaPods通过一个名为Pods.xcconfig的文件来在编译时设置所有的依赖和参数。

二、CocoaPods的安装：[https://guides.cocoapods.org/using/getting-started.html\#getting-started][https_guides.cocoapods.org_using_getting-started.html_getting-started]

1.先升级Gem(可以省略)
 sudo gem update --system
 
 2.切换cocoapods的数据源
 【先删除，再添加，查看】
 gem sources --remove https://rubygems.org/
 gem sources -a https://ruby.taobao.org/
 gem sources -l
 
 3.安装cocoapods
 sudo gem install cocoapods
 或者（如10.11系统）sudo gem install -n /usr/local/bin cocoapods
 
 4.设置pod仓库
 pod setup
 
 5.测试
 【如果有版本号，则说明已经安装成功】
 pod --version
 
 6.利用cocoapods来安装第三方框架
 01 进入要安装框架的项目的.xcodeproj同级文件夹（cd 拖入目录路径）
 02 在该文件夹中新建一个文件podfile （touch Podfile）
 03 在文件中告诉cocoapods需要安装的框架信息（最好用Xcode打开）
 a.该框架支持的平台
 b.适用的iOS版本
 c.框架的名称
 d.框架的版本
 
 7.安装
 pod install --no-repo-update
 pod update --no-repo-update
 
 8.说明
 platform :ios, '7.0' 用来设置所有第三方库所支持的iOS最低版本
 pod 'SDWebImage','~>3.7.5' 设置框架的名称和版本号
 版本号的规则：
 '>1.0' 可以安装任何高于1.0的版本
 '>=1.0' 可以安装任何高于或等于1.0的版本
 '<1.0' 任何低于1.0的版本
 '<=1.0' 任何低于或等于1.0的版本
 '~>0.1' 任何高于或等于0.1的版本，但是不包含高于1.0的版本
 '~>0' 任何版本，相当于不指定版本，默认采用最新版本号
 
 9.使用pod install命令安装框架后的大致过程：
 01 分析依赖:该步骤会分析Podfile,查看不同类库之间的依赖情况。如果有多个类库依赖于同一个类库，但是依赖于不同的版本，那么cocoaPods会自动设置一个兼容的版本。
 02 下载依赖:根据分析依赖的结果，下载指定版本的类库到本地项目中。
 03 生成Pods项目：创建一个Pods项目专门用来编译和管理第三方框架，CocoaPods会将所需的框架，库等内容添加到项目中，并且进行相应的配置。
 04 整合Pods项目：将Pods和项目整合到一个工作空间中，并且设置文件链接。

10.测试

pod --version

11.卸载CocoaPods

sudo gem uninstall cocoa pods

注意:

》如果gem太老可能会有问题,所以安装之前最好升级一下gemsudo gem update --system

》ruby的软件源rubygems.org使用的亚马逊的云服务被墙了,所以需要更新一下ruby的源,如下代码将官方的ruby源替换成国内淘宝的源

gem sources --remove https://rubygems.org/gem sources -a http://ruby.taobao.org/ gem sources -l

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

》使用**CocoaPods**的镜像索引所有的项目的Podspec文件都托管在https://github.com/CocoaPods/Specs。第一次执行pod setup时,CocoaPods会将这些podspec索引文件更新到本地的~/.cocoapods/目录下,这个索引文件比较大,有100M左右。所以第一次更新时非常慢。 为了提高下载速度, 可以将文件托管地址从github替换为国内oschina,这样会快很多。如下操作就可以将github替换为国内oschina pod repo remove master pod repo add master http://git.oschina.net/akuandev/Specs.git pod repo update

<table> 
 <tbody> 
 <tr> 
 <td>&nbsp;</td> 
 </tr> 
 <tr> 
 <td> 三、CocoaPods使用: 使用时需要新建一个名为Podfile的文件 &gt;1.利用vim创建Podfile。 注意:Podfile文件应该和你的工程文件.xcodeproj在同一个目录下 vim Podfile &gt;2.将依赖的库名字依次列在文件中 platform :ios pod 'JSONKit', '~&gt; 1.4' pod'Reachability', '~&gt;3.0.0' </td> 
 </tr> 
 <tr> 
 <td> pod'AFNetworking', '2.0.0'pod 'RegexKitLite'&gt;3.保存并退出 </td> 
 </tr> 
 </tbody> 
</table>

esc :wq

<table> 
 <tbody> 
 <tr> 
 <td> platform :ios pod 'JSONKit', '~&gt; 1.4'pod'Reachability', '~&gt;3.0.0' </td> 
 </tr> 
 <tr> 
 <td> pod'AFNetworking', '2.0.0'pod 'RegexKitLite'&gt;3.保存并退出按下esc,然后输入:wq&gt;4.利用CocoPods下载类库pod install 注意: 1.利用CocoPods管理类库后, 以后打开项目就用xxxx.xcworkspace 打开,而不是之前的.xcodeproj文件 2.每次更改了Podfile文件,你需要重新执行一次pod update命令。3.关于.gitignore 当你执行pod install之后,除了Podfile外,CocoaPods还会生成一个名为Podfile.lock的文件,你不应该把这个文件加入到.gitignore中。因为Podfile.lock会锁定当前各依赖库的版本,之后如果多次执行pod install 不会更改版本,要pod update才会改Podfile.lock了。这样多人协作的时候,可以防止第三方库升级时造成大家各自的第三方库版本不一致。 4. CocoaPods在执行pod install和pod update时,会默认先更新一次CocoPods的spec仓库索引。使用--no-repo-update参数可以禁止其做索引更新操作 pod install --no-repo-update pod update --no-repo-update 四、查找第三方库 你如果不知道cocoaPods管理的库中,是否有你想要的库,那么你可以通过&nbsp;pod search&nbsp;命令进行查找,例如我用 pod search json&nbsp;查找到的所有可用的库的命令:pod search AFNetworking &nbsp; &nbsp; &nbsp; &nbsp;注：如果使用Cocoapods 导入第三方的资源时，出现如下警告： Your Podfile has had smart quotes sanitised. To avoid issues in the future, you should not use TextEdit for editing it. If you are not using TextEdit, you should turn off smart quotes in your editor of choice. 即：不要使用文本编辑去编辑Podfile，使用Xcode编辑，或者使用终端敲命令去编辑。 解决办法： Using&nbsp;TextEdit&nbsp;will give you following,&nbsp; <pre><code>pod ‘Parse’, ‘~&gt; 1.7.1</code><code>’</code><code> //notice the quotes 注意 引号 ，</code><code>注意 引号 ，</code>注意 引号</pre> Use&nbsp;Xcode to open Podfile&nbsp;and you will get correct quotes as following, <pre><code>pod 'Parse', '~&gt; 1.7.1'	 </code><code>//notice the quotes 注意 引号 ，</code><code>注意 引号 ，</code>注意 引号</pre> Terminal Commands: <pre><code>$ touch Podfile //OR $ cd &lt;parentDirectory of Podfile&gt;
$ open -a Xcode Podfile</code></pre> </td> 
 </tr> 
 <tr> 
 <td>&nbsp;</td> 
 </tr> 
 </tbody> 
</table>

[https_guides.cocoapods.org_using_getting-started.html_getting-started]: https://guides.cocoapods.org/using/getting-started.html#getting-started