Cocoapods安装、使用

作者: 遛遛食 | 来源:发表于2017-06-16 17:08 被阅读166次

    在iOS开发中,经常会使用到一些第三方库,例如AFNetwoking,MJRefresh等,如果我们都去手动导入的话,有时候还要进行配置非常麻烦,所以就是用Cocoapods让他来帮我们配置和管理第三方库。
    网上有很多关于Cocoapods的使用教程,而且写得非常详细,但是我写的这篇,主要就是告诉大家使用,和自己学习的一个总结。下面开始来介绍

    Cocoapods安装步骤:

    1.升级Ruby环境

    打开终端输入:$ gem update --system

    如果出现:ERROR: While executing gem ... (Gem::FilePermissionError)
    You don't have write permissions for the /Library/Ruby/ Gems/2.0.0 directory. 就更新Ruby

    强制更新

    $ sudo gem update —system

    2.更新Ruby源

    $ gem sources --add https://gems.ruby-china.org/ --remove https://rubygems.org/
    $ gem sources -l
    *** CURRENT SOURCES ***
    </br>
    https://gems.ruby-china.org
    # 请确保只有 gems.ruby-china.org
    $ gem install rails

    3.安装Cocoapods

    $ sudo gem install cocoapods
    这个时候会提示你输入密码,注:在终端输密码不会有提 ,光标也不会移动。
    第一次安装时间会比较长

    如果报以下错误:
    ERROR: While executing gem ... (Errno::EPERM)
    Operation not permitted - /usr/bin/xcodeproj
    解决办法:

    终端输入:$sudo gem install -n /usr/local/bin cocoapods
    pod setup

    cocoapods安装路径是在~/.cocoapods文件夹里如果安装失败建议把这个文件里面的东西全部删除,重新安装

    如果想查看下载进度的话,先到cocoapods文件夹下
    $cd ~/.cocoapods
    然后在终端输入:
    $du -sh *
    即可查看下载的文件大小。也就可以知道是网速不好,还是源不可用了。

    安装成功后,你会看到:Setup completed


    Cocoapods使用

    1.创建podfile文件

    使用时,先创建iOS工程,然后cd 到工程目录下,创建podfile文件
    以前我们可以使用touch来创建,但是这样创建的没有格式,所以推荐使用pod init 或 pod vim(直接在终端进行编译操作)
    终端输入:
    $pod init

    podfile文件创建
    2.搜索版本号

    当我们要使用某一个第三方库的时候,建议先搜索一下,查看版本号,和如何导入
    终端输入:$pod search 第三方库名称

    pod 搜索结果

    输入"q"退出

    3.编辑podfile文件

    使用Xcode打开编辑,这里不建议使用文本编辑器,因为有时使用文本编辑器打开编辑或出现莫名其妙的错误。

    输入要导入的第三方库和版本号(不填写版本号,默认导入最新的版本,建议填写防止以后三方库API替换)

    pod 'AFNetworking', '~>3.1.0' 或 pod 'AFNetworking'

    "#" 为注释
    platform :ios, '9.0' 这里是支持的最低版本,建议与工程支持的最低版本一致
    use_frameworks! 这行是确定pod安装完成后第三方是.a还是.framework,如果是.a的话在Swift中是不好引入的,所以建议要有这行代码

    # Uncomment the next line to define a global platform for your project
    platform :ios, '9.0' 
    
    target 'ZhongJingUser' do
      # Uncomment the next line if you're using Swift or would like to use dynamic frameworks
      use_frameworks!
    
      # Pods for ZhongJingUser
    #要导入的第三方库
    pod 'AFNetworking', '~>3.1.0'
    
    end
    
    4.安装pod

    输入完成后关闭,终端输入$ pod install
    就会自动安装了

    完成后工程目录

    注意:完成后再打开项目的时候就要使用 白色的 工程名.xcworkspace来打开了 而不是 蓝色的 工程名.xcodeproj

    补充:当我们要安装或更新podfile文件时建议用下面的命令,这样不会去影响以前的第三方库,从而提高执行效率

    $ pod install --verbose --no-repo-update
    $ pod update --verbose --no-repo-update

    pod.lock文件是第一次pod就会自动生成的文件,描述当前导入的框架版本

    2018年3月22日--记一次pod search失效解决办法

    今天安装完pod之后,进行pod search的测试,结果一直报

    Unable to find a pod with name, author, summary, or description matching 'AFNetwoking'

    查找发现一般,我们在安装CocoaPods时会默认执行一下pod setup,但是这个会有可能出现安装失败,这就导致了pod search的失效。
    解决办法
    1.我们自己在手动执行一下 pod setup 命令
    2.删除~/Library/Caches/CocoaPods目录下的search_index.json文件。
    终端执行 rm ~/Library/Caches/CocoaPods目录下的search_index.json
    然后再去执行pod search命令,这样会触发CocoaPods去寻找这个索引文件

    相关文章

      网友评论

        本文标题:Cocoapods安装、使用

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