CocoaPods安装与使用步骤详解

目录

  • CocoaPods安装过程
  • CocoaPods的使用
  • 删除cocoapods已导入项目的第三方库和移除项目中的cocoapods
  • CocoaPods安装过程
  1. 检查 Ruby 环境
    安装CocoaPods需要ruby环境,因此我们需要先安装ruby环境。Mac一般都已经装好了ruby环境。如果有ruby环境,请跳过第二步
    查看当前ruby版本$ ruby -v(检查当前版本,当ruby版本低于2.2.2时,安装cocoapods会报错)

  2. 安装 Ruby 环境
    使用Homebrew安装CocoaPods(无需翻墙)

2.1. 安装Homebrew

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

出现Installation successful!提示安装成功!

2.2. 接着安装ruby
$ brew install ruby

  1. 检查更新ruby版本环境
    建议gem ruby包环境升级到2.6.x以上
  • 检查gem ruby版本号:$ ruby -v $ gem -v
    Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决的办法是更新gem版本
  • 更新gem ruby版本$ gem update --system
  1. 检查ruby源并移除
  • 检查ruby源$ gem sources -l
    因为Ruby环境默认的的软件源rubygems.org被屏蔽了,国内那面永远需要翻越的墙,我们需要来修改更换源,把源切换至ruby-china
  • 移除掉原有的源$ gem sources --remove https://rubygems.org/
  • 添加国内最新的源$ gem sources -a https://gems.ruby-china.com
  • 检查是否添加成功$ gem sources -l
    到这里就已经把Ruby环境安装成功
  1. 安装CocoaPods
    $ gem install -n /usr/local/bin cocoapods
    也可以强制执行 $ sudo gem install -n /usr/local/bin cocoapods
    也可以安装指定的CocoaPods版本
    sudo gem install -n /usr/local/bin cocoapods --version 1.5.3

  2. 查看是否安装成功并更新

  • 查看是否成功$ pod --version

  • 更新Podspec索引文件,创建本地索引库,如果没有报错,就说明一切安装成功了;这个过程需要一些时间$ pod setup
    查看本地索引库:$ open ~/.cocoapods/repos

  • CocoaPods的使用

  1. 用Xcode创建一个工程,并创建podfile配置文件
  • 进入项目目录$ cd ~
  • 创建Podfile文件$ touch Podfile
  • 打开编辑,使用$ vi Podfile输入i进入编辑,编辑完成后按 esc 然后输入:wq按回车键 ,保存并退出
  • 编辑Podfile文件
    我们可以在Podfile文件中写入需要用到的第三方库按如下格式:
platform :ios, '9.0'
use_frameworks!
target 'TestDemo' do
pod 'Alamofire', '~> 4.0.1'
pod 'Kingfisher', '~> 3.1.1'
end

Swift的pod文件在于use_frameworks! 这一句是必须的,作用是把三方库打包成静态库,而oc是不需要的

  1. 安装依赖库
    $ pod install (后续添加框架可直接pod update)
  • 删除cocoapods已导入项目的第三方库和移除项目中的cocoapods
  1. 删除项目中已经由cocoapods配置好的第三方
  • 打开项目中的Podfile文件
  • 删除选中的pod Snapkit的命令行
  • 打开终端cd到当前项目的根目录下重新执行$ pod install --verbose --no-repo-update或者直接$ pod install
  1. 删除项目中的cocoapods
  • 手动删除
  1. 删除本地文件(Podfile、Podfile.lock、Pods文件夹、xcworkspace文件)
  2. 打开项目,在Frameworks文件夹下,删除Pods.xcconfig和libPods.a
  3. 进入项目Build Phases,删除Copy Pods Resources、Embed Pods Frameworks和Check Pods Manifest.lock 三项
  4. 删除了CocoaPod管理的第三方代码,在工程里面引用的第三方代码都会报错,需要删除对应的代码


  • 通过第三方插件删除
  1. 安装cocoapods-deintegrate命令:$ sudo gem install cocoapods-deintegrate
  2. 然后到工程目录下面执行命令:$ pod deintegrate
  3. 手动删除.xcworkspace,libPods.a,Podfile,Podfile.lock文件
  4. 如果想要重装的话保留Podfile,再执行命令:$ pod install就好了
  • 利用cocopods导入第三方库的时候,出现如下错误:
[!] Unable to add a source with url `https://github.com/CocoaPods/Specs.git` named `master`.
You can try adding it manually in `~/.cocoapods/repos` or via `pod repo add`.

解决方案:
pod repo add master https://github.com/CocoaPods/Specs.git
这一步时间也比较久,然后执行pod setup,如果出现
[!] The 'master' repo is not a git repo.
进入/users/你的用户名/.cocoapods/repos,删除master文件夹
然后执行pod setup

参考:最新CocoaPods安装与使用步骤详解
RubyGems 镜像
附:我的博客地址

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容