CocoaPods安装及使用步骤

CocoaPods介绍

1. 开发iOS项目不可避免地要使用第三方框架，CocoaPods是一个负责管理iOS项目中第三方框架的工具。

2. CocoaPods可以帮助我们快速有效的安装和更新和删除第三方框架。

3. CocoaPods帮助我们把需要集成的第三方框架从Github安装到项目中。

CocoaPods安装步骤

1. 在安装CocoaPods前，首先需要安装Ruby环境，因为CocoaPods和Ruby一起才能正常工作。

   • Mac系统自带Ruby环境,但是可能不是最新版本,需要升级到最新版本
   • 下载最新的RubyGem版本,详见 https://rubygems.org/pages/download/
     • RubyGem是Ruby的包管理框架，也叫做gem，作用是可以在你的系统上简单地下载、安装和使用Ruby软件包
   • 以RubyGem的2.6.8版本为例 rubygems-2.6.8，需要提前下载

2. 使用终端进入到已下载的 rubygems-2.6.8 文件路径

   终端命令 : cd /Users/zhangjie/Desktop/rubygems-2.6.8
   

3. 安装最新的RubyGem (需要管理权限,终端命令前要加 sudo)

   • 需要输入开机密码

   终端命令 : sudo ruby setup.rb
   

4. 查看RubyGem是否是刚刚安装的最新版本

   终端命令 : gem -v
   

5. 查看当前Mac系统上Ruby的源

   终端命令 : gem source -l
   

   • 如果你们看到是 https://rubygems.org/ 或者其它的,需要先移除.然后使用新Ruby源替换.

   *** CURRENT SOURCES ***
   
   https://rubygems.org/
   

6. 移除默认的Ruby源

   终端命令 : gem sources --remove https://rubygems.org/
   

7. 添加新的 https://gems.ruby-china.org/ Ruby源替换默认的Ruby源

   • 替换默认的Ruby源的原因 : 安装 CocoaPods 时,国内有堵墙.

   终端命令 : gem sources --add https://gems.ruby-china.org/
   

   • 查看替换之后的Ruby源

     终端命令 : gem source -l
     

   • 正确的Ruby源

     *** CURRENT SOURCES ***
     
     https://gems.ruby-china.org/
     

8. 安装CocoaPods到客户端

   • 初次安装可能需要点儿时间,所以要保证网速和耐心等待

   终端命令 : sudo gem install -n /usr/local/bin cocoapods
   

9. 查看CocoaPods的版本信息

   • 能够得到版本信息,说明安装成功

   终端命令 : pod --version
   

10. 下载CocoaPods的信息

    • 超过25000个第三方框架的信息,初次安装需要很长的时间,所以要保证网速和耐心等待
    • CocoaPods将它的信息下载到 ~/.cocoapods 路径下

    终端命令 : pod setup
    

11. 下载CocoaPods的信息结束之后,搜索一个你们最熟悉的第三方框架.

    • 如果可以搜索出来,说明安装已经成功了!

    终端命令 : pod search AFNetworking
    

CocoaPods使用步骤

1. 进入到项目目录

   终端命令 : cd /Users/zhangjie/Desktop/CocoaPods集成第三方框架演练
   

2. 在项目中创建Podfile文件

   终端命令 : pod init
   

3. 搜索要集成的第三方框架

   终端命令 : pod search AFNetworking
   

   • 或者

   终端命令 : pod search SDWebImage
   

4. 在Podfile文件中,配置想要集成的第三方框架

   # 项目最低支持的iOS操作系统版本
   platform :ios, '9.0'
   
   # 项目名称
   target 'CocoaPods集成第三方框架演练' do
   
   # 要集成的框架
   pod 'AFNetworking'
   pod 'SDWebImage'
   
   # 结束
   end
   

5. 安装要集成的框架到项目

   终端命令 : pod install
   

6. 更新已经安装到项目中的第三方框架 (更新框架版本时使用)

   终端命令 : pod update
   

7. 删除框架

   • 删除已经集成的框架时,只需要把框架名使用#注释掉即可

   # 项目最低支持的iOS操作系统版本
   platform :ios, '9.0'
   
   # 项目名称
   target 'CocoaPods集成第三方框架演练' do
   
   # 要集成的框架
   pod 'AFNetworking'
   
   # 删除已经集成的框架
   # pod 'SDWebImage'
   
   # 结束
   end
   

   • 再次执行安装命令

   终端命令 : pod install
   

8. 注意点 : 项目名称中不要出现中文符号,项目路径不要太深

9. CocoaPods使用说明 (仅供参考)

   • https://guides.cocoapods.org/