美文网首页ios学习积累
Cocoapods的安装和使用

Cocoapods的安装和使用

作者: MorpLCP | 来源:发表于2016-01-08 10:36 被阅读1750次

    一、什么是CocoaPods

    在iOS应用开发过程中,有很多地方需要借助第三方代码,来提高我们的开发效率。但是,一个程序中我们可能会用到许多的第三方,这些第三方的编写方式有很多区别,比如有的是使用MRC编写的,但是我们的项目可能是ARC环境编写的,如何正确的配置各种各样的第三方呢?使用CocoaPods来替我们管理。是我们的最佳选择。
    CocoaPods是OS X以及iOS下的第三方管理工具,CocoaPods可以为我们的程序添加一个“Pods”的依赖库,并且可以为我们对这些第三方类库做各种各样的配置,比如ARC环境下使用MRC环境编写的第三方类库的时候,它就会为我们配置-fno-objc-arc,它所管理的第三方类库,必须是要符合它的一种“标准”的,并不是随便一个类库都能在其中管理,这样就保证了第三方类库的质量。

    二、CocoaPods的运行原理

    CocoaPods的源码在github上,项目中有一个列表,列表内存放着所有符合CocoaPods标准的第三方类库的信息,包括类库名、版本信息、在github上的地址等。我们在本地安装好CocoaPods之后,使用pod init
    命令,就是在本地项目中添加一个Podfile文件,该文件中列出了我们需要被管理的第三方的信息,当我们使用pod install
    命令的时候就会向CocoaPods发送一个命令,CocoaPods会在本地生成一个Pods依赖库,这个库中就有我们需要的第三方类库。

    三、Mac系统下安装CocoaPods

    安装CocoaPods需要ruby运行环境,Mac系统中已经为我们集成了ruby运行环境,我们使用ruby的gem命令,就可以轻松安装。在此之前我们先检查一下我们的ruby和gem是不是太老,否则会有问题。

    1、检查ruby的版本

    // 终端输入
    ruby -v
    // 如果出现类似如下的信息则表示系统安装了最新的版本
    ruby 2.0.0p481 (2014-05-08 revision 45883) [universal.x86_64-darwin14]
    

    2、查看gem版本

    gem -v
    

    3、更新ruby环境

    检查完后,如果你的gem太老,可以使用gem的更新命令进行升级

    // 终端输入
    sudo gem update -system 
    // 注意这里要加sudo不然会提示没有权限操作
    // 终端提示输入密码,有时候可能你输入密码,终端看上去没有反应,不用管直接输入完密码回车即可
    

    4、更换软件源

    因为默认的官方的安装源https://rubygem.org/ 使用的是亚马逊的云服务,被“墙”了,所以需要更换其他的软件源,下面是淘宝提供的安装源https://ruby.taobao.org/

    // 移除默认的安装源 终端输入
    gem sources --remove https://rubygems.org/
    // 终端显示:https://rubygems.org/ removed from sources
    // 添加淘宝源gem sources --add https://ruby.taobao.org/
    // 终端显示:https://ruby.taobao.org/ added to sources
    // 查看一下更换结果
    // 终端输入
    gem sources -l
    // 终端显示:
    *** CURRENT SOURCES ***https://ruby.taobao.org/
    

    5、开始安装cocoaPods

    // 终端输入:
    sudo gem install cocoapods   
    // 注意 前面一定要加sudo
    

    终端提示输入系统密码,输入密码回车后会输出一大串信息,出现类似21 gem install
    ,表示安装完毕:(这里可能会花一点时间,这是因为CocoaPods正在下载一些信息到你的项目中),如果你嫌慢,可以使用国内服务器上的CocoaPods索引库的镜像来更新索引。以下是使用oschina上的镜像,当然你也可以使用其他的镜像。

    // 终端输入
    pod repo remove master 
    // 移除原来的版本控制
    pod repo add master http://git.oschina.net/akuandev/Specs.git 
    // 添加新的版本控制pod repo update 
    // 更新
    

    6、使用CocoaPods来简化我们的开发吧

    Podfile 文件是用来用来声明项目代码相关性的,我们要在这个文件中写入我们需要添加管理的第三方类库。
    在终端中用cd命令进入你的项目.xcodeproj文件所在的目录,通过以下命令来创建一个Podfile文件

    cd "项目路径"
    pod init
    

    你生成的Podfile文件中可能包含如下信息

    platform :ios, '9.0' target "你的项目名" 
    do end 
    

    编辑Podfile文件,这里可以用vim编辑,也可以用文本编辑工具打开Podfile文件进行编辑,将需要的第三方的名字以及版本信息加入文件. (注:以下内容不是终端中输入的代码,是要写在Podfile文件里面的)

    pod "AFNetworking", "~> 2.0"
    pod 'SDWebImage', '~>3.7'
    

    接下来,通过以下代码就可以轻松安装第三方了

    // 终端输入
    pod install
    // 等待安装完成
    Updating local specs repositories
    Analyzing dependencies
    Downloading dependencies
    Installing AFNetworking (2.6.1)
    Installing SDWebImage (3.7.3)
    Generating Pods project
    Integrating client project
    [!] Please close any current Xcode sessions and use `AVPlayerTest.xcworkspace` for this project from now on.
    Sending stats
    Pod installation complete! There are 2 dependencies from the Podfile and 2 total
    pods installed.
    

    到此CocoaPods就安装完成了。需要注意的是:1、打开你的项目,你会发现多处许多文件,下次打开项目时,需要打开.xcworkspace文件才可以使用刚添加的Pods依赖库里面的第三方类库。而不是以前的.xcodeproj文件。2、当你想添加新的第三方的时候,只需要在Podfile文件里面写入,然后执行一次pod update
    命令。3、如果你想卸载不需要的第三方,直接在Podfile文件里面删除那个第三方的信息,然后执行一次pod update
    即可。

    7、Podfile.lock

    安装过程中,CocoPods会使用递归来分析所有的需求,并且建立一个代码相关性的图,最后将Podfile序列化为Podfile.lock比如,如果两个库都需要使用AFNetworking,CocoaPods会确定一个同时能被这两库使用的版本,然后将同一个安装版本链接到两个不同的库中。

    8、pod try

    如果你在安装一个第三方库之前,想要先试用一下,就可以使用try命令。只需要在try的后面加上你想试用的第三方的名称即可

    pod try AFNetworking
    

    四、其他问题

    1、CocodaPods遵循语义化版本规范,有时候,我们需要的第三方可能不在CocoaPods公共git仓库中,此时,你可以使用其它的Git或者SVN仓库取代,并可以指定具体的commit、branch或tag2、在安装过程中,可能会有如下错误:

    这是因为Xcode未安装或者未启用command line developer tools只需在Xcode中安装或启用一下即可:打开Xcode,commend+,打开偏好设置,选择启用Command Line Tools版本

    相关文章

      网友评论

        本文标题:Cocoapods的安装和使用

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