组件化第一篇:CocoaPods的安装

常用命令总结写在前面,具体分析往下看

--------------------安装RVM--------------------
# 安装rvm命令
curl -sSL https://get.rvm.io | bash -s stable
# 如果安装失败先执行下面的命令,再次执行上面的命令
sudo gem install redis
# 安装完毕后重启终端

# 查看rvm版本,同时验证是否安装成功
rvm -v
--------------------安装RVM--------------------

--------------------安装Ruby--------------------
# 查看当前默认的Ruby版本
ruby -v

# 查询所有【已安装】的Ruby版本
rvm list
# 获取所有可用于安装的 Ruby 版本
rvm list known

# 安装指定Ruby版本
rvm install ruby-2.6.6

# 切换Ruby版本
rvm use 2.6.6
# 设置默认Ruby版本
rvm use 2.6.6 --default

# 卸载已安装的Ruby版本
rvm remove 2.6.3
--------------------安装Ruby--------------------

--------------------升级gem---------------------
# 检查当前【已安装】的gem的版本  
gem -v
# 查看当前镜像源
gem sources -l
# 如果是https://rubygems.org/则需要替换镜像源
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

# 升级gem
sudo gem update -n /usr/local/bin --system
# 如果上面的命令不行就执行下面的
sudo gem update --system
--------------------升级gem---------------------

--------------------安装CocoaPods---------------------
# 检查pod版本
pod --version

# 搜索远程的CocoaPods库
gem search cocoapods
# 搜索本地的CocoaPods库
gem list

# 先删除cocoapods,再安装
# 备注:有时会报这个错误Gem 'cocoapods' is not installed,移除sudo再执行就好了
[sudo] gem uninstall cocoapods [-v 移除的版本号]

# 安装CocoaPods
[sudo] gem install cocoapods
# 如果使用这个报错,请使用
[sudo] gem install -n /usr/local/bin cocoapods [-v 要安装的版本号]

# 当多个pod版本存在时,使用指定版本
pod _1.5.3_ install
--------------------安装CocoaPods---------------------

--------------------初始化CocoaPods---------------------
# 查看本地三方框架仓库(repo)源,list可以省略
pod repo [list]
# 如果clone前提示.cocoapods不为空,则先移除原master仓库
pod repo remove master
# 把仓库克隆下来
git clone https://github.com/CocoaPods/Specs.git ~/.cocoapods/repos/master
# 之后再次更新CocoaPods仓库源使用下面的命令
pod repo update
--------------------初始化CocoaPods---------------------

--------------------Podfile文件---------------------
# 在文件内容的顶部添加这行代码,指定repo源
source 'https://github.com/CocoaPods/Specs.git'
--------------------Podfile文件---------------------

前言

  • 出于安全的考虑,苹果从Xcode 8开始禁用插件,原来那么多好用的插件都不能用了,其中也包括CocoaPods插件,无奈之下只得通过终端使用了
  • CocoaPods能让开发者非常方便的使用第三方类库,并且自动设置好相应的系统依赖和编译参数,所以学会使用CocoaPods是很有必要的

相关概念介绍

  • rvm、ruby、gem(对应RubyGems)、brew(对应Homebrew)的安装顺序
    • 首先安装rvm
    • 再安装一个Ruby版本,就可以提供一个完整的ruby运行环境
    • 安装完Ruby版本之后可以安装HomebrewRubyGems
    • 安装完RubyGems就可以使用gem安装CocoaPods
  • RVM
    • 全称:Ruby Version Manager,即Ruby版本管理工具
    • 是一个命令行工具,可以方便的管理和切换多个版本的Ruby环境
    • RVM有一个非常灵活的gem管理系统,称为gem setsgem sets管理横跨多个Ruby版本的gems包
    • RVM的安装见下文
    • 使用RVM安装Ruby见下文
  • RubyGems
    • 用于管理ruby应用,不同于Homebrew(用于操作系统层面上软件包的安装)
    • gem是一个管理Ruby库和程序的标准包(即:一个gem包对应一个Ruby应用程序的安装单元);
    • RubyGems是强大的Ruby程序包管理工具,可以通过RubyGems源来查找、安装、升级和卸载gem包;
    • 在最新的Ruby版本中已经包含RubyGems,无需单独安装
    • RubyGems的安装见下文
  • Homebrew
    • 用于操作系统层面上软件包的安装
    • 将软件包安装到单独的目录,然后将符号链接到/usr/local中,完全基于git和ruby
    • Homebrew的安装
    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    

安装RVM

  • 以下命令都是在用户权限下操作的,不要用sudo
  • 安装完记得重启终端
    # -sSL严格区分大小写
    \curl -sSL https://get.rvm.io | bash -s stable
    source ~/.bashrc
    source ~/.bash_profile
    
    // 查看rvm版本,同时验证是否安装成功
    rvm -v
    

采用RVM管理Ruby环境

  • Mac OS X系统自带Ruby环境

  • 修改RVMRuby安装源Ruby ChinaRuby镜像服务器,这样能提高安装速度

    echo "ruby_url=https://cache.ruby-china.org/pub/ruby" > ~/.rvm/user/db
    
  • Ruby的安装与切换相关命令

    // 获取所有可用于安装的 Ruby 版本
    rvm list known
    // 查询所有【已安装】的Ruby版本
    rvm list
    
    // 安装指定Ruby版本
    rvm install 2.4.0 --disable-binary
    // 切换Ruby版本
    rvm use 2.4.0
    // 设置默认Ruby版本
    rvm use 2.4.0 --default
    // 卸载已安装的Ruby版本
    rvm remove 2.4.0
    
    // 查看当前默认的Ruby版本
    ruby -v
    
  • 参考文档:RVM安装 及 Ruby的安装与切换

安装RubyGems

  • 如果gem版本过低也可能导致CocoaPods安装失败,所以这里首先需要先检查gem版本,看是否需要升级

  • 查看gem版本

    # 下面两个命令都可以检查当前【已安装】的gem的版本  
    gem -v
    gem --version
    
  • 替换RubyGems镜像源

    • 查看当前镜像源
    gem sources -l
    
    // 替换镜像源为Ruby China
    gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
    
    • 方式二
    // 先删除原有镜像源
    gem sources --remove https://rubygems.org/
    // 添加Ruby China为镜像源
    gem sources -a https://gems.ruby-china.com/
    
  • 以下命令建议添加sudo,表示以管理员的身份操作,因为可能在安装软件包的过程中,需要操作文件,这些操作必须有管理员权限才能进行

  • 升级gem

    • macOS X EI Capitan之前
    sudo gem update --system
    
    • macOS X EI Capitan之后
    sudo gem update -n /usr/local/bin --system
    
  • 查找、安装及卸载gem包

    // 搜索软件包
    gem search 软件包关键字
    
    // 安装软件包
    sudo gem install 软件包名称
    
    // 安装上一个版本的软件包
    sudo gem install 软件包名称 --pre
    
    // 卸载安装包
    sudo gem uninstall 软件包名称
    

安装CocoaPods

  • macOS X EI Capitan之前
sudo gem install cocoapods
  • macOS X EI Capitan之后
sudo gem install -n /usr/local/bin cocoapods
  • 检查版本
pod --version
  • 至此CocoaPods的已经安装完毕,下面需要初始化CocoaPods,下载使用CocoaPods进行管理的应用程序对应的描述文件列表,大概有四百多兆;

初始化CocoaPods,【不使用】镜像源(不推荐)

  • 安装完CocoaPods后如果直接在终端输入pod setup,接着出现Setting up CocoaPods master repo,之后就是一个很漫长的等待...
  • 会将数据下载到~/.cocoapods/repo/master目录中,可以cd ~/.cocoapods到此目录,用du -sh *命令每隔一段时间查看已下载下来的文件大小
  • 初始化数据总共有几百兆,要是不使用镜像的话,一天也未必能下载下来,所以不要采取这种方式

初始化CocoaPods,【使用】镜像源

  • 说明:更换repo源只是加快了repo的下载速度,并不会加快第三方库源码的下载速度,下载第三方库源码还是要到指定的源码存放地址(podspec中有指定)去下载,两者是没有任何关系的;
  • 首先查看本地三方框架仓库(repo)源,如果没有,不要直接使用pod setup,为什么上面已经解释了
# list可以省略
pod repo [list]
  • CocoaPods 镜像使用帮助
    • 进入自己的工程,在自己工程的podFile第一行加上
    source 'https://mirrors.tuna.tsinghua.edu.cn/git/CocoaPods/Specs.git'
    
  • 之后再次更新CocoaPods仓库源使用下面的命令
pod repo update
  • 遇到的问题
    • 问题描述


      问题.png
    • 解决办法:关闭Xcode
// 在终端中执行下面的命令,按照提示一步一步做完
// 执行完毕后,再次尝试下载,我通过此办法解决我的问题
sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
  • 如果没有安装成功,可以尝试删除.cocoapods目录,然后重新安装cocoapods
sudo rm -rf ~/.cocoapods/

Cocoapods重要路径

  • ~/Library/Caches/CocoaPods
    • 使用到的第三方框架的缓存路径
    • 第三方框架索引文件所在路径
      • 如果发现框架信息本地已经缓存,但是就是无法搜索到框架, 可以删除这个索引文件, 重新生成
      • 如果文件不存在,只要通过pod search xxx命令搜索框架时就会自动生成
  • ~/.cocoapods/repos
    • 三方框架索引信息缓存路径,一般指masterrepo
    • 你新建的私有repo也会处于这个位置
  • /usr/local/bin
    • pod命令安装路径

下一篇讲解CocoaPods的使用

参考链接

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,198评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,663评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,985评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,673评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,994评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,399评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,717评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,407评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,112评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,371评论 2 241
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,891评论 1 256
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,255评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,881评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,010评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,764评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,412评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,299评论 2 260

推荐阅读更多精彩内容