美文网首页
CocoaPods安装方法及避坑全过程-2020.07.12

CocoaPods安装方法及避坑全过程-2020.07.12

作者: heller灬 | 来源:发表于2020-07-12 23:32 被阅读0次

    IOS开发装过很多次CocoaPod,中间遇到过各种烦人的问题,总结一下,供大家学习研究,以下过程经本人新机测试,一路畅通无任何错误,中间有网络不好的可能会下载中断出错,只要从新执行一下命令就行了。

    CocoaPods是什么?

    当你开发iOS应用时,会经常使用到很多第三方开源类库,比如JSONKit,AFNetWorking等等。可能某个类库又用到其他类库,所以要使用它,必须得另外下载其他类库,而其他类库又用到其他类库,“子子孙孙无穷尽也”,这也许是比较特殊的情况。总之小编的意思就是,手动一个个去下载所需类库十分麻烦。另外一种常见情况是,你项目中用到的类库有更新,你必须得重新下载新版本,重新加入到项目中,十分麻烦。如果能有什么工具能解决这些恼人的问题,那将“善莫大焉”。所以,你需要 CocoaPods。

    CocoaPods应该是iOS最常用最有名的类库管理工具了,上述两个烦人的问题,通过cocoaPods,只需要一行命令就可以完全解决,当然前提是你必须正确设置它。重要的是,绝大部分有名的开源类库,都支持CocoaPods。所以,作为iOS程序员的我们,掌握CocoaPods的使用是必不可少的基本技能了。

    CocoaPods安装前环境准备

    CocoaPods是一个用Ruby写的,需要在Ruby环境下执行,虽然Mac电脑自带Ruby环境,然而默认情况下我们mac系统自带的Ruby环境版本比较低(大概是2.0.0或者其他较高版本),但是现在安装CocoaPods需要2.2.2版本及以上的,所以我们检查Ruby版本进行升级ruby。

    打开终端:>_

    1、查看当前Ruby版本

    ruby -v
    

    2、升级Ruby环境,首先需要安装rvm(RVM 是一个命令行工具,可以提供一个便捷的多版本 Ruby 环境的管理和切换,具体详见:https://ruby-china.org/wiki/rvm-guide)

    gpg  --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E37D2BAF1CF37B13E2069D6956105BD0E739499BDB
    
    \curl -sSL https://get.rvm.io | bash -s stable
    source ~/.bashrc
    source ~/.bash_profile
    

    根据命令可看出,安装RVM,需要先安装GPG(GNU Privacy Guard【GnuPG或GPG】是一种加密软件),
    要安装GPG,又需要先安装brew(Homebrew是Mac OS 不可或缺的套件管理器。是一款Mac OS平台下的软件包管理工具,拥有安装、卸载、更新、查看、搜索等很多实用的功能。简单的一条指令,就可以实现包管理,而不用你关心各种依赖和文件路径的情况,十分方便快捷。)

    由此可见,先安装brew,再安装GPG,然后才安装RVM。
    (1)安装Homebrew

    -官网给出的安装方法:

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

    这种方法并不适用国内的Mac用户,因为网络资源的原因,电脑下载是龟速,实在是无法忍受
    为了解决下载慢,推荐替换镜像源,将下载资源改为国内镜像资源即可。
    步骤一: 获取install文件:

    curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install >> brew_install
    

    因为链接https://raw.githubusercontent.com/Homebrew/install/master/install我这里网络打不开,所以直接使用百度网盘下载到本地:(链接: https://pan.baidu.com/s/1KygTFr4y8LZ-3c49xr63bw 提取码: eu2m)
    步骤二:安装,运行brew_install

    /usr/bin/ruby  ~/brew_install
    
    出现了如下界面: image.png

    这个是因为源不通,代码无法下载到本地,解决方法是更换成国内中科院镜像源,执行如下命令安装brew:

    git clone git://mirrors.ustc.edu.cn/homebrew-core.git/  /usr/local/Homebrew/Library/Taps/homebrew/homebrew-core --depth=1
    

    继续执行以下命令安装brew cask:

    git clone git://mirrors.ustc.edu.cn/homebrew-cask.git/  /usr/local/Homebrew/Library/Taps/homebrew/homebrew-cask --depth=1
    

    步骤三:把Homebrew-core的镜像源设置为中科院的国内镜像

    cd "$(brew --repo)"
    git remote set-url origin https://mirrors.ustc.edu.cn/brew.git
    // 替换核心软件仓库
    cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
    git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
    //替换cask软件仓库
    cd "$(brew --repo)/Library/Taps/homebrew/homebrew-cask"
    git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
    //替换Bottle源--bash用户
    echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile
    source ~/.bash_profile
    //替换Bottle源--zsh用户(这个可选)
    echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.zshrc
    source ~/.zshrc
    

    步骤四:执行更新brew命令和检测命令

    brew update
    brew doctor
    

    步骤四:查看安装结果版本号

    brew -v
    
    结果如下界面: image.png
    (2)安装GPG
    brew install gpg
    
    (3)安装RVM

    本来是使用上面GPG安装rvm的命令即可,但是我这里还是无法访问https://get.rvm.io,所以采取离线安装的方式。

    步骤一:下载RVM
    上github下载rvm,https://github.com/rvm/rvm.git

    步骤二:双击打开下载下来文件夹中的/bin/rvm-installer

    image.png

    步骤三:配置到.bash_profile

    export PATH="/Users/ccy/.rvm/  bin:$PATH"
    

    注意:把命令中的ccy换成自己的用户
    步骤四:查看安装结果版本号

    rvm -v
    
    结果如下界面: image.png
    (4)升级Ruby

    步骤一:切换Ruby镜像源

    //查看gem源
    gem sources -l
    #删除默认的gem源或者之前的tabao源,添加rubyChina作为gem源
    gem sources  --add https://gems.ruby-china.org/  --remove https://rubygems.org/
    //查看当前gem源
    gem sources -l
    //清空源缓存
    gem sources -c
    //更新源缓存
    gem sources -u
    

    查看当前gem源显示如下页面:

    image.png
    注:国内的淘宝镜像源已经不更新维护,要使用rubyChina镜像源才行
    步骤二:列出ruby可安装的版本信息
    rvm list known
    

    显示如下:

    image.png
    步骤三:安装一个ruby版本 安装ruby时,最好安装最新的正式版,即2.7.1
    rvm install  2.7.1
    

    步骤四:设置为默认版本

    rvm use 2.7.1 --default
    

    步骤五:查看已安装的ruby版本

    rvm list
    
    显示如下界面: image.png

    至此,ruby环境已经升级成功。

    CocoaPods安装

    (1)执行安装命令
    sudo gem install -n /usr/local/bin cocoapods
    
    (2)如果安装了多个Xcode使用下面的命令选择(一般需要选择最近的Xcode版本)
    sudo xcode -select -switch  /Applications/Xcode.app/Contents/Developer
    

    注:执行前先安装Xcode命令行工具

    (3)安装本地库
    pod setup
    
    最新版的MacOS Catalina系统命令行执行pod setup命令,直接结束啦!

    我们手动安装:
    执行命令1:

    git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/trunk
    

    或者命令2:

    git clone https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git  ~/.cocoapods/repos/trunk
    
    (4)安装完成之后可执行下列命令检查是否可用(第一次使用可能要等一会)
    pod search AFNetworking
    
    (5)使用CocoaPods

    步骤一:新建一个Xcode工程,使用终端cd到工程目录下,创建Podfile文件:

    pod init
    

    步骤二:打开Podfile文件,编辑添加:pod 'AFNetworking',保存后退出。

    open Podfile
    

    步骤三:下载AFNetworking使用

    pod install
    

    到此! 成功安装使用了CocoaPods!

    如有问题可以先自行检索错误原因及解决办法

    相关文章

      网友评论

          本文标题:CocoaPods安装方法及避坑全过程-2020.07.12

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