目录
- CocoaPods安装过程
- CocoaPods的使用
- 删除cocoapods已导入项目的第三方库和移除项目中的cocoapods
- CocoaPods安装过程
检查 Ruby 环境
安装CocoaPods
需要ruby
环境,因此我们需要先安装ruby
环境。Mac
一般都已经装好了ruby
环境。如果有ruby
环境,请跳过第二步
查看当前ruby
版本$ ruby -v
(检查当前版本,当ruby
版本低于2.2.2
时,安装cocoapods
会报错)安装 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
- 检查更新ruby版本环境
建议gem ruby
包环境升级到2.6.x
以上
- 检查gem ruby版本号:
$ ruby -v
$ gem -v
Gem是管理Ruby库和程序的标准包,如果它的版本过低也可能导致安装失败,解决的办法是更新gem版本 - 更新gem ruby版本
$ gem update --system
- 检查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环境安装成功
安装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
查看是否安装成功并更新
查看是否成功
$ pod --version
更新Podspec索引文件,创建本地索引库,如果没有报错,就说明一切安装成功了;这个过程需要一些时间
$ pod setup
查看本地索引库:$ open ~/.cocoapods/repos
CocoaPods的使用
- 用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是不需要的
- 安装依赖库
$ pod install
(后续添加框架可直接pod update
)
- 删除cocoapods已导入项目的第三方库和移除项目中的cocoapods
- 删除项目中已经由cocoapods配置好的第三方
- 打开项目中的Podfile文件
- 删除选中的pod Snapkit的命令行
- 打开终端cd到当前项目的根目录下重新执行
$ pod install --verbose --no-repo-update
或者直接$ pod install
- 删除项目中的cocoapods
- 手动删除
- 删除本地文件(Podfile、Podfile.lock、Pods文件夹、xcworkspace文件)
- 打开项目,在Frameworks文件夹下,删除Pods.xcconfig和libPods.a
- 进入项目Build Phases,删除Copy Pods Resources、Embed Pods Frameworks和Check Pods Manifest.lock 三项
删除了CocoaPod管理的第三方代码,在工程里面引用的第三方代码都会报错,需要删除对应的代码
- 通过第三方插件删除
- 安装cocoapods-deintegrate命令:
$ sudo gem install cocoapods-deintegrate
- 然后到工程目录下面执行命令:
$ pod deintegrate
- 手动删除.xcworkspace,libPods.a,Podfile,Podfile.lock文件
- 如果想要重装的话保留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