美文网首页iOS
CocoaPods的安装和使用教程

CocoaPods的安装和使用教程

作者: 触摸丨阳光 | 来源:发表于2016-12-09 17:44 被阅读0次

    CocoaPods简介

    每种语言发展到一个阶段,就会出现相应的依赖管理工具,例如Java语言的Maven,node.js的npm。随着iOS开发者的增多,业界也出现了为iOS程序提供依赖管理的工具,它的名字叫做:CocoaPods。
    CocoaPods项目的源码在Github上管理。该项目开始于2011年8月12日,经过多年发展,现在已经成为iOS开发事实上的依赖管理标准工具。开发iOS项目不可避免地要使用第三方开源库,CocoaPods的出现使得我们可以节省设置和更新第三方开源库的时间。

    在没有使用CocoaPods以前,我需要:
    把这些第三方开源库的源代码文件复制到项目中,或者设置成git的submodule。
    对于这些开源库通常需要依赖系统的一些framework,我需要手工地将这些framework一一增加到项目依赖中,比如通常情况下,一个网络库就需要增加以下framework: CFNetwork, SystemConfiguration, MobileCoreServices, CoreGraphics, zlib。
    对于某些开源库,我还需要设置-licucore或者 -fno-objc-arc等编译参数管理这些依赖包的更新。

    这些体力活虽然简单,但毫无技术含量并且浪费时间。

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

    一、CocoaPods 的安装

    CocoaPods是用Ruby实现的,要想使用它首先需要有Ruby的环境。幸运的是macOS系统默认的已经可以运行Ruby了,因此我们只需要执行以下命令。

    • 更换 Gem 的源

    Gem是一个管理Ruby库和程序的标准包,它通过Ruby Gem(如 http://rubygems.org/ )源来查找、安装、升级和卸载软件包

    // 移除掉原有的源(服务器在国外,速度较慢)
    gem sources --remove https://rubygems.org
    // 等有反应之后再敲入以下命令(添加国内的源https://gems.ruby-china.com/)
    gem sources -a https://gems.ruby-china.com
    // 验证是否替换成功
    gem sources -l
    
    • 更新升级 Gem 版本

    Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决方案自然是升级Gem,执行下述命令即可:

    // 更新升级gem
    sudo gem update --system
    //查看gem版本
    gem -v
    
    • 安装CocoaPods

    // 安装CocoaPods(OS X 10.11以前)
    sudo gem install cocoapods
    // 安装CocoaPods(10.11后苹果升级了安全策略)
    sudo gem install -n /usr/local/bin cocoapods
    
    • 配置CocoaPods

    所有的项目的podspec文件都托管在https://github.com/CocoaPods/Specs。 第一次执行pod setup时,CocoaPods 会将这些podspec索引文件更新到本地的 ~/.cocoapods/目录下,这个索引文件比较大,有 250M 左右。所以第一次更新时非常慢,一定要耐心的等。这步其实是 Cocoapods 在将它的信息下载到 ~/.cocoapods目录下,如果你等太久,可以试着新建一个终端 cd 到 ~/.cocoapods目录下,用du -sh *来查看下载进度。

    //将CocoaPods 的信息下载到 ~/.cocoapods目录下(Setting up CocoaPods master repo 会卡在这里很久)
    pod setup
    //cd 到 ~/.cocoapods目录下
    cd ~/.cocoapods 
    //查看下载进度
    du -sh *
    

    二、CocoaPods 的使用

    使用时需要在你的项目根目录下新建一个名为Podfile的文件,将依赖的库名字依次列在文件中即可

    • 进入工程文件夹

    以TestCocoaPod项目为例子

    //进入TestCocoaPods工程文件夹 
    cd /Users/iCoder/Desktop/TestCocoaPods
    
    AAEC76BC-A3FA-4A18-BB63-E2D083BA8E5E.png
    • 创建编辑一个Podfile文件

    输入命令vim Podfile,要导入的第三方都要在这里面写上。进去后需要先按I键进入编辑状态,写完后按esc,然后按:wq就可以保存退出了

    //输入命令vim Podfile 接着按一下I进入编辑模式
    vim Podfile
    
    F8F5E2ED-CAC5-47F8-9EEC-17520461CDB6.png

    例如我们要导入AFNetworking,Podfile的格式如下

    //ios小写 TestCocoaPods是你的工程名字 
    platform :ios,'8.0'
    target 'TestCocoaPods' do
    pod 'AFNetworking'
    end
    
    1BC72785-8334-42F1-A454-8C6B126D8863.png
    //按下esc,再输入:wq保存退出
    :wq
    
    2D4CBD30-2493-48FC-B534-1D97E2B5ED26.png
    • 执行安装命令

    //执行pod install
    pod install
    
    20E1E3EF-C68D-47DB-8040-C184E703FC33.png
    • 打开项目

    之前我们一直是双击TestCocoaPods.xcodeproj打开项目,以后我们双击TestCocoaPods.xcworkspace打开即可


    23E63860-8822-4E54-8021-3D171D860063.png
    • 使用第三方

    引入AFNetworking的头文件时,使用#import <AFNetworking.h>引入,使用#import "AFNetworking.h"不再有提示


    BD14176A-DC7A-4FD6-BF5F-591927A5AC80.png
    • 添加或删除第三方

    如果使用过程中我还想添加/删除其他的第三方怎么办,只要在Podfile里面添加/删除,然后终端再执行pod install就可以了
    例如我要将AFNetworking删除,添加pop库
    打开工程,找到Podfile文件,删除pod 'AFNetworking',添加pod 'pop'


    09353315-B7D6-46FC-A67C-66A11E364F3F.png

    打开终端,cd到工程目录,执行pod install

    //进入工程目录
    cd /Users/iCoder/Desktop/TestCocoaPods
    //导入
    pod install
    
    E21170E4-820B-4093-92E0-4C4490681468.png

    三、常见问题

    • pod install,pod update速度慢

    出现原因:你本地的repo库太长时间没有更新了
    解决办法:

    pod repo update
    

    原因在于当执行以上两个命令的时候会升级CocoaPods的specs仓库,如果不想在install、update的时候升级specs库,可以使用参数忽略掉

    pod install --no-repo-update
    pod update --no-repo-update
    
    • 导入Swift类库

    导入Swift语言编写的类库时需要加use_frameworks!,下面以导入Alamofire为例:

    platform :ios, '8.0'
    use_frameworks!
    pod 'Alamofire'
    

    四、参考资料

    相关文章

      网友评论

        本文标题:CocoaPods的安装和使用教程

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