前提告知:安裝CocoaPods需要Ruby環境,所以,首先要檢查Ruby環境的版本!
Mac OS X 系統自帶的 Ruby,但是如果不管理它,它是不會自動升級滴,所以,我們需要一個ruby版本及安裝工具管理它,那是什么呢?
Ruby的管家婆登場-----》RVM全稱Ruby Version Manager,是一個非常好用的Ruby版本以及安裝工具。就是用來安裝和控制Ruby版本的工具。
RVM也是需要我們自己安裝的,所以,別發廢話,開始安裝~~
第一步,首先要檢查Mac是否安裝了rvm(ruby version manager)。打開終端,輸入指令$ rvm -v,"$"不用輸入
(1)如果存在,則會出現下面的情況:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ rvm -v
rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
* 如果之前安裝過 RVM 想要更新 則
$ rvm get stable
* 如果失敗,可以嘗試前面加上 sudo權限
$ sudo rvm get stable
(2)如果不存在,則會出現下面的情況:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ rvm -v
-bash:rvm:command not found
step1 :安裝rvm
方法一:curl -L https://get.rvm.io | bash -s stable
方法二:curl -L get.rvm.io | bash -s stable
安裝成功標志:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ rvm -v rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io] liangxiaolongdeMacBook-Pro:~ liangxiaolong$ curl -L get.vim.io | bash -s stable % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- 0:01:15 --:--:-- 0curl: (7) Failed to connect to get.vim.io port 80: Operation timed out liangxiaolongdeMacBook-Pro:~ liangxiaolong$ rvm -v rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io] liangxiaolongdeMacBook-Pro:~ liangxiaolong$ curl -L https://get.rvm.io | bash -s stable % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 194 100 194 0 0 85 0 0:00:02 0:00:02 --:--:-- 85 100 24361 100 24361 0 0 5274 0 0:00:04 0:00:04 --:--:-- 13312 Downloading https://github.com/rvm/rvm/archive/1.29.3.tar.gz Downloading https://github.com/rvm/rvm/releases/download/1.29.3/1.29.3.tar.gz.asc Found PGP signature at: 'https://github.com/rvm/rvm/releases/download/1.29.3/1.29.3.tar.gz.asc', but no GPG software exists to validate it, skipping. Upgrading the RVM installation in /Users/liangxiaolong/.rvm/ RVM PATH line found in /Users/liangxiaolong/.mkshrc /Users/liangxiaolong/.profile /Users/liangxiaolong/.bashrc /Users/liangxiaolong/.zshrc. RVM sourcing line found in /Users/liangxiaolong/.profile /Users/liangxiaolong/.bash_profile /Users/liangxiaolong/.zlogin. Upgrade of RVM in /Users/liangxiaolong/.rvm/ is complete. Upgrade Notes: * WARNING: '~/.profile' file found. To load it into your shell, add the following line to '/Users/liangxiaolong/.bash_profile': source ~/.profile * No new notes to display.
Step 2: 載入RVM環境
source ~/.rvm/scripts/rvm
Step 3: 查看版本確認是否安裝成功 rvm -v
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ rvm -v
rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]
若出現該圖中的文字,那么說明已經安裝過了rvm
Step 4: 列出所有指定源里的ruby版本 rvm list known
rvm list known
結果顯示:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ rvm list known # MRI Rubies [ruby-]1.8.6[-p420] [ruby-]1.8.7[-head] # security released on head [ruby-]1.9.1[-p431] [ruby-]1.9.2[-p330] [ruby-]1.9.3[-p551] [ruby-]2.0.0[-p648] [ruby-]2.1[.10] [ruby-]2.2[.7] [ruby-]2.3[.4] [ruby-]2.4[.1] ruby-head
第二步,用rvm安裝ruby環境
注意,當ruby版本低於2.2.2時,安裝cocoapods會報錯,可通過指令 ruby -v檢查當前版本。如果版本低於2.2.2,啥也不要說快更新一下。
輸入指令:rvm install 2.4.1(如上圖中,最新版本就是2.4.0),然后根據提示按“enter”鍵。
安裝完成之后輸入指令rvm list查看ruby版本,看看是否安裝成功,如下圖
第三步,檢查更新RubyGems(Ruby1.9.1 以后的版本自帶RubyGems)
RubyGems是一個方便而強大的Ruby程序包管理器,Ruby的第三方插件是用gem方式來管理,非常容易發布和共享,一個簡單的命令就可以安裝上第三方的擴展庫。
建議RubyGems升級到2.6.x以上。
查看RubyGems的版本用指令:gem -v 得到結果如下內容:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ gem -v
2.6.14
更新RubyGems的版本指令:gem update --system
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ gem update --system
Latest version currently installed. Aborting.
注意:如果提示 while executing gem filePermissionError
證明沒有權限 需要加上sudo
$ sudo gem update —system
可以看到updating到了100% 但是沒有安裝成功
$ sudo gem update -n /usr/local/bin —system //安裝成功
第四步,檢查ruby源並移除
先是檢查ruby源,gem sources -l 結果如下:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ gem sources -l *** CURRENT SOURCES *** https://rubygems.org/
然后移除,gem sources --remove https://rubygems.org/ 移除結果:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
替換添加國內的鏡像源,之所以要添加國內的ruby-china源,是因為taobao源已經停止維護了,所以此處替換的是ruby-china源,且盡量確保只有一個。輸入指令gem sources --add https://gems.ruby-china.org 替換結果如下圖:
liangxiaolongdeMacBook-Pro:~ liangxiaolong$ gem source --add https://gems.ruby-china.org https://gems.ruby-china.org added to sources liangxiaolongdeMacBook-Pro:~ liangxiaolong$ gem sources -l *** CURRENT SOURCES *** https://gems.ruby-china.org
【1】ruby源已經是https://gems.ruby-china.org
【更新通知】
【2】ruby源已經是https://gems.ruby-china.com/
原因:
【更新通知】
【3】ruby源https://gems.ruby-china.com/已經停止更新(鏡像404了,不提供服務。)
解決:
gem sources -a https://rubygems.org/
添加源來的ruby鏡像,感覺速度不慢了。畢竟ruby-china也關了。
關於RubyGems近況及詳情: 傳送門
第五步,安裝CocoaPods(sudo 表示管理員執行指令,需要輸入密碼的)
安裝cocoapods,$ sudo gem install cocoapods
注意:
OS X 10.11之前系統的安裝cocoapods 指令:$ sudo gem install cocoapods
OS X 10.11以后系統的安裝cocoapods 指令:$ sudo gem install -n /usr/local/bin cocoa pods
如果有 gems installed標志着安裝成功了。
到這里,cocoapods已經安裝成功了!恭喜恭喜!!!
第六步,cocoapods集成第三方框架到項目工程里面去
step 1:先去xcode中創建一個項目
step 2:打開終端,輸入 cd 項目路徑
注意:cd指令的意思是進入某個文件夾中 項目路徑可以通過拖拽方式,拖拽到終端
step 3:進入了項目路徑后,輸入指令vim podfile創建podfile文件,然后按i進入到編輯模式,出現如下圖:
在如上圖中,輸入
platform:ios,'8.0' target '你的工程名' do pod 'AFNetworking', '~>3.1.0' (如果不加 , '~>3.1.0' 則它會下載最新的版本) end
配置好要集成的第三方庫,按鍵盤的esc,接着按 :然后輸入wq 按回車鍵
最后輸入指令
pod update --verbose --no-repo-update
或者
pod install --verbose --no-repo-update
到這步,沒出錯,說明你項目中已經集成成功第三方框架,打開如下圖紅框里面工作空間
如何刪除項目中已經由cocoapods配置好的第三方
第一部分將介紹如何刪除項目中已經由cocoapods配置好的第三方
1.打開項目中的Podfile文件

3.打開終端cd到當前項目的根目錄下重新執行pod install --verbose --no-repo-update命令
當命令運行完后項目中的Snapkit第三方就已經被移除
第二部分:刪除cocoapods
某種特殊情況下我們甚至都不想使用cocoapods了,這時我們想要將cocoapods徹底的從項目中移除,不留一點痕跡,略微有點麻煩,
1.刪除工程文件夾下的Podfile、Podfile.lock和Pods文件夾,xcworkspace文件。

2.打開xcodeproj文件,刪除項目中的Pods文件夾及Framework文件夾(此時這兩個文件夾中的文件已經報紅,說明此時這些文件已經不存在)

3.刪除配置文件: 打開Build Phases選項,刪除Check Pods Manifest.lock和Copy Pods Resources,以及Embeded Pods Frameworks

4.刪除項目中引用的頭文件及相關的代碼
-pod安裝
# 添加源 $ sudo gem sources -a https://ruby.taobao.org/ # 刪除源 $ sudo gem sources -r https://rubygems.org/ # 安裝 $ sudo gem install cocoapods # 設置 $ pod setup
RubyGems相關命令
gem相關命令使用 1.顯示gem的幫助和版本 gem –h/--help #顯示gem的幫助 gem –v /--version #顯示gem的版本號 2. 列出遠程庫的所有可用軟件 gem query --remote # 短命令: gem q -r 你可以看到一個關於遠程主機上所有軟件的詳細列表。 3. 查找遠程主機上的特定軟件 gem query --remote --name-matches doom # 短命令: gem q -rn doom
你將看到一個匹配doom的詳細列表。 gem list –remote --d #用子命令list列出遠程安裝的gems 4.1 安裝一個遠程軟件 gem install --remote progressbar # 短命令: gem i -r progressbar –y 遠程安裝progressbar到你的主機,-y的意思是無條件的安裝依賴包 gem install rails –remote #從遠程服務器安裝rails包,其中rails可以被替換成任何一個gem list –remote –d中顯示的軟件包 4.2 安裝軟件的特定版本 gem ins -r progressbar-0.0.3 安裝progressbar的0.0.3版本 gem ins -r progressbar --version '> 0.0.1' 將安裝progressbar的大於0.0.1的最新版本
5. 查看一個已安裝的軟件 gem specification progressbar # 短命令: gem spec progressbar 你會看到關於已安裝的包progressbar的詳細信息。 6. 卸載一個軟件 gem uninstall progressbar 卸載了progressbar 7.1 將所有安裝的軟件列表 gem query --local # 短命令: 'gem q -l' 7.2 查看某個已安裝的軟件 gem query --local --name-matches doom # 短命令: 'gem q -ln doom' 或:gem list --local
CocoaPods相關命令
# 第一次使用安裝框架 //只用安裝一次,之后使用 添加刪除都用 pod update --no-repo-update $ pod install # 安裝框架,不更新本地索引,速度快 $ pod install --no-repo-update # 今后升級、添加、刪除框架,或者框架不好用 $ pod update # 更新框架,不更新本地索引,速度快 $ pod update --no-repo-update # 搜索框架 $ pod search XXX 幫助 $ pod --help