CocoaPods基本配置

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/